Skip to main content
POST
Search company followers

Authorizations

Authorization
string
header
required

Your API key, sent as is (no Bearer prefix). Create it in the Leadsforge app under Settings -> API & MCP.

Headers

Idempotency-Key
string

Idempotency key - if a job with this key already exists in your account, the existing job is returned as is, whatever the body as long as it is valid. Use a new key to start a new job

Body

application/json

Search request

Search request

limit
integer
required
Required range: 1 <= x <= 50000
Example:

500

linkedinUrl
string
required
Example:

"https://www.linkedin.com/company/salesforgeai"

clientRequestID
string
Maximum string length: 128
Example:

"req_12345"

countries
string[]
Example:
departments
string[]
Example:
jobTitles
string[]
Example:
levels
string[]
Example:
metros
string[]
Example:
states
string[]
Example:
webhookURL
string
Example:

"https://example.com/webhooks/followers"

Response

Job created

clientRequestID
string
Example:

"req_12345"

companyLogoUrl
string
Example:

"https://api.leadsforge.ai/images/AbC123xYz"

companyName
string
Example:

"Salesforge"

completedAt
string
consumedCredits
number
createdAt
string
Example:

"2026-03-18T12:00:00Z"

error
string
followerCount
integer

FollowerCount is the follower count of the company page when the job started.

Example:

12345

jobID
string
Example:

"7c2e4a1b-9d3f-4e6a-8b5c-0f1e2d3c4b5a"

linkedinUrl
string
Example:

"https://www.linkedin.com/company/salesforgeai"

processed
integer

Processed is the number of followers collected so far. It is live on GET /company-followers/jobs/{jobID}; in GET /company-followers/jobs it stays 0 until the job ends.

Example:

120

reservedCredits
number
resultsURL
string
Example:

"/public/v1/company-followers/jobs/7c2e4a1b-9d3f-4e6a-8b5c-0f1e2d3c4b5a/results"

status
enum<string>
Available options:
in_progress,
completed,
failed,
no_results
Example:

"in_progress"

statusURL
string
Example:

"/public/v1/company-followers/jobs/7c2e4a1b-9d3f-4e6a-8b5c-0f1e2d3c4b5a"

total
integer

Total is the number of followers the job aims to collect: the smaller of limit and followerCount.

Example:

500

updatedAt
string
Example:

"2026-03-18T12:01:00Z"

webhookURL
string
Example:

"https://example.com/webhooks/followers"