Skip to main content
Start from companies you already know work well, such as your best customers, and find more companies like them. Then find the right people at those companies and enrich them.
  • 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.
All examples send your API key in the 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 page (from 1) and pageSize (1 to 100). It reserves your lookalike price for a full page and charges only for the companies returned.
The 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 POST /search in companyDomains.include, together with the people filters you need.
Seniority and department values come from 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.