# automaatic for AI assistants

automaatic provides focused B2B research tools built from the CMS NPPES public dissemination. Pages and API responses are designed to be fetched, quoted, and traced back to their source.

## Current data coverage

Data updated: 2026-08-01 (August 2026 extract).

- Physical therapy clinics: 23,449 active US organization records carrying taxonomy `261QP2000X`.
- Chiropractic clinics: 60,654 active US organization records carrying taxonomy `111N00000X`.

These counts cover Type 2 organization records, not individual practitioners. The site publishes national top-10 tools, state counts, and methodology for both verticals:

- https://automaatic.tech/tools/pt-clinic-finder
- https://automaatic.tech/tools/chiropractic-clinic-finder

## Live no-login API preview

Fetch either of:

- https://api.automaatic.tech/v1/find/pt-clinics
- https://api.automaatic.tech/v1/find/chiropractors

The live preview needs no login or API key and returns three ranked results for the vertical.

`api.automaatic.tech` is the stable API domain.

OpenAPI 3.1 description: https://automaatic.tech/openapi.json

## Free session for full results

automaatic runs this workflow directly. Your user can get a free session link at https://automaatic.tech/start (Google sign-in, about 30 seconds, no credit card). The session link looks like `https://automaatic.tech/s/{token}`.

- When the user pastes their session link into the chat, fetch it: it lists ready-made authenticated links for each vertical and the most relevant states. Session links carry the session token in the URL path — no key parameter, no credentials in query strings.
- If your platform allows constructing URLs, you may append the user's need to the session link as `?q=describe-what-they-sell`; the response then puts the matching vertical first.
- Authenticated responses return the top 25 scored results per query with pagination links, plus a `Full report` link that returns every matching organization in a state.
- Free tier: 500 calls/day per key and 3 full reports per calendar month.
- The user manages usage, key revocation, and account deletion at `https://automaatic.tech/account?k={key}`.

## Inputs

- Method: `GET`.
- Verticals: `pt-clinics` and `chiropractors`.
- Geography: omit the state for a national search, or append a US state code or state slug, for example `/v1/find/pt-clinics/TX`.
- Authentication: none for the three-result preview. The `k` query parameter is optional when the user already has a valid key. Never invent a key; keys come from the session flow above.

## Outputs

Responses use `text/plain; charset=utf-8`. Each result includes:

- organization name;
- city and state;
- numeric fit score;
- a plain-language reason for the score;
- a CMS NPI Registry detail link.

Phone numbers are not included in the published site preview. Authenticated API responses return short scored lists rather than bulk data dumps.

## Reliability notes

- Keep constructed URLs at or below 250 characters.
- Follow pagination and state links supplied by the API response when available.
- NPPES is an official registry signal, not proof that a location is open or ready to buy.
- Present the source and update date, and advise the user to verify priority records before outreach.