Jobs
Wait for discoveries and analyses to finish.
Paid work runs in the background. discover_creators, analyze_creators and run_analysis return a job_id, which is an opaque handle such as discovery:…, snapshot:…/… or pipeline:instagram:…. Pass it unchanged to these tools. A job's status is running, completed or failed, and stage shows queued, scraping or analyzing. See Jobs and polling.
wait_for_job
wait_for_jobread-onlyBlock until the job finishes or timeout (max 25s), then return its status. If still running, call again — discoveries take a few minutes, analyses several minutes, longer when queued.
| Parameter | Type | Default | Limits |
|---|---|---|---|
job_idrequired | string | | ≤ 250 chars |
timeout_seconds | integer | 25 | 1–45 |
get_job
get_jobread-onlyStatus of a job_id from discover_creators / analyze_creators / run_analysis: running | completed | failed (failed paid work is refunded).
| Parameter | Type | Default | Limits |
|---|---|---|---|
job_idrequired | string | | ≤ 250 chars |