Skip to main content
POST
Ask Site
Prepare the polygon through Sites, then submit your account-owned site_id and question. A ready dossier supports a cited answer without repeating the complete preparation. The evidence is a snapshot from built_at, not a live re-screen.
The price is $0.10 per completed answer on every plan. Send a stable Idempotency-Key to retry the same operation safely. Responses include the dollar billing receipt. An incomplete or failed answer costs zero; a still-building site returns 202 without charging. Unknown, expired or another account’s site cannot be read. Accept current terms and keep the required source permissions. An error with operation_status: "failed" and retryable: false confirms a terminal operation. That key cannot restart work. To try again, explicitly submit a new request with a new idempotency key; a successful new request is billed at the normal price. For interrupted delivery or an unknown outcome, keep the original key and recover that operation before considering a replacement. The answer includes citations and source evidence; inspect uncertainty and data gaps before applying a site-wide conclusion. Free site preparation and status reads do not return the premium dossier. See Pricing for balances, reservation, result recovery and retention. A completed answer is recoverable for 30 days after that answer completes, even if its prepared dossier expires or is rebuilding. Retry the same request and idempotency key to collect the saved answer without another charge. Current account ownership, terms and licensed-data permissions still apply; source withdrawal can block delivery. A new question or new key requires a ready dossier.

Headers

Idempotency-Key
string | null

Body

application/json
site_id
string
required
Required string length: 4 - 64
question
string
required
Required string length: 1 - 2000
max_cost_usd
string | null
Pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]{1,6})?$

Response

Successful Response