# Riken Scraper > TikTok creator data over one HTTP API. Base URL: https://scraper.riken.me. OpenAPI: https://scraper.riken.me/docs/openapi.json. Every page below also has a Markdown twin (the .md link). The whole site in one file: https://scraper.riken.me/docs/llms-full.txt ## Get started - [Introduction](https://scraper.riken.me/docs) ([.md](https://scraper.riken.me/docs/llms.mdx/content.md)): Live TikTok creator data over plain HTTP. One key, one header, JSON back. - [Authentication](https://scraper.riken.me/docs/authentication) ([.md](https://scraper.riken.me/docs/llms.mdx/authentication/content.md)): Send your API key on every request, in one of two headers. - [Response envelope](https://scraper.riken.me/docs/response-envelope) ([.md](https://scraper.riken.me/docs/llms.mdx/response-envelope/content.md)): The keys every answer has, success or error. - [Credits and pricing](https://scraper.riken.me/docs/credits) ([.md](https://scraper.riken.me/docs/llms.mdx/credits/content.md)): What each call costs, and exactly which answers are charged. - [Errors](https://scraper.riken.me/docs/errors) ([.md](https://scraper.riken.me/docs/llms.mdx/errors/content.md)): Every error code, what it means and what to do. Errors are never charged. - [Retries and idempotency](https://scraper.riken.me/docs/idempotency) ([.md](https://scraper.riken.me/docs/llms.mdx/idempotency/content.md)): Retry safely with an Idempotency-Key. A replayed answer is never charged twice. - [Capacity and Retry-After](https://scraper.riken.me/docs/capacity) ([.md](https://scraper.riken.me/docs/llms.mdx/capacity/content.md)): No per-key rate limit. When we are full you get 429 with Retry-After, free. - [Free-answer limit](https://scraper.riken.me/docs/free-answer-limit) ([.md](https://scraper.riken.me/docs/llms.mdx/free-answer-limit/content.md)): 100 free answers per 10 minutes per key. Charged answers are never limited. - [Response headers](https://scraper.riken.me/docs/response-headers) ([.md](https://scraper.riken.me/docs/llms.mdx/response-headers/content.md)): Headers we send back and when. - [Latency](https://scraper.riken.me/docs/latency) ([.md](https://scraper.riken.me/docs/llms.mdx/latency/content.md)): What our own load tests measured. A guide, not a promise. - [Migrating from another API](https://scraper.riken.me/docs/migrating) ([.md](https://scraper.riken.me/docs/llms.mdx/migrating/content.md)): Same paths, parameters and body keys. Change the base URL and the key. ## Integrations - [MCP server](https://scraper.riken.me/docs/mcp) ([.md](https://scraper.riken.me/docs/llms.mdx/mcp/content.md)): Use the API as tools in Claude, Cursor, VS Code and other agents. Same key, same prices. ## TikTok - [Profile (GET /v1/tiktok/profile)](https://scraper.riken.me/docs/v1/tiktok/profile) ([.md](https://scraper.riken.me/docs/llms.mdx/v1/tiktok/profile/content.md)): One TikTok account: its user record and its counts. - [Profile videos (GET /v3/tiktok/profile/videos)](https://scraper.riken.me/docs/v3/tiktok/profile/videos) ([.md](https://scraper.riken.me/docs/llms.mdx/v3/tiktok/profile/videos/content.md)): An account's newest videos. - [Keyword search (GET /v1/tiktok/search/keyword)](https://scraper.riken.me/docs/v1/tiktok/search/keyword) ([.md](https://scraper.riken.me/docs/llms.mdx/v1/tiktok/search/keyword/content.md)): TikTok's Top results for a keyword, one page per call. - [Followers (GET /v1/tiktok/user/followers)](https://scraper.riken.me/docs/v1/tiktok/user/followers) ([.md](https://scraper.riken.me/docs/llms.mdx/v1/tiktok/user/followers/content.md)): One page of an account's followers, newest first, usually 50. - [Following (GET /v1/tiktok/user/following)](https://scraper.riken.me/docs/v1/tiktok/user/following) ([.md](https://scraper.riken.me/docs/llms.mdx/v1/tiktok/user/following/content.md)): One page of the accounts an account follows, newest follow first, usually 50. - [Audience (GET /v1/tiktok/user/audience)](https://scraper.riken.me/docs/v1/tiktok/user/audience) ([.md](https://scraper.riken.me/docs/llms.mdx/v1/tiktok/user/audience/content.md)): The countries of an account's followers, estimated from a sample: we read the newest 720 followers and place up to 150 by the country their latest video was posted from. ## Jobs and bulk - [Jobs and export](https://scraper.riken.me/docs/jobs-and-export) ([.md](https://scraper.riken.me/docs/llms.mdx/jobs-and-export/content.md)): Read a job's results page by page, or download them all as gzipped NDJSON. Free. - [List jobs (GET /v1/jobs)](https://scraper.riken.me/docs/v1/jobs-get) ([.md](https://scraper.riken.me/docs/llms.mdx/v1/jobs-get/content.md)): This key's jobs, newest first, without chunks or results. - [Submit a job (POST /v1/jobs)](https://scraper.riken.me/docs/v1/jobs-post) ([.md](https://scraper.riken.me/docs/llms.mdx/v1/jobs-post/content.md)): Queue a bulk job and hold its credits. - [Submit a job and wait for it (POST /v1/search)](https://scraper.riken.me/docs/v1/search) ([.md](https://scraper.riken.me/docs/llms.mdx/v1/search/content.md)): The same body as POST /v1/jobs, run ahead of queued work and held open until it finishes or the server's synchronous cap (CS_SEARCH_TIMEOUT, default 30 s) passes. - [Cancel a job (POST /v1/jobs/{id}/cancel)](https://scraper.riken.me/docs/v1/jobs/id/cancel) ([.md](https://scraper.riken.me/docs/llms.mdx/v1/jobs/id/cancel/content.md)): Stop a queued or running job and refund what it has not spent. - [Poll and download an export (GET /v1/jobs/{id}/export)](https://scraper.riken.me/docs/v1/jobs/id/export-get) ([.md](https://scraper.riken.me/docs/llms.mdx/v1/jobs/id/export-get/content.md)): The export's state; once done, one presigned URL per part. - [Start an export (POST /v1/jobs/{id}/export)](https://scraper.riken.me/docs/v1/jobs/id/export-post) ([.md](https://scraper.riken.me/docs/llms.mdx/v1/jobs/id/export-post/content.md)): Write all of a finished job's results as gzipped NDJSON files, read in one database snapshot. ## System - [Liveness (GET /healthz)](https://scraper.riken.me/docs/healthz) ([.md](https://scraper.riken.me/docs/llms.mdx/healthz/content.md)): No auth. ## Changelog - [Changelog](https://scraper.riken.me/docs/changelog) ([.md](https://scraper.riken.me/docs/llms.mdx/changelog/content.md)): Changes to endpoints, response bodies and limits.