QA Agent is in beta. The request and response format can change.
For people and company research, see People Intelligence and Company Intelligence. This page covers the legacy QA Agent.
notes plus the fields you define in struct, such as a score or a YES/NO verdict. Use it for lead qualification, marketplace vetting, and CRM hygiene.
Endpoint
API Reference
See the full request/response schema and parameters in the API Reference.
Request
qualification_criteria
The agent reads every criterion, including its weight and threshold, as guidance for its research and assessment. QA Agent does not compute a score itself: to get one, ask for it in
struct and state the scale you want (for example "Weighted qualification score from 0 to 10").
references
Each reference is an object with a required url and an optional description of what the page shows.
struct
Each key in struct becomes a field in structured_data, and its value is a plain-English description of what to put there. Only the fields you list are returned. Specific descriptions work best: "Overall qualification score from 0 to 10, weighted by criterion" beats "score".
struct values must be strings; typed objects such as {"type": "int"} are rejected. Every returned value is a string, and an unfilled field is an empty string.
Without a struct, structured_data contains a single general_findings field.
Response
Response (excerpt)
Sync usage
Async pattern
Use/qa-agent-async for batches and anything that runs inside a request timeout.
- Submit:
POST /qa-agent-asyncwith the same body as the sync endpoint. The response is{"task_id": "...", "status": "RUNNING"}. - Poll:
GET /job-status/{task_id}every 10 seconds untilstatusis no longerrunning. - Read: when
completed, the response’sresultholds the same object the sync endpoint returns.
webhook_url to receive the result instead of polling. Async Jobs covers statuses, the polling budget and retries.