---
title: "Search company followers"
method: POST
path: "/company-followers/search"
tags: ["company-followers"]
---

# Search company followers

`POST /company-followers/search`

## Request

- Base URL: `https://api.leadsforge.ai`
- URL: `https://api.leadsforge.ai/company-followers/search`
- Auth: `ApiKeyAuth` (a scheme the document does not define)

Starts an async company followers search for a LinkedIn company page, limit is required and capped at 50000, supports idempotency via Idempotency-Key header (if a job with the same key already exists for this account the existing job is returned), supports webhook notifications via webhookURL field (POST with JSON body on completion/failure, 2xx = success; a failed delivery is retried immediately and then redelivered in the background for up to 24h, every attempt carrying the same X-Webhook-Delivery-Id header so repeated deliveries can be deduplicated), webhook payload: jobID (string), status (completed|failed), linkedinUrl (string), companyName (string), followerCount (int), total (int), processed (int), error (string, failure only). The webhook omits companyLogoUrl to avoid sending a raw upstream image URL; fetch it from GET /company-followers/jobs/{jobID}.

## Headers

- `Idempotency-Key` string

## Request body

- StartCompanyFollowersSearchRequest
  - `clientRequestID` string
  - `countries` string[]
  - `departments` string[]
  - `jobTitles` string[]
  - `levels` string[]
  - `limit` integer, required
  - `linkedinUrl` string, required
  - `metros` string[]
  - `states` string[]
  - `webhookURL` string

## Response `202`

Job created

- CompanyFollowersJobResponse
  - `clientRequestID` string
  - `companyLogoUrl` string
  - `companyName` string
  - `completedAt` string
  - `consumedCredits` number
  - `createdAt` string
  - `error` string
  - `followerCount` integer
  - `jobID` string
  - `linkedinUrl` string
  - `processed` integer
  - `reservedCredits` number
  - `resultsURL` string
  - `status` 'in_progress' | 'completed' | 'failed' | 'no_results'
  - `statusURL` string
  - `total` integer
  - `updatedAt` string
  - `webhookURL` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Insufficient credits
- `429`: Too Many Requests
- `500`: Internal Server Error
- `502`: Bad Gateway

---

[API](https://skmtc.dev/leadsforge/apis/leadsforge-api.md) - [All operations](https://skmtc.dev/leadsforge/apis/leadsforge-api/llms.txt) - [OpenAPI document](https://skmtc.dev/leadsforge/apis/leadsforge-api/revisions/b4a6596215b5?raw)