API docs: https://api.leadsforge.ai/public/swagger/index.html
We’ve opened up Leadsforge with a public API, giving you programmatic access to sourcing and enrichment!
What’s Included:
Sourcing: ICP filters with pagination; output matches CSV download (Locations split into City & Country).
Enrichment:
Single & bulk enrichment (max 500 per batch; rest queued).
Covers email, LinkedIn, and phone.
LI URL only returned if enriched.
Credits: Same system as in-app. Credits reserved upfront; charged only for successful results.
API Key: At account level, covering credits for the whole account.
Limits: Low initial rate limits to prevent abuse; will scale up as we monitor performance.
This makes it easier to integrate Leadsforge directly into your workflows!
POST /public/v1/search – 20 requests per minute per account (i.e. per accountID), not per API key.
GET /public/v1/balance – 60 requests per minute per API key.
GET /public/v1/enrichment/jobs/{jobID} – 60 requests per minute per API key.
GET /public/v1/enrichment/jobs/{jobID}/results – 60 requests per minute per API key.
POST /public/v1/enrichment/{emails|phones|linkedin} –no rate limit, but there is a cap on the number of active jobs per account. If this limit is exceeded, the API returns 429 "active enrichment jobs limit reached".
The job accepts no more than 500 personIDs. The validator will return 400 if more are sent. There is no automatic division of “the rest into a queue” — you need to send several requests for less than 500. When the rate limit is triggered, the X-RateLimit-Limit/Remaining/Reset and Retry-After headers are given.
