company-followers

List company followers jobs

List the caller's company-followers jobs, most recent first. Use the filters (status, clientRequestID, from/to) to recover a job when the job ID is unknown.

get/company-followers/jobs

Request

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

Query parameters

offsetinteger

Offset

limitinteger required

Page size (max 100)

status'in_progress' | 'completed' | 'failed' | 'no_results'

Filter by status

clientRequestIDstring

Filter by your clientRequestID

fromstring

Created-at lower bound (RFC3339)

tostring

Created-at upper bound (RFC3339)

Response

Jobs

limitinteger

offsetinteger

totalinteger

Example response

{
  "jobs": [
    {
      "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.