TikTok data API

Search posts, resolve users by handle, and pull followers, hashtags, music, comments, and replies. No account, no OAuth — pay per call with x402 or spend a prepaid credit balance with one API key.

13 endpoints$0.004 per callGET · JSON envelopeUSDC · gas sponsored

pay from any of:BasePolygonArbitrumMonadSolana

/api/hashtag/handle/:name
/api/hashtag/:id/posts
/api/location/:locationId/posts
/api/music/:id/posts
/api/post
/api/post/search
/api/post/:id
/api/post/:id/comments
/api/post/:id/comments/:commentId/replies
/api/user/handle/:username
/api/user/:id/followers
/api/user/:id/followings
/api/user/:id/posts

Also covers: tik tok

the main one

start here

$0.004 per call

Post search

/api/post/search

Sort by likes or recency, and narrow to a time window.

try an example

keywordrequiredcursoroptionalregionoptionalsortTypeoptionaldateRangeoptional

API key — optional · stays in your browser

Try it /api/post/search?keyword=ai+agent&sortType=MOST_LIKED&dateRange=THIS_MONTH

opens the payment page in a new tab · $0.004 per call

quick start

Call TikTok in 30 seconds

curl — with a credits API key

curl -H 'Authorization: Bearer bby_live_...' \
  'https://tiktok.fetcher.sh/api/post/search?keyword=ai'

curl — no key: the x402 challenge

# call without payment to inspect the 402 challenge
curl -i 'https://tiktok.fetcher.sh/api/post/search?keyword=ai'
# HTTP/1.1 402 Payment Required
# payment-required: <base64 payment requirements>

No key yet? Top up once (minimum $1) and the first response contains your bby_live_ key — one balance works across every fetcher.sh service. Generate one.

mcp

Add TikTok to Claude or Cursor

A remote MCP server scoped to this service: your agent gets these tools and nothing else, so the context cost stays small.

mcp config

{
  "mcpServers": {
    "fetcher": { "url": "https://tiktok.fetcher.sh/mcp" }
  }
}

reference

All 13 TikTok endpoints

Click any endpoint to open its console: fill the parameters and try it live — the payable URL opens in a new tab, ready for a browser wallet.

docs

Top up once — then hammer all 13 endpoints with one key

One x402 payment funds a credit balance. Every call after that is a plain Bearer request: no signing, no chain round-trip, more requests per second. The same balance works on every fetcher.sh service.

Generate API key your first top-up creates the key — shown once

Agents: paste Set up https://tiktok.fetcher.sh/skill.md into your agent — it reads the skill and sets everything up.