ListeningCollection

idinteger

source_idstring | nullnullable

null for refresh collections

kindstring

refresh: metrics of known posts by URL; comments: the comments of the project's top posts (collect_comments); import: posts added by URL (POST …/posts)

Possible values: [source, refresh, comments, import]

platformstring | nullnullable

run_idstring | nullnullable

statusListeningCollectionStatus

succeeded: every target answered; partial: items, but some targets blocked/failed; empty: genuinely nothing (never retried); blocked: 0 items, the platform refused (captcha, login wall, 429); failed: 0 items, another error; stale: no answer long after the run's timeout. Blocked/failed collections are retried after 10, 30, 90 min (blocked ones on the next proxy tier).

Possible values: [running, succeeded, partial, empty, blocked, failed, stale]

error_codes object

Error items by crawl-contract code: BLOCKED, LOGIN_REQUIRED, RATE_LIMITED, NOT_FOUND, PRIVATE, EMPTY, SCHEMA_CHANGED, FAILED.

property name*integer

attemptinteger

retry_at(string | null)<date-time>nullable

proxy_groupsstring[]

backfill_daysinteger | nullnullable

Days back this collection read as its source's backfill; null for a regular one

items_foundinteger

Real items (error items not counted)

mentions_newinteger

errorstring | nullnullable

created_at(string | null)<date-time>nullable

finished_at(string | null)<date-time>nullable

ListeningCollection

{
  "id": 0,
  "source_id": "string",
  "kind": "source",
  "platform": "string",
  "run_id": "string",
  "status": "running",
  "error_codes": {},
  "attempt": 0,
  "retry_at": "2024-07-29T15:51:28.071Z",
  "proxy_groups": [
    "string"
  ],
  "backfill_days": 0,
  "items_found": 0,
  "mentions_new": 0,
  "error": "string",
  "created_at": "2024-07-29T15:51:28.071Z",
  "finished_at": "2024-07-29T15:51:28.071Z"
}