Jobs API

Async jobs are created automatically when a list call requests limit > 50 (see Async jobs). These endpoints manage them.

GET /v1/jobs

Lists your recent jobs, newest first. Paginated with cursor/limit.

curl "https://api.scrapersocial.com/v1/jobs?limit=10" \
  -H "Authorization: Bearer sk_live_..."

{
  "data": [
    {
      "job_id": "job_01JZY0P3XQ",
      "endpoint": "/v1/tiktok/comments",
      "status": "succeeded",
      "items": 500,
      "created_at": "2026-07-14T18:20:11Z",
      "completed_at": "2026-07-14T18:21:37Z"
    }
  ],
  "meta": { "count": 1, "has_more": false },
  "request_id": "req_01JZX4M8Q2TE9W"
}

GET /v1/jobs/{job_id}

Returns one job. While running, status is queued or running. On success the payload adds result_url — a signed URL to the full result set (JSON lines):

{
  "data": {
    "job_id": "job_01JZY0P3XQ",
    "status": "succeeded",
    "items": 500,
    "credits_charged": 1000,
    "result_url": "https://api.scrapersocial.com/v1/jobs/job_01JZY0P3XQ/result"
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

Failed jobs include error.code/error.message and charge nothing.

Prefer webhooks over polling for long jobs — register for job.completed in the Webhooks API.