- Service: Leadsforge API
- Base URL:
https://api.leadsforge.ai/public/v1 - Cost: the preview and the people search are free up to a monthly allowance, then each request costs credits; the lookalike search charges your lookalike price for each company returned; enrichment is charged per value found. See Credits.
Authorization header and read it from $LEADSFORGE_API_KEY.
1
Preview lookalikes
Send 1 to 10 company domains, without scheme or path. The preview returns company metadata only and is free up to a monthly allowance, so use it to tune your filters before a paid search.Filter values come from free endpoints:
GET /lookalikes/filters/employee-ranges, GET /lookalikes/filters/locations and GET /lookalikes/filters/funding-stages.2
Search lookalikes page by page
The search uses the same filters plus The
page (from 1) and pageSize (1 to 100). It reserves your lookalike price for a full page and charges only for the companies returned.Idempotency-Key is remembered for 10 minutes: a retry with the same key returns the same page without charging again. Use a new key for each page.3
Find people at those companies
Pass the returned domains to Seniority and department values come from
POST /search in companyDomains.include, together with the people filters you need.GET /search/filters/seniorities and GET /search/filters/departments. maxContactsPerCompany keeps a few people per company instead of everyone.4
Enrich the people
Send the person IDs from the search (each lead’s
id) to an enrichment job, exactly as in Find emails for search results.