Signals

Get a Company Followers signal's extraction

Know where a Company Followers signal stands: whether its followers have been priced, what the quote costs, whether the extraction is running and how many leads it has delivered. Poll it after requesting a quote or accepting one.

Why it matters: a Company Followers signal in icp mode (the default — every follower matching your filters) produces no leads until a quote is requested and accepted, even while the signal is active. Its single-signal responses carry a QUOTE_REQUIRED warning until then.

Input: the signal ID in the path.

Output: extraction — the signal's latest extraction, or null when none was ever requested: id, mode (icp / count), status (awaiting_quote → quoted → accepted → processing → results_ready / imported → settled; or declined, failed), estimatedFollowers (followers matching your filters), creditsQuoted (the price), creditsHeld, creditsCharged, creditsReleased, deliveredCount, error (why a failed extraction stopped, e.g. expired, or company_page_unavailable when a company page does not exist), createdAt, updatedAt, and expiresAt (when an unaccepted quote lapses).

Errors: NOT_FOUND (404, no such signal on your account), UNSUPPORTED (400, not a Company Followers signal).

get/api/v1/signals/{signal_id}/extraction

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