TikTok fetcher.sh

Twitter/X, YouTube, Reddit, Google e mais - 100+ endpoints no total. Sem conta, sem OAuth, sem assinatura. Pague por chamada em USDC, ou faça um depósito único e use o mesmo saldo em todos eles.

GitHub
2

Documentação

name: tiktok-api description: >- Uma alternativa à API do TikTok no fetcher.sh — pague por chamada em USDC via x402, ou créditos pré-pagos com uma chave Bearer, sem login e sem revisão de aplicativo. Use quando o usuário quiser pesquisar posts do TikTok por palavra-chave e ordenar por mais curtidos ou mais recentes dentro de um intervalo de datas, consultar um post pelo seu URL de compartilhamento ou ID, extrair um perfil do TikTok por @username, puxar os posts, seguidores ou seguidos de um usuário, buscar posts de uma hashtag, puxar posts usando uma faixa de som/música específica, obter posts de uma localização, ou ler os comentários e respostas de comentários de um post. Também cobre monitoramento de tendências do TikTok, monitoramento de hashtags, descoberta de influenciadores, análise de conteúdo de concorrentes e pipelines de dados do TikTok sem acesso oficial à API do TikTok ou um navegador de scraping. keywords:

  • tiktok
  • tiktok-api
  • tiktok-api-alternative
  • tiktok-data
  • social-media
  • social-listening
  • hashtag-tracking
  • x402
  • ai-agent

API do TikTok

Dados do TikTok sob demanda: busca de posts por palavra-chave com filtros de ordenação/data, consulta de perfil por handle, seguidores e seguidos, feeds de hashtag e música/som, posts baseados em localização e threads de comentários — um simples GET HTTP por chamada, pago conforme o uso. Sem login, sem cookies de sessão, sem automação de navegador, sem revisão de aplicativo de desenvolvedor do TikTok.

URL base: https://tiktok.fetcher.sh

Referência rápida

URL basehttps://tiktok.fetcher.sh
AutenticaçãoAuthorization: Bearer bby_live_... ou x402 (USDC)
Preço$0,004/chamada (fixo)
Endpoints13, todos GET
MCPhttps://tiktok.fetcher.sh/mcp
Legível por máquina/openapi.json · /llms.txt · /skill.md

Qual endpoint eu preciso?

Eu quero...Chamar
Pesquisar posts por palavra-chave (opcionalmente mais curtidos/recentes)GET /api/post/search
Consultar um post pelo seu URL de compartilhamentoGET /api/post?url=...
Consultar um perfil por @usernameGET /api/user/handle/{username}
Obter os posts, seguidores ou seguidos de um usuárioGET /api/user/{id}/posts / /followers / /followings
Obter os comentários de um postGET /api/post/{id}/comments
Encontrar posts sob uma hashtagGET /api/hashtag/{id}/posts
Encontrar posts usando um som específicoGET /api/music/{id}/posts

Detalhes completos dos parâmetros para cada linha: references/endpoints.md.

Autenticação

Duas formas de pagar, mesmos dados — mecânica completa na habilidade fetcher skill:

# 1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup
#    or via POST /api/credits/topup, see the fetcher skill)
export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx"
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/post/search?keyword=hello"

# 2. x402 pay-per-call — omit the header; a GET with no payment returns 402
#    with machine-readable payment requirements (USDC on Base, Polygon,
#    Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically.

Toda resposta é { "status": number, "message": string, "data": ... }; o status HTTP reflete status.

Endpoints (13 — todos GET, $0,004/chamada)

EndpointO que retorna
/api/post/searchPosts que correspondem a uma palavra-chave; filtros de ordenação e intervalo de datas
/api/postUm único post resolvido a partir do seu URL de compartilhamento
/api/post/{id}Um único post por ID
/api/post/{id}/commentsOs comentários de um post
/api/post/{id}/comments/{commentId}/repliesRespostas a um comentário
/api/user/handle/{username}Perfil por @username
/api/user/{id}/postsOs posts de um usuário
/api/user/{id}/followersOs seguidores de um usuário
/api/user/{id}/followingsContas que um usuário segue
/api/hashtag/handle/{name}Metadados de hashtag por nome
/api/hashtag/{id}/postsPosts sob uma hashtag
/api/music/{id}/postsPosts usando uma faixa de som/música
/api/location/{locationId}/postsPosts marcados em uma localização

{id} / {username} / {name} são parâmetros de caminho. Parâmetros de consulta opcionais (cursor, region) paginam ou definem escopo geográfico dos resultados; keyword (busca) e url (consulta de post) são obrigatórios onde aparecem.

Cenários

Posts mais curtidos neste mês:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "keyword=ai agent" -G \
  --data-urlencode "sortType=MOST_LIKED" \
  --data-urlencode "dateRange=THIS_MONTH" \
  "https://tiktok.fetcher.sh/api/post/search"

Postados ontem, mais recentes primeiro:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "keyword=crypto payments" -G \
  --data-urlencode "sortType=DATE_POSTED" \
  --data-urlencode "dateRange=YESTERDAY" \
  "https://tiktok.fetcher.sh/api/post/search"

Outros valores de sortType: RELEVANCE. Outros valores de dateRange: ALL_TIME, THIS_WEEK, LAST_THREE_MONTHS, LAST_SIX_MONTHS.

Consultar um post pelo seu URL de compartilhamento, ou diretamente por ID:

curl -H "Authorization: Bearer $FETCHER_API_KEY" -G \
  --data-urlencode "url=https://www.tiktok.com/@username/video/1234567890123456789" \
  "https://tiktok.fetcher.sh/api/post"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/post/1234567890123456789"

Comentários de um post e respostas de comentários:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/post/1234567890123456789/comments"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/post/1234567890123456789/comments/9876543210/replies"

Um perfil por @handle, depois seus posts, seguidores e seguidos:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/user/handle/khaby.lame"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/user/6935741396776976390/posts"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/user/6935741396776976390/followers"

Metadados de uma hashtag, depois seus posts:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/hashtag/handle/fyp"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/hashtag/1234567890/posts"

Posts usando um som específico, e posts de uma localização:

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/music/1234567890123456789/posts"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://tiktok.fetcher.sh/api/location/1234567890123456789/posts"

MCP

{
  "mcpServers": {
    "tiktok": {
      "url": "https://tiktok.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}

Grátis: search_endpoints, describe_endpoint, check_balance. Pago: fetch_data (qualquer endpoint acima), topup_credits, além do atalho nomeado tiktok_post_search. Remova o bloco headers para pagar por chamada com x402 em vez disso — veja a habilidade fetcher skill para o fluxo completo.

Erros

  • 400 — parâmetro ausente ou inválido (a mensagem o nomeia)
  • 401 — chave desconhecida ou rotacionada
  • 402 — pagamento necessário (desafio x402) ou topup_required (créditos esgotados)
  • 404 — não é um caminho com preço
  • Sem limites de taxa; sem reembolsos em falhas upstream (a liquidação precede a entrega)

Referência