Authentication
Every request carries your API key in a header:The job pattern
All sources follow the same flow:- Create a job —
POST /api/jobswithsource,operation,country, and yourqueries. The response contains a job ID. - Poll the job —
GET /api/jobs/{jobId}until its status iscompletedorfailed. - Read the results — inside the job as JSON, or as an export via
GET /api/jobs/{jobId}/csv.
queries at once; results appear progressively as individual lookups finish. Fetch your results within about an hour of completion.
Sources and operations
We connect additional marketplaces on request — reach out about an enterprise connection.