Base URL
Authentication
Create an API key in the Leadsforge app under Settings -> API & MCP, and send it as is in theAuthorization header of every request, without a Bearer prefix.
Request conventions
- JSON bodies. Send request bodies as JSON with
Content-Type: application/json. A body field the endpoint does not know is rejected with400, so a misspelled filter fails instead of being ignored. - Paging. Search pages with a cursor. Lookalike company search pages with
pageandpageSize. Job lists and job results page withoffsetandlimit. - Jobs. Long-running operations return
202 Acceptedwith a job you follow until it ends. See Asynchronous jobs. - Retries. Job start requests and lookalike search accept an
Idempotency-Keyheader, so a retried request does not start or charge twice. - Errors. Failed requests return a JSON body with a stable
code, except the few cases listed in Errors.
Endpoint groups
The reference states for each endpoint whether it is free or paid, whether it is synchronous or a job, and what input it requires.
