# TikTok on fetcher.sh

> TikTok on fetcher.sh is an x402-paywalled web-data API: 13 GET endpoints (TikTok), each payable per call in USDC on Base, Polygon, Arbitrum, Monad or Solana — or prepaid via a credit balance with a bby_live_ Bearer API key. Built for autonomous agents: no accounts, no OAuth, machine-readable 402 challenges.

- Base URL: https://tiktok.fetcher.sh
- OpenAPI 3.1 contract: https://tiktok.fetcher.sh/openapi.json
- Remote MCP server (Streamable HTTP): https://tiktok.fetcher.sh/mcp — free tools: search_endpoints, describe_endpoint, check_balance; paid tools: fetch_data, topup_credits, and its named shortcut tiktok_post_search; pays via x402 on any network below, or an Authorization: Bearer bby_live_... header
- Agent setup instructions: https://tiktok.fetcher.sh/skill.md
- Human top-up page (browser wallet): https://tiktok.fetcher.sh/topup
- Payments: x402 "exact" scheme in USDC on eip155:8453, eip155:137, eip155:42161, eip155:143, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp — every 402 lists one accepts entry per network, Base first, each with its own asset and payTo; gas sponsored, no native token needed
- Credits: POST /api/credits/topup?amount=<usd> (min $1, x402-paid; the first top-up returns the API key exactly once, &rotate=1 mints a fresh one), then Authorization: Bearer bby_live_... per call; GET /api/credits/balance reads the balance; sending Authorization: Bearer with the top-up recharges that key's account from any wallet
- Response envelope: { "status": number, "message": string, "data": any }
- Chain caveats: the facilitator enforces a per-chain minimum payment, so a cheap endpoint can be refused on an expensive chain — retry on another network. On Solana, USDC needs an associated token account on both sides or the transfer fails with InvalidAccountData; receiving USDC once creates it.
- Credits are keyed by wallet address, so an EVM wallet and a Solana wallet are separate balances with separate keys
- No rate limits; no refunds on upstream failures (settlement precedes delivery)

## Services

- TikTok (also: tik tok) — https://tiktok.fetcher.sh — 13 endpoints — Search posts, resolve users by handle, and pull followers, hashtags, music, comments, and replies.

## Endpoints (price per call)

### TikTok

GET /api/hashtag/handle/{name} — $0.004 — Hashtag handle
GET /api/hashtag/{id}/posts — $0.004 — Hashtag posts
GET /api/location/{locationId}/posts — $0.004 — Location posts
GET /api/music/{id}/posts — $0.004 — Music posts
GET /api/post — $0.004 — Post
GET /api/post/search — $0.004 — Post search
GET /api/post/{id} — $0.004 — Post
GET /api/post/{id}/comments — $0.004 — Post comments
GET /api/post/{id}/comments/{commentId}/replies — $0.004 — Post comments replies
GET /api/user/handle/{username} — $0.004 — User handle
GET /api/user/{id}/followers — $0.004 — User followers
GET /api/user/{id}/followings — $0.004 — User followings
GET /api/user/{id}/posts — $0.004 — User posts