SocQ ya cubría perfiles, videos, comentarios, búsquedas y hashtags públicos de TikTok; la guía de scraping de TikTok los repasa. El 2026-11-17 se publicaron 14 endpoints más de TikTok en la página de la plataforma TikTok. Responden preguntas que los endpoints básicos no podían: dónde viven los seguidores de un creador, si las visualizaciones de un video son reales, qué busca la gente hoy y qué vende ahora mismo una transmisión LIVE.
Esta guía agrupa los nuevos endpoints por tarea, muestra una solicitud para cada uno, indica el precio y explica cuándo usarlo.
Respuesta rápida: cada endpoint es un
POSTahttps://api.socq.ai/v1/tiktok/<endpoint>con un cuerpo JSON. La llamada devuelve untask_id; consulteGET /v1/tasks/{task_id}hasta questatusseasucceededy leadata.results.items.
Los nuevos endpoints de TikTok de un vistazo
1 crédito de SocQ = $0.005. Los endpoints que cobran por resultado no tienen tarifa base, así que un resultado vacío no cuesta nada.
| Endpoint | Qué devuelve | Precio |
|---|---|---|
| TikTok Audience Demographics API | Países de los seguidores con su proporción y el número muestreado | 20 créditos ($0.10) por llamada |
| TikTok Fake Views Checker API | Puntuación de vistas falsas, vistas falsas estimadas y su proporción, nivel de tráfico, motivo principal | 5 créditos ($0.025) por llamada |
| TikTok Similar Accounts API | Cuentas que TikTok recomienda como similares, con biografías y recuentos | 0.5 créditos ($0.0025) por cuenta |
| TikTok Reposts API | Videos que una cuenta ha compartido, con autor original y estadísticas | 0.5 créditos ($0.0025) por video |
| TikTok Playlists API | Listas de reproducción públicas con nombre, portada y número de videos | 0.5 créditos ($0.0025) por lista |
| TikTok Trending Searches API | Unas 100 búsquedas en tendencia de hoy, ordenadas | 0.5 créditos ($0.0025) por llamada |
| TikTok Creator Search Insights API | 20 búsquedas populares con puntuación de popularidad y tendencia de siete puntos | 1 crédito ($0.005) por llamada |
| TikTok Hashtag Views API | Total de videos y visualizaciones de hasta 20 hashtags | 0.5 créditos ($0.0025) por hashtag |
| TikTok Comment Keywords API | Palabras clave de los comentarios ordenadas, con los comentarios que las contienen | 1 crédito ($0.005) por llamada |
| TikTok Sound Search API | Sonidos con artista, duración, vista previa y número de usos | 0.6 créditos ($0.003) por sonido |
| TikTok Photo Search API | Publicaciones de carrusel de fotos con todas las imágenes e interacción | 0.6 créditos ($0.003) por publicación |
| TikTok Live Search API | Transmisiones LIVE en directo ahora, con anfitrión, espectadores y me gusta | 0.6 créditos ($0.003) por transmisión |
| TikTok Live Ranking API | Hasta 99 anfitriones del ranking diario de LIVE, con puntuación basada en regalos | 0.5 créditos ($0.0025) por llamada |
| TikTok Live Shopping API | Productos de la bolsa de compras de una transmisión LIVE, con precio y unidades vendidas | 0.1 créditos ($0.0005) por producto |
Autenticación y flujo de tareas asíncronas
Todas las solicitudes se autentican con una clave de API. Se usa el mismo encabezado para el envío, el estado de la tarea y la obtención de resultados:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Cada recopilación se ejecuta como una tarea en segundo plano:
submit -> task_id -> queued -> running -> succeeded
\-> failed
La llamada de envío responde de inmediato con data.task_id y data.status. Consulte la tarea con ese ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Cuando status es succeeded, la respuesta incluye result_count, credits_amount y la primera página de registros normalizados en data.results.items. limit vale 50 por defecto y llega hasta 500. Si results.has_more es true, pase results.next_cursor como cursor para leer la página siguiente. Una tarea fallida incluye error_message.
Puede añadir un callback_url opcional a cualquiera de los cuerpos de envío siguientes. SocQ enviará entonces un único POST con un resumen de la tarea cuando termine; lea los registros desde el endpoint de tareas. Un tiempo de espera agotado en el cliente no cancela la tarea, así que reanude con el mismo ID de tarea en lugar de enviarla de nuevo. Un 402 significa que la cuenta no tiene créditos, y un 429 que la clave alcanzó un límite de frecuencia o de créditos.
Evalúe a un creador antes de pagar
Estos cinco endpoints le ayudan a decidir si un creador merece un acuerdo.
Audience Demographics lista cada país de una muestra de seguidores con su proporción y el número de seguidores muestreados detrás, de mayor a menor. Úselo para comprobar que el alcance de un creador llega al mercado en el que usted vende. username funciona con o sin @. (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok/user-audience" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "khaby.lame"}'
Fake Views Checker recibe la URL de un video o de una publicación de fotos y devuelve fake_score, is_suspicious, confidence_level, estimated_fake_views, fake_view_percentage, estimated_organic_views, traffic_tier y main_reason. El parámetro opcional category (general por defecto, o entertainment, education, product, verified_large) elige las referencias de interacción. Ejecútelo en publicaciones patrocinadas y en creadores a los que está a punto de pagar por alcance. (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok/fake-views" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.tiktok.com/@tiktok/video/7460937381265411370"}'
Similar Accounts devuelve las cuentas que el propio TikTok recomienda como similares a un nombre de usuario, en el orden de TikTok, con biografía, número de seguidores y de videos y estado de verificación. Cuando un creador le funciona, esto amplía la lista de candidatos a su alrededor. results_limit vale 30 por defecto (de 1 a 300). (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok/similar-users" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "khaby.lame", "results_limit": 30}'
Reposts muestra lo que una cuenta amplifica más allá de sus propias publicaciones: cada video compartido con su autor original, descripción, visualizaciones, me gusta, hashtags y archivo de video, del más reciente al más antiguo. results_limit vale 20 por defecto (de 1 a 500). (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok/user-reposts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "mrbeast", "results_limit": 20}'
Playlists lista las listas de reproducción públicas de un creador con nombre, portada e item_count, lo que muestra las series y formatos a los que vuelve una y otra vez. results_limit vale 20 por defecto (de 1 a 100). (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok/user-playlists" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "zachking"}'
Una revisión completa de un creador, con Audience Demographics, Fake Views en tres videos recientes y 30 cuentas similares, cuesta 20 + 15 + 15 = 50 créditos ($0.25).
Descubra qué busca y comenta la gente
Trending Searches no requiere entrada y devuelve unas 100 búsquedas en tendencia de hoy en el orden de TikTok, cada una con un enlace de búsqueda. La lista se actualiza a diario, así que sirve como fuente matinal de ideas de contenido. (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok/trending-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
Creator Search Insights devuelve 20 búsquedas populares, cada una con una puntuación de popularidad de 0 a 100, una tendencia de siete puntos, el número de videos relacionados, la categoría y etiquetas. Todos los campos son opcionales: language (en por defecto; también ar, de, es, fr, id, ja, ko, pt, th, tr, vi), category (fashion, food, gaming, science, sports, tourism) y filter_by. Ponga filter_by en content_gap para obtener búsquedas con demanda pero todavía con pocos videos. (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok/search-insights" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"language": "en", "category": "food", "filter_by": "content_gap"}'
Hashtag Views compara hasta 20 hashtags en una sola solicitud por número total de videos y visualizaciones totales. Las etiquetas que no existen se omiten y no se cobran. (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok/hashtag-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtags": ["cooking", "booktok"]}'
Comment Keywords lee por usted una sección de comentarios concurrida: las palabras clave más frecuentes, ordenadas, cada una con los comentarios que la mencionan y sus me gusta. (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok/comment-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.tiktok.com/@tiktok/video/7460937381265411370"}'
Para los términos de búsqueda que TikTok muestra bajo una consulta, consulte la guía de TikTok Top Search.
Busque sonidos y publicaciones de fotos
Sound Search busca en la biblioteca de sonidos por título, artista o estado de ánimo y devuelve ID de sonido, artista, portada, duración, una vista previa reproducible y metrics.videos_count. sort_by puede ser relevance (por defecto), most_used o latest; region vale US por defecto. Use el ID con TikTok Song Videos, o compárelo con las listas de la guía de TikTok Music Chart. results_limit vale 20 por defecto (de 1 a 500). (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok/search-music" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "lofi", "results_limit": 20}'
Photo Search devuelve solo publicaciones de carrusel de fotos, con todas las imágenes del carrusel además de la descripción, el autor, los hashtags, las visualizaciones, los me gusta, los comentarios y las veces compartida. results_limit vale 20 por defecto (de 1 a 500). (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok/search-photos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "outfit ideas", "results_limit": 20}'
Siga TikTok LIVE y LIVE Shopping
Live Search encuentra transmisiones en directo en el momento de la solicitud, con título, anfitrión, espectadores actuales, me gusta y hora de inicio. results_limit vale 20 por defecto (de 1 a 200). (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok/search-live" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "deals", "results_limit": 20}'
Live Shopping lista los productos de la bolsa de compras de una transmisión con título, precio actual, unidades vendidas, vendedor e imagen. El id y el author.id de cada resultado de Live Search son el room_id y el user_id que necesita, así que llámelo mientras la transmisión siga en directo. results_limit vale 100 por defecto (de 1 a 500), y una transmisión sin productos no se cobra. (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok/live-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"room_id": "7704767945901132575", "user_id": "7153432386608251946", "results_limit": 100}'
Live Ranking no requiere entrada y devuelve hasta 99 anfitriones del ranking diario actual de LIVE, con posición, puntuación basada en regalos, nombre de usuario y número de seguidores. (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok/live-ranking" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
Para comprobar si determinadas cuentas están en directo, use el endpoint de la guía de TikTok Live Status.
Guías relacionadas de TikTok
Los anuncios y las tarifas de creadores de TikTok Creative Center se tratan en la guía de la TikTok Creative Center API, y los nuevos endpoints de TikTok Shop en la guía de investigación de productos de TikTok Shop. Para comparar SocQ con otros proveedores, lea Las 7 mejores API de scraping de TikTok y Alternativas a la API de TikTok.
Preguntas frecuentes
¿Se me cobra cuando una cuenta no tiene reposts ni listas de reproducción?
No. Los endpoints que cobran por resultado no tienen tarifa base, y la documentación indica que un resultado vacío no se cobra.
¿Cómo decide Fake Views Checker qué es falso?
Compara la interacción del video con referencias para el tipo de contenido que elija en category y devuelve una puntuación, las vistas falsas estimadas y su proporción, el nivel de tráfico y el motivo principal. Trátelo como una estimación que revisar, no como un veredicto.
¿De dónde salen el room_id y el user_id de Live Shopping?
De TikTok Live Search: el id de un resultado es el room_id y su author.id es el user_id. La transmisión debe seguir en directo.
¿Qué diferencia hay entre Trending Searches y Creator Search Insights?
Trending Searches es la lista ordenada de TikTok con unas 100 búsquedas de hoy, por 0.5 créditos. Creator Search Insights devuelve 20 búsquedas con una puntuación de popularidad y una tendencia de siete puntos, filtrables por idioma, categoría y hueco de contenido, por 1 crédito.
TIKTOK API
Probar el flujo de trabajo con una URL pública de TikTok
Envíe entradas públicas y reciba registros normalizados con contexto de origen rastreable.
Ver las API de TikTok