Skip to main content
POST
Prospects Research Job

Description

The asynchronous variant of Prospects Research. It submits a custom, AI-powered research task over a dataset of prospects as a job, rather than returning results in the response.
  • Input: Provide prospect IDs plus either a natural-language query or a prompt_template and a caller-defined output_schema.
  • Processing: The job runs through the async job infrastructure, optionally grounded in real-time web data.
  • Output: A job reference; poll job status for progress and results.
  • Use the async variant for long lists — sync is capped per request, async allows up to 10,000 records.
  • Keep output_schema tight so results stay consistent and cheap to parse.
  • Poll rather than re-submit — resubmitting duplicates credit usage.
Jobs run for a maximum of 24 hours. See Research (GenAI) for the full overview.

Authorizations

api_key
string
header
required

Body

application/json
list_id
string
required

Entity ID list identifier returned by the upload endpoint

parameters
GenAIResearchParams · object
required

Response

Successful Response

job_id
string
required
status
string
required
status_url
string
required