> ## Documentation Index
> Fetch the complete documentation index at: https://developer.salesforge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Find the followers of a company page

> Find the people who follow a LinkedIn company page with a Leadsforge API job, then enrich them.

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](https://developer.salesforge.ai/leadsforge-api/concepts/credits.md).

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.

```bash theme={null}
curl -sS https://api.leadsforge.ai/public/v1/company-followers/search \
  -H "Authorization: $LEADSFORGE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3f2b8c1e-7a4d-4e9b-9c6f-2d1e0a5b7c84" \
  -d '{
    "linkedinUrl": "https://www.linkedin.com/company/salesforgeai",
    "limit": 500,
    "countries": ["United States"],
    "departments": ["Engineering"]
  }'
```

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.

```json theme={null}
{
  "jobID": "7c2e4a1b-9d3f-4e6a-8b5c-0f1e2d3c4b5a",
  "status": "in_progress",
  "linkedinUrl": "https://www.linkedin.com/company/salesforgeai",
  "companyName": "Salesforge",
  "followerCount": 12345,
  "total": 500,
  "processed": 0,
  "reservedCredits": 500,
  "consumedCredits": 0,
  "createdAt": "2026-10-21T09:00:00Z",
  "updatedAt": "2026-10-21T09:00:00Z",
  "statusURL": "/public/v1/company-followers/jobs/7c2e4a1b-9d3f-4e6a-8b5c-0f1e2d3c4b5a",
  "resultsURL": "/public/v1/company-followers/jobs/7c2e4a1b-9d3f-4e6a-8b5c-0f1e2d3c4b5a/results"
}
```

**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.

```bash theme={null}
curl -sS "https://api.leadsforge.ai/public/v1/company-followers/jobs/7c2e4a1b-9d3f-4e6a-8b5c-0f1e2d3c4b5a/results?limit=500&offset=0" \
  -H "Authorization: $LEADSFORGE_API_KEY"
```

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](https://developer.salesforge.ai/products/leadsforge/find-emails-for-search-results.md).

## Related resources

* [Asynchronous jobs](https://developer.salesforge.ai/leadsforge-api/concepts/async-jobs.md)
* [Credits](https://developer.salesforge.ai/leadsforge-api/concepts/credits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.