List jobs
GET
https://scraper.riken.me/v1/jobsCost: FreeLiveErrors are free
Try it
Paste your key under Authorization and send a live request to https://scraper.riken.me. The key stays in this browser tab only (session storage, cleared when the tab closes) and is sent nowhere else. A live request spends credits like any other.
GET
This key's jobs, newest first, without chunks or results. Free.
Headers
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
x-api-key | string | one of the auth headers | Your API key. If both headers are sent, `x-api-key` wins. | sk_... |
Authorization | string | one of the auth headers | `Authorization: Bearer <key>`, the same key. | Bearer sk_... |
Query parameters
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
state | string | no | Comma-separated or repeated filter. | running,queued |
kind | string | no | Comma-separated or repeated filter, one of the job kinds. | tiktok.walk |
limit | integer | no | Rows per page (per list). 0 or less means the default; above 500 is capped at 500. | 500 |
cursor | string | no | The `next_cursor` of the previous page. |
Status codes
| Status | Charged | Meaning |
|---|---|---|
| 200 | Free | A page of jobs. Free. |
| 400 | Free | A malformed body, parameter or cursor. Free. |
| 401 | Free | Missing, unknown or revoked key. Free. |
| 429 | Free | The key's request rate. Free. |
| 500 | Free | Our fault. Free. |
A page of jobs. Free.
application/json- response
jobs*array<>next_cursor?stringExample request
# A call can be held open up to 180 s (audience: 300 s). Set a client timeout above that.curl -X GET 'https://scraper.riken.me/v1/jobs?state=running%2Cqueued&kind=tiktok.walk&limit=500'Example Response
{ "jobs": [ { "id": 533, "kind": "tiktok.search", "state": "failed", "priority": 30, "progress": { "units_done": 0, "units_total": 20 }, "credits": { "held_micro": 20000000, "spent_micro": 0, "held": "20.000000", "spent": "0.000000" }, "error": "ttsearch: exit status 1: *** IN-HOUSE SEARCH RETURNED NOTHING ***", "created_at": "2026-10-31T02:37:56.843367Z", "started_at": "2026-10-31T02:37:56.860944Z", "finished_at": "2026-10-31T02:38:55.516451Z" } ]}