Answers

Answer a research task

Research the web and return a sourced answer in your JSON shape. Choose fast for a short task or ultra for deeper research.

post/web/answers

Request

mode'fast' | 'ultra'

fast prioritizes speed, with extra verification for people and companies; ultra supports deeper research (default).

taskstring required

Research task. The agent selects company/profile lookups, web searches, or page reads. Include domains or URLs to focus the research.

json_formatobject

Example answer object, not JSON Schema. Up to 8 levels, 500 values, and 16000 characters; unknowns may be null.

tagsstring[]

Labels for filtering usage in the dashboard.

zdr'enabled' | 'disabled'

enabled turns on zero data retention. Returns 403 ZDR_NOT_ENABLED unless your organization has ZDR.

{
  "tags": [
    "production",
    "team-alpha"
  ]
}

The requested JSON shape, plus the sources used

partialboolean

True when the request deadline ended research and the answer uses the evidence collected so far.

json_contentobject required

The answer, in the shape requested by json_format.

sourcesstring[] required

URLs of the pages and company/profile records read for the answer, followed by URLs cited in json_content.

request_idstring uuid required

Unique ID of this request, also in X-Request-Id. Include it when contacting support.

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91"
}