TikTok fetcher.sh

Twitter/X, YouTube, Reddit, Google y más: más de 100 endpoints en total. Sin cuenta, sin OAuth, sin suscripción. Paga por llamada en USDC, o recarga una vez y gasta un saldo en todos ellos.

GitHubPrueba este MCPPatrocinado

Documentación

name: tiktok-api description: >- Una alternativa a la API de TikTok en fetcher.sh — pago por llamada en USDC vía x402, o créditos prepagados con una clave Bearer, sin inicio de sesión y sin revisión de aplicaciones. Úsalo cuando el usuario quiera buscar publicaciones de TikTok por palabra clave y ordenar por más gustados o más recientes dentro de un rango de fechas, buscar una publicación por su URL compartida o ID, extraer un perfil de TikTok por @username, obtener las publicaciones, seguidores o seguidos de un usuario, obtener publicaciones de un hashtag, obtener publicaciones usando una pista de sonido/música específica, obtener publicaciones de una ubicación, o leer los comentarios y respuestas a comentarios de una publicación. También cubre el seguimiento de tendencias de TikTok, monitoreo de hashtags, descubrimiento de influencers, análisis de contenido de competidores y pipelines de datos de TikTok sin acceso oficial a la API de TikTok o un navegador de scraping. keywords:

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

API de TikTok

Datos de TikTok bajo demanda: búsqueda de publicaciones por palabra clave con filtros de orden/fecha, búsqueda de perfil por nombre de usuario, seguidores y seguidos, feeds de hashtags y música/sonido, publicaciones basadas en ubicación e hilos de comentarios — una simple solicitud HTTP GET por llamada, pagada a medida que la usas. Sin inicio de sesión, sin cookies de sesión, sin automatización de navegador, sin revisión de aplicaciones de desarrollador de TikTok.

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

Referencia rápida

URL basehttps://tiktok.fetcher.sh
AutenticaciónAuthorization: Bearer bby_live_... o x402 (USDC)
Precio$0.004/llamada (tarifa plana)
Endpoints13, todos GET
MCPhttps://tiktok.fetcher.sh/mcp
Legible por máquina/openapi.json · /llms.txt · /skill.md

¿Qué endpoint necesito?

Quiero...Llamar
Buscar publicaciones por palabra clave (opcionalmente más gustados/recientes)GET /api/post/search
Buscar una publicación por su URL compartidaGET /api/post?url=...
Buscar un perfil por @usernameGET /api/user/handle/{username}
Obtener las publicaciones, seguidores o seguidos de un usuarioGET /api/user/{id}/posts / /followers / /followings
Obtener los comentarios de una publicaciónGET /api/post/{id}/comments
Encontrar publicaciones bajo un hashtagGET /api/hashtag/{id}/posts
Encontrar publicaciones usando un sonido específicoGET /api/music/{id}/posts

Detalles completos de parámetros para cada fila: references/endpoints.md.

Autenticación

Dos formas de pagar, mismos datos — mecánica completa en la habilidad 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.

Cada respuesta es { "status": number, "message": string, "data": ... }; el estado HTTP refleja status.

Endpoints (13 — todos GET, $0.004/llamada)

EndpointQué devuelve
/api/post/searchPublicaciones que coinciden con una palabra clave; filtros de orden y rango de fechas
/api/postUna sola publicación resuelta desde su URL compartida
/api/post/{id}Una sola publicación por ID
/api/post/{id}/commentsLos comentarios de una publicación
/api/post/{id}/comments/{commentId}/repliesRespuestas a un comentario
/api/user/handle/{username}Perfil por @username
/api/user/{id}/postsLas publicaciones de un usuario
/api/user/{id}/followersLos seguidores de un usuario
/api/user/{id}/followingsCuentas que sigue un usuario
/api/hashtag/handle/{name}Metadatos de hashtag por nombre
/api/hashtag/{id}/postsPublicaciones bajo un hashtag
/api/music/{id}/postsPublicaciones usando una pista de sonido/música
/api/location/{locationId}/postsPublicaciones etiquetadas en una ubicación

{id} / {username} / {name} son parámetros de ruta. Parámetros de consulta opcionales (cursor, region) paginan o limitan geográficamente los resultados; keyword (búsqueda) y url (búsqueda de publicación) son obligatorios donde aparecen.

Escenarios

Publicaciones más gustadas este mes:

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"

Publicado ayer, más recientes primero:

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"

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

Buscar una publicación por su URL compartida, o directamente 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"

Los comentarios de una publicación y las respuestas a comentarios:

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"

Un perfil por @handle, luego sus publicaciones, seguidores y 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"

Los metadatos de un hashtag, luego sus publicaciones:

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"

Publicaciones usando un sonido específico, y publicaciones de una ubicación:

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_..." }
    }
  }
}

Gratis: search_endpoints, describe_endpoint, check_balance. De pago: fetch_data (cualquier endpoint anterior), topup_credits, más el atajo nombrado tiktok_post_search. Elimina el bloque headers para pagar por llamada con x402 en su lugar — consulta la habilidad fetcher skill para el flujo completo.

Errores

  • 400 — parámetro faltante o inválido (el mensaje lo nombra)
  • 401 — clave desconocida o rotada
  • 402 — pago requerido (desafío x402) o topup_required (créditos agotados)
  • 404 — no es una ruta con precio
  • Sin límites de tasa; sin reembolsos por fallos ascendentes (el pago precede a la entrega)

Referencia