Skip to content
ScraperSocial API

Async jobs

Synchronous list calls cap at limit=50. Ask for more and the API converts the call into a job:

Terminal window
curl "https://api.scrapersocial.com/v1/tiktok/comments?url=...&limit=500" \
  -H "Authorization: Bearer sk_live_..."
{
  "data": {
    "job_id": "job_01JZY0P3XQ",
    "status": "queued",
    "poll_url": "https://api.scrapersocial.com/v1/jobs/job_01JZY0P3XQ"
  },
  "request_id": "req_01JZX4M8Q2TE9W"
}

The response is 202 Accepted. Credits are charged when results are delivered, per item actually returned.

Poll for completion

Terminal window
curl "https://api.scrapersocial.com/v1/jobs/job_01JZY0P3XQ" \
  -H "Authorization: Bearer sk_live_..."

Status moves queued → running → succeeded | failed. On success the job payload includes result_url (and inline data for small results). GET /v1/jobs lists your recent jobs.

Or get a webhook instead

Register a webhook for job.completed and skip polling:

{
  "type": "job.completed",
  "data": { "job_id": "job_01JZY0P3XQ", "status": "succeeded", "items": 500 }
}

Verify the x-scrapersocial-signature header before trusting the payload — snippet in the webhooks guide.

Next: Webhooks · Jobs API reference