Introduction
Live TikTok creator data over plain HTTP. One key, one header, JSON back.
Riken Scraper gives you TikTok profiles, profile videos and keyword search as JSON. Every answer is fetched live when you ask for it, and you pay only for answers you get.
Make your first call
Get a key
Create an API key in the dashboard. Keys start with sk_. Keep yours out of source control.
export RIKEN_API_KEY=sk_...Send it in a header
Every request carries the key in x-api-key (or Authorization: Bearer). See Authentication.
Call an endpoint
curl -s --max-time 200 "https://scraper.riken.me/v1/tiktok/profile?handle=example_creator" \
-H "x-api-key: $RIKEN_API_KEY"{
"success": true,
"credits_charged": 1,
"credits_remaining": 999,
"user": { "uniqueId": "example_creator", "nickname": "Example Creator" },
"stats": { "followerCount": 52300, "videoCount": 214 }
}Base URL
https://scraper.riken.meEvery route is a GET under /v1/... or /v3/... and every answer is JSON. The full contract is also published as OpenAPI.
Endpoints
| endpoint | path | status | cost |
|---|---|---|---|
| Profile | GET /v1/tiktok/profile | live | 1 credit |
| Profile videos | GET /v3/tiktok/profile/videos | live, page 1 only in beta | 1 credit |
| Keyword search | GET /v1/tiktok/search/keyword | live | 1 credit per page |
| Followers | GET /v1/tiktok/user/followers | coming | 1 credit per page |
| Following | GET /v1/tiktok/user/following | coming | 1 credit per page |
| Audience | GET /v1/tiktok/user/audience | coming | 20 credits |
The sidebar lists every endpoint with its own page: parameters, code in six languages, a live Try it box and example answers per status.
Before you ship
- Set your HTTP client timeout above 180 seconds. A request can be held that long before you get
504 timeout. See Capacity and Retry-After. - Branch on the
errorcode, never onmessage. See Errors. - Send an
Idempotency-Keyon retries so a retry never costs twice. See Retries and idempotency.
For AI tools
- llms.txt lists every page. llms-full.txt is the whole site in one file.
- Each page has a Copy for AI button that copies it as Markdown.
- The same endpoints work as tools in Claude, Cursor and other agents through the MCP server.