Skip to main content
People who follow a company’s LinkedIn page are often interested in its market. This guide finds those followers and turns them into contacts.
  • Service: Leadsforge API
  • Base URL: https://api.leadsforge.ai/public/v1
  • Cost: your followers price for each follower collected; enrichment is charged separately per value found. See Credits.
All examples send your API key in the Authorization header and read it from $LEADSFORGE_API_KEY.
1

Pick the filters

You can narrow followers with six body fields: countries, states, metros, jobTitles, departments and levels (seniority). Each takes values from its own free endpoint: GET /company-followers/filters/countries, /states, /metros, /job-titles, /departments and /levels. Job titles are searched and paged; the other lists come back whole.
2

Start the job

Send the company page URL and how many followers you want, up to 50000. The job can collect fewer followers than you asked for, since not every follower of a page can always be reached.
The response is 202 Accepted with the job. It reserves your followers price for the smaller of limit and the page’s follower count, and charges only for the followers collected.
3

Wait for the job

Poll GET /company-followers/jobs/{jobID} until the status is completed, failed or no_results, or pass a webhookURL to get one notification when the job ends (deduplicate redeliveries by X-Webhook-Delivery-Id).
4

Read the followers

Page through the followers, up to 500 per page.
Each follower has a name and a LinkedIn profile URL, and a title, location and company when known. Use personID as a stable key when present: profileUrl can change later.
5

Enrich the followers

Followers that have a personID can be sent to enrichment as personIDs. For the rest, use a separate job and send people with each follower’s profileUrl as linkedinURL together with its firstName, lastName and, when present, companyName as company, since a LinkedIn URL alone that we cannot match comes back not_found. One job takes either personIDs or people, not both. See Find emails for search results.