Signals

Start a fixed-count Company Followers extraction

Start a fixed-size follower extraction on a Company Followers signal in count mode — the first extractionLimit followers of its pages, unfiltered, with no quote step. Activating a count signal already starts one; use this to run another once the previous one has finished.

Input: the signal ID in the path; no body. Uses the signal's linkedinCompanyUrls and extractionLimit.

Output: extraction with mode: count, status: processing, requestedCount and creditsHeld (1 credit per follower requested). At settlement you are charged for the leads delivered and the rest is returned.

Errors: WRONG_EXTRACTION_MODE (400, the signal is in icp mode — use .../extraction/quote), NO_COMPANIES / NO_COUNT (400), EXTRACTION_LIMIT_TOO_LOW (422, extractionLimit is under the minimum of 100 — raise it with PATCH /api/v1/signals/{signal_id}; nothing is held or charged), INSUFFICIENT_CREDITS (402), ALREADY_ACTIVE (409), EXTRACTION_FAILED (502, nothing charged — retry), COMPANY_PAGE_UNAVAILABLE (422, a linkedinCompanyUrls page does not exist on LinkedIn — error.companyUrls lists it; nothing is held or charged; replace it with PATCH /api/v1/signals/{signal_id}), UNSUPPORTED (400), NOT_FOUND (404).

post/api/v1/signals/{signal_id}/extraction/extract

Request

Base URL: https://api.rodz.io (the document declares no server; this is the origin it was published from)
URL: https://api.rodz.io/api/v1/signals/{signal_id}/extraction/extract
Auth: HTTP bearer

Path parameters

signal_idstring required

Response

Successful Response

Example response

{
  "extraction": {
    "createdAt": "2026-10-09T09:15:00+00:00",
    "creditsCharged": 0,
    "creditsHeld": 0,
    "creditsQuoted": 620,
    "creditsReleased": 0,
    "estimatedFollowers": 1240,
    "expiresAt": "2026-11-08T09:15:00+00:00",
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "mode": "icp",
    "status": "quoted",
    "updatedAt": "2026-10-09T09:15:02+00:00"
  }
}

Changes

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