> **For coding agents and LLMs:** This is one page from the Social Fetch docs (markdown export). For curated orientation and workflow guidance, start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for agent onboarding and crawl rules, use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for the full endpoint list with links to pages like this one, use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt); for one platform's parameters and curls, use [`/llms-{platform}.txt`](https://www.socialfetch.dev/llms-tiktok.txt); use [`/llms.json`](https://www.socialfetch.dev/llms.json) when you need structured JSON for tool registration.

## This page

- **On-site (HTML):** [https://www.socialfetch.dev/docs/api/v1/tiktok](https://www.socialfetch.dev/docs/api/v1/tiktok)
- **Markdown (.mdx) URL:** [https://www.socialfetch.dev/docs/api/v1/tiktok.mdx](https://www.socialfetch.dev/docs/api/v1/tiktok.mdx)

## API base URL and authentication

- **API origin (from OpenAPI `servers`):** `https://api.socialfetch.dev`
- **Authentication:** send `x-api-key: sfk_...` on `/v1/**` routes unless the operation is explicitly anonymous (check OpenAPI `security`, the [API reference hub](https://www.socialfetch.dev/docs/api.mdx), [`/llms.txt`](https://www.socialfetch.dev/llms.txt), or [`/llms.json`](https://www.socialfetch.dev/llms.json) for each route).
- **OpenAPI JSON:** [https://www.socialfetch.dev/openapi.json](https://www.socialfetch.dev/openapi.json)

## Recommended docs entrypoints (this site)

- [Documentation overview](https://www.socialfetch.dev/docs.mdx) — top-level orientation (markdown).
- [Quickstart](https://www.socialfetch.dev/docs/quickstart.mdx) — authenticate with `x-api-key`, validate auth with `whoami`, and understand the JSON envelope.
- [SDK](https://www.socialfetch.dev/docs/sdk.mdx) — official TypeScript SDK guide, including `SocialFetchClient`, `Result`, and `unwrap()`.
- [SDK reference](https://www.socialfetch.dev/docs/sdk-reference.mdx) — exhaustive SDK method inventory and route mapping for agents, tooling, and power users.
- [Choose the right endpoint](https://www.socialfetch.dev/docs/choose-endpoint.mdx) — task-oriented route selection for smoke tests, profiles, list endpoints, and single-item lookups.
- [Capability matrix](https://www.socialfetch.dev/docs/capability-matrix.mdx) — fast comparison of identifiers, pagination, outcomes, media download, and SDK coverage.
- [Recipes](https://www.socialfetch.dev/docs/recipes.mdx) — copyable workflows (brand monitoring, transcripts, Ad Library, creator scoring, Reddit research) with credit callouts and SDK examples.
- [Integrations](https://www.socialfetch.dev/docs/integrations.mdx) — MCP for AI clients, n8n verified node, Apify Store Actors, Make custom app, SDK, and REST API connection paths.
- [MCP product page](https://www.socialfetch.dev/mcp) — hosted MCP overview, OAuth, Skills install.
- [MCP integration](https://www.socialfetch.dev/docs/integrations/mcp.mdx) — hosted `/mcp` server, OAuth, Cursor/VS Code/Claude install snippets, 165 endpoint tools, plus docs_search/docs_read for implementation help.
- [n8n integration](https://www.socialfetch.dev/docs/integrations/n8n.mdx) — install `n8n-nodes-socialfetch`, credentials, and workflow examples.
- [Apify integration](https://www.socialfetch.dev/docs/integrations/apify.mdx) — Store Actors under @social-fetch, PPE billing, dataset export, and quick start.
- [Make integration](https://www.socialfetch.dev/docs/integrations/make.mdx) — custom app modules for Make scenarios, API key credentials, and module catalog.
- [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt) — every documented operation with a direct link to that route's agent-readable markdown page (prefer this over parsing OpenAPI).
- [`/llms-{platform}.txt`](https://www.socialfetch.dev/llms-tiktok.txt) — per-platform endpoint files generated from OpenAPI (parameters, credits, curls).
- [`/agents.txt`](https://www.socialfetch.dev/agents.txt) — agent crawl/onboarding file with capabilities, auth rules, and allowlist.
- [`/llms.json`](https://www.socialfetch.dev/llms.json) — structured machine-readable operation inventory with parameter names, pagination, outcomes, credits, and SDK mapping.
- [API reference hub](https://www.socialfetch.dev/docs/api.mdx) — human-friendly index of operations with links into generated pages.
- [Errors](https://www.socialfetch.dev/docs/errors.mdx) — shared error envelope and HTTP status guidance.
- [Credits](https://www.socialfetch.dev/docs/credits.mdx) — metering, `402`, and planning batch jobs.
- Outcome semantics such as `found`, `not_found`, and `private` are documented in [Errors](https://www.socialfetch.dev/docs/errors.mdx) and on operation pages when present in the OpenAPI contract.

## Markdown docs convention

- Every docs page has a markdown twin: append **`.mdx`** to the docs pathname (for example `/docs/quickstart` → `/docs/quickstart.mdx`).
- Agents that send `Accept: text/markdown` on `/docs/**` HTML URLs may receive markdown directly (same URL, `Vary: Accept`).

---
# TikTok API reference (https://www.socialfetch.dev/docs/api/v1/tiktok)

Social Fetch's TikTok tag is twenty-six `GET /v1/tiktok/...` routes. Pass a handle, video URL, or search query and get `{ data, meta }` with `data.lookupStatus`, `meta.requestId`, and `meta.creditsCharged`. Authenticate with `x-api-key` only — you do not log in as the TikTok user whose public data you read.

These pages are generated from the public OpenAPI spec. Product overview, examples, and FAQs live on the [TikTok scraper API hub](/platforms/tiktok). Build-vs-buy and DIY browser scraping: [How to scrape TikTok data](/guides/how-to-scrape-tiktok-data).

  Most TikTok routes are **1 credit** per completed lookup, and paginated calls bill **each page**. The exceptions: profile audience is **30**, the profile engagement audit is **5**, and media download is **11**. Opt-in parameters add credits — `hostMedia` on profile videos, `downloadMedia` on a video, and `useAiFallback` on a transcript. Trust `meta.creditsCharged`.

## Profiles

- [TikTok profile](/docs/api/v1/tiktok/profiles/handle/get) — `GET /v1/tiktok/profiles/{handle}` — followers, bio, avatar, verification.

- [Profile videos](/docs/api/v1/tiktok/profiles/handle/videos/get) — `GET /v1/tiktok/profiles/{handle}/videos` — video feed, cursor-paged.

- [Followers](/docs/api/v1/tiktok/profiles/handle/followers/get) — `GET /v1/tiktok/profiles/{handle}/followers` — follower list, cursor-paged.

- [Following](/docs/api/v1/tiktok/profiles/handle/following/get) — `GET /v1/tiktok/profiles/{handle}/following` — accounts a profile follows.

- [Profile region](/docs/api/v1/tiktok/profiles/handle/region/get) — `GET /v1/tiktok/profiles/{handle}/region` — account region signal.

- [Audience demographics](/docs/api/v1/tiktok/profiles/handle/audience/get) — `GET /v1/tiktok/profiles/{handle}/audience` — audience breakdown (30 credits).

- [Live stream](/docs/api/v1/tiktok/profiles/handle/live/get) — `GET /v1/tiktok/profiles/{handle}/live` — current live status and room.

- [Engagement audit](/docs/api/v1/tiktok/profiles/handle/engagement/get) — `GET /v1/tiktok/profiles/{handle}/engagement` — engagement rate (5 credits).

## Search

- [Search users](/docs/api/v1/tiktok/users/search/get) — `GET /v1/tiktok/users/search` — find accounts by keyword.

- [Search videos](/docs/api/v1/tiktok/search/get) — `GET /v1/tiktok/search` — keyword video search.

- [Hashtag search](/docs/api/v1/tiktok/search/hashtags/get) — `GET /v1/tiktok/search/hashtags` — hashtag-led discovery.

## Videos

- [Single video](/docs/api/v1/tiktok/videos/get) — `GET /v1/tiktok/videos` — one video or photo post by URL.

- [Video comments](/docs/api/v1/tiktok/videos/comments/get) — `GET /v1/tiktok/videos/comments` — comment list, cursor-paged.

- [Comment replies](/docs/api/v1/tiktok/videos/comments/replies/get) — `GET /v1/tiktok/videos/comments/replies` — nested replies.

- [Download media](/docs/api/v1/tiktok/videos/download/get) — `GET /v1/tiktok/videos/download` — hosted video or photo assets (11 credits).

- [Video transcript](/docs/api/v1/tiktok/videos/transcript/get) — `GET /v1/tiktok/videos/transcript` — captions to plain text.

- [Trending feed](/docs/api/v1/tiktok/feed/trending/get) — `GET /v1/tiktok/feed/trending` — trending videos by region.

## Music

- [Song](/docs/api/v1/tiktok/songs/get) — `GET /v1/tiktok/songs` — sound metadata by URL or id.

- [Videos using a sound](/docs/api/v1/tiktok/music/clipid/videos/get) — `GET /v1/tiktok/music/{clipId}/videos` — videos for one sound.

## TikTok Shop

- [Search products](/docs/api/v1/tiktok/shop/products/search/get) — `GET /v1/tiktok/shop/products/search` — Shop catalog by keyword.

- [Store products](/docs/api/v1/tiktok/shop/products/get) — `GET /v1/tiktok/shop/products` — products for one store.

- [Product](/docs/api/v1/tiktok/products/get) — `GET /v1/tiktok/products` — one product by URL or id.

- [Product reviews](/docs/api/v1/tiktok/products/reviews/get) — `GET /v1/tiktok/products/reviews` — reviews for a product.

- [Showcase products](/docs/api/v1/tiktok/profiles/handle/showcase-products/get) — `GET /v1/tiktok/profiles/{handle}/showcase-products` — a creator's showcase.

## Ads

- [Ad Library ad](/docs/api/v1/tiktok/ad-library/ads/get) — `GET /v1/tiktok/ad-library/ads` — one ad by URL or id.

- [Ad Library search](/docs/api/v1/tiktok/ad-library/ads/search/get) — `GET /v1/tiktok/ad-library/ads/search` — ads by keyword or advertiser.

## Related

* [TikTok scraper API hub](/platforms/tiktok) — coverage, FAQs, and credit notes
* [How to scrape TikTok data](/guides/how-to-scrape-tiktok-data)
* [Best TikTok data APIs](/blog/best-tiktok-data-apis-2026) — vendor comparison
* [Free TikTok transcript generator](/tools/tiktok-transcript)
* [API reference](/docs/api) — all platforms