company-followers

Search company followers

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

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)

Headers

Idempotency-Keystring

Idempotency key - if a job with this key already exists for this account, the existing job is returned as-is, use a new key to start a new search

Request body

clientRequestIDstring
countriesstring[]
departmentsstring[]
jobTitlesstring[]
levelsstring[]
limitinteger required
linkedinUrlstring required
metrosstring[]
statesstring[]
webhookURLstring

Example request

{
  "clientRequestID": "req_12345",
  "countries": [
    "United States",
    "Germany"
  ],
  "departments": [
    "Engineering",
    "Marketing"
  ],
  "jobTitles": [
    "Software Engineer",
    "Product Manager"
  ],
  "levels": [
    "Senior",
    "Director"
  ],
  "limit": 500,
  "linkedinUrl": "https://www.linkedin.com/company/salesforgeai",
  "metros": [
    "San Francisco Bay Area",
    "London Area",
    " United Kingdom"
  ],
  "states": [
    "California",
    "Bavaria"
  ],
  "webhookURL": "https://example.com/webhooks/followers"
}

Response

Job created

clientRequestIDstring
companyLogoUrlstring
companyNamestring
completedAtstring
consumedCreditsnumber
createdAtstring
errorstring
followerCountinteger
jobIDstring
linkedinUrlstring
processedinteger
reservedCreditsnumber
resultsURLstring
status'in_progress' | 'completed' | 'failed' | 'no_results'
statusURLstring
totalinteger
updatedAtstring
webhookURLstring

Example response

{
  "clientRequestID": "req_12345",
  "companyLogoUrl": "https://media.licdn.com/dms/image/company-logo.jpg",
  "companyName": "Salesforge",
  "completedAt": "2026-03-18T12:05:00Z",
  "createdAt": "2026-03-18T12:00:00Z",
  "followerCount": 12345,
  "jobID": "pcfj_abc123",
  "linkedinUrl": "https://www.linkedin.com/company/salesforgeai",
  "processed": 120,
  "reservedCredits": 50,
  "resultsURL": "/public/v1/company-followers/jobs/pcfj_abc123/results",
  "status": "in_progress",
  "statusURL": "/public/v1/company-followers/jobs/pcfj_abc123",
  "total": 500,
  "updatedAt": "2026-03-18T12:01:00Z",
  "webhookURL": "https://example.com/webhooks/followers"
}

Changes

No recorded changes to this operation across all 1 revision of this API.