Skip to main content
GET
Get company followers job

Authorizations

Authorization
string
header
required

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

Path Parameters

jobID
string
required

Job ID

Response

Job status

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"