Check a business's website
check_businessIdempotent
Checks what an AI agent can do with a business's website: message, book, order, sign up, pay, change or cancel. Waits up to 25 seconds; if the read isn't finished, returns what it found so far, and you call it again for the score. A result read in the last hour is answered as it is; after a business changes its site, set fresh to true to read it again (allowed a few minutes after the last read). Use it when a person asks how agent-ready a business is, or wants to improve their own. To find businesses, use search_businesses instead.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The business's website, as a URL or a bare domain like salon.example. | |
| fresh | No | Read the site again rather than answer the stored result: for a business that just changed its site. Allowed a few minutes after the last read; before that, the stored result is answered with when to ask again. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Its result page. | |
| rank | No | Only when done, not hidden and of a kind the directory ranks. | |
| site | No | The business's own site. | |
| badge | No | ||
| fixes | No | ||
| grade | No | ||
| level | No | ||
| owner | No | ||
| queue | No | Only while queued, checking or scoring. | |
| rules | No | The score rules applied (GET /v1/score-rules?version=N). | |
| state | Yes | ||
| domain | Yes | ||
| answers | No | Message, book, order, sign up, cancel and negotiate, in that order. | |
| profile | No | ||
| excluded | No | ||
| indexable | Yes | ||
| scored_at | No | ||
| checked_at | No | ||
| capabilities | No | ||
| track_record | No | A member's track record, from the same nightly count as its standing and shown under the same rules: the promises it kept and broke, and when. From rules version 8, one that rests on the business's own word is self_reported: its counts, with no score and no count of customers. Only what its state can say is present; a business that is not a member has none. | |
| agentic_score | No | ||
| not_certification | No | ||
| web_person_message | No |