TikTok Creative Center es donde los profesionales del marketing consultan los anuncios con mejor rendimiento, los hashtags que suben en un país y los videos que encabezan los rankings. Creator Marketplace añade datos de audiencia y tarifas iniciales de los creadores. El 2026-11-17, SocQ añadió seis endpoints que devuelven estos datos en JSON, listados en la página de la plataforma TikTok Creative Center.
Los seis endpoints funcionan en tres pares. Un endpoint de lista encuentra candidatos y un endpoint de detalle toma el ID de esa lista y devuelve el análisis en profundidad. Esta guía cubre cada par: qué devuelve, la solicitud, el precio y cuándo usarlo.
Respuesta rápida: envíe un cuerpo JSON a
POST https://api.socq.ai/v1/tiktok-creative-center/<endpoint>. Guarde eltask_iddevuelto, consulteGET /v1/tasks/{task_id}hasta questatusseasucceededy luego leadata.results.items.
Los nuevos endpoints de TikTok Creative Center
1 crédito de SocQ = $0.005. Los endpoints de lista cobran por resultado, sin tarifa base.
| Endpoint | Qué devuelve | Precio |
|---|---|---|
| Top Ads API | Anuncios con mejor rendimiento, con texto, anunciante, sector, objetivo, CTR, me gusta y video | 0.5 créditos ($0.0025) por anuncio |
| Ad Analysis API | Detalles de un anuncio, percentil de impresiones y curvas de clics y retención segundo a segundo | 1 crédito ($0.005) por llamada |
| Trending Hashtags API | Hashtags en tendencia en un país, con posición, publicaciones, visualizaciones y curva diaria de popularidad | 0.5 créditos ($0.0025) por hashtag |
| Hashtag Insights API | Totales de un hashtag, curva de popularidad, países principales e IDs de videos de ejemplo | 0.5 créditos ($0.0025) por llamada |
| Top Videos API | Ranking de los videos principales de un país, con posición, creador, visualizaciones del periodo y totales, y tasas de interacción | 0.5 créditos ($0.0025) por video |
| Creator Marketplace API | Fichas de creadores con distribución de seguidores por edad, género, país y dispositivo, mediana de visualizaciones, tasa de interacción y tarifa inicial | 0.5 créditos ($0.0025) por creador |
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 admite 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.
Todos estos endpoints aceptan además un callback_url opcional. SocQ envía un único POST con un resumen de la tarea cuando esta termina; lea los registros desde el endpoint de tareas. Un tiempo de espera agotado en el cliente no cancela la tarea, así que retómela con el mismo ID en lugar de enviarla de nuevo. Un 402 significa que la cuenta se quedó sin créditos y un 429 que la clave alcanzó un límite de frecuencia o de créditos.
Top Ads y Ad Analysis: cree un archivo de referencias creativas
La Top Ads API recorre los anuncios que TikTok Creative Center clasifica como los de mejor rendimiento. Cada anuncio incluye su texto, anunciante, sector, objetivo de campaña, ctr, me gusta y el video completo. Todos los campos son opcionales: query busca en los textos y marcas de los anuncios, time_range es 7d, 30d (por defecto) o 180d, y sort_by es relevance (por defecto) o likes. results_limit vale 20 por defecto y acepta de 1 a 300. (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-ads" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "skincare", "time_range": "30d", "sort_by": "likes"}'
La Ad Analysis API toma el id de un resultado de Top Ads como ad_id. Además de los detalles del anuncio, sus países y su página de destino, devuelve impressions_percentile frente a anuncios comparables, una click_through_curve y una retention_curve, cada una con un valor por segundo de video. Lea ambas curvas juntas para encontrar el gancho, el punto en que los espectadores abandonan y el momento en que actúan. (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/ad-analysis" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ad_id": "7697084527089729557"}'
Cuándo usarlo: investigación creativa para una nueva campaña. Obtenga 20 anuncios destacados de su categoría (10 créditos) y luego analice los cinco más relevantes (5 créditos). En total son 15 créditos, es decir, $0.075.
Trending Hashtags y Hashtag Insights: detecte hashtags en alza por país
La Trending Hashtags API devuelve los hashtags que suben en un país, cada uno con su posición, número de publicaciones, número de visualizaciones y una popularity_curve diaria del periodo. Todos los campos son opcionales: country es un código de dos letras (por defecto US) y time_range es 7d (por defecto), 30d o 90d. results_limit vale 20 por defecto y acepta de 1 a 100. (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtags" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "US", "time_range": "7d", "results_limit": 20}'
La Hashtag Insights API toma un id de Trending Hashtags como hashtag_id, junto con el mismo country. Devuelve los totales de publicaciones y visualizaciones, la curva diaria de popularidad, top_countries con una puntuación de lo popular que es el hashtag en relación con el tamaño de cada país, y video_ids de videos de ejemplo. time_range vale 7d por defecto. (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtag-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"}'
Cuándo usarlo: para elegir hashtags para un lanzamiento en un mercado concreto, o para comprobar si un hashtag es global o local antes de crear contenido en torno a él. Para dimensionar cualquier hashtag que ya tenga en mente, incluidos los que no están en tendencia, la TikTok Hashtag Views API devuelve el total de videos y visualizaciones de hasta 20 hashtags a la vez.
Top Videos y Creator Marketplace: encuentre creadores y sus tarifas
La Top Videos API lee el ranking de TikTok Creative Center de los videos con mejor rendimiento en un país. Cada entrada incluye su posición, texto, creador, creator_id, visualizaciones del periodo del ranking, visualizaciones orgánicas, visualizaciones totales, tasa de interacción y tasa de visualización de seis segundos. Todos los campos son opcionales: country vale US por defecto, period es daily (por defecto), weekly o long_term, y sort_by es views (por defecto), engagement_rate o six_second_view_rate. Se usa el último ranking publicado. results_limit vale 20 por defecto y acepta de 1 a 100. (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "US", "period": "daily", "results_limit": 20}'
La Creator Marketplace API toma de 1 a 20 creator_ids numéricos, como los valores de creator_id de Top Videos. Cada creador que tiene ficha devuelve la distribución de sus seguidores por edad, género, país y dispositivo, el número de seguidores, la mediana de visualizaciones, la tasa de interacción, la tasa de crecimiento de seguidores, la tasa de visualización de seis segundos, los IDs de sus videos recientes y el starting_price que indica para un video patrocinado. Solo se cobran los creadores que tienen ficha. (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/creator-cards" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"creator_ids": ["7011198409688219653", "7070293872819044358"]}'
Cuándo usarlo: para crear una lista corta de creadores teniendo en cuenta el presupuesto. Un ranking diario de 20 videos (10 créditos) y las fichas de 20 creadores (10 créditos) cuestan 20 créditos, es decir, $0.10.
Cómo encaja con los demás endpoints de TikTok
Los datos de Creative Center los agrega TikTok: rankings, clasificaciones y curvas. Para el perfil, los videos y los comentarios propios de un creador, use los endpoints de la guía de scraping de TikTok. Para los países de los seguidores a partir de la cuenta pública de un creador y la detección de visualizaciones falsas, consulte la guía de los nuevos endpoints de TikTok. Los anuncios que se publican en Meta están cubiertos por las APIs de Facebook Ad Library.
Preguntas frecuentes
¿Necesito una cuenta de TikTok Ads o de Creator Marketplace?
No. Se autentica con una clave de API de SocQ y envía los campos mostrados arriba.
¿De dónde sale ad_id?
De un resultado de Top Ads: pase su id a Ad Analysis como ad_id. Del mismo modo, el id de Trending Hashtags pasa a Hashtag Insights como hashtag_id, y el creator_id de Top Videos pasa a Creator Marketplace.
¿Qué países puedo consultar?
Trending Hashtags, Hashtag Insights y Top Videos aceptan un código country de dos letras, como US, GB o JP, y usan US por defecto. Use en Hashtag Insights el mismo country con el que encontró el hashtag.
¿La tarifa inicial de un creador aparece siempre?
La tarifa forma parte de la ficha de Creator Marketplace, y solo los creadores con ficha devuelven un resultado. Como en otros campos de SocQ, un valor que la fuente no proporciona se devuelve como null.
¿Cómo se cobran los resultados vacíos?
Los endpoints que cobran por resultado no tienen tarifa base, así que una llamada que no devuelve nada no cuesta nada. Ad Analysis y Hashtag Insights se cobran una vez por llamada.
TIKTOK CREATIVE CENTER API
Probar el flujo de trabajo con una URL pública de TikTok Creative Center
Envíe entradas públicas y reciba registros normalizados con contexto de origen rastreable.
Ver las API de TikTok Creative Center