Volver a las API
Datos de investigación de TikTok Creative Center

TikTok Creative Center API

Convierta las clasificaciones de TikTok Creative Center en datos que puede consultar: anuncios de mejor rendimiento, hashtags en tendencia por país, clasificaciones de videos destacados y fichas de Creator Marketplace.

API de TikTok Creative Center disponibles

Top Ads, Trending Hashtags y Top Videos leen las clasificaciones; Ad Analysis, Hashtag Insights y Creator Marketplace profundizan en un anuncio, un hashtag o un grupo de creadores tomados de esas clasificaciones.

¿Qué datos de Creative Center se pueden obtener?

Cada endpoint devuelve registros estables de SocQ construidos con lo que Creative Center muestra del anuncio, el hashtag, la clasificación o el creador elegido.

Anuncios de mejor rendimiento

Descripción del anuncio, industria, objetivo, puntuación de clics, Me gusta y video para los anuncios que selecciona Creative Center, además de los países de entrega, el percentil de impresiones y las curvas de clics y de retención segundo a segundo de un anuncio concreto.

Hashtags en tendencia

Clasificaciones por país de 7, 30 o 90 días con posición, cantidad de publicaciones y de vistas y una curva diaria de popularidad; Hashtag Insights suma los países principales por puntuación y los ID de videos de ejemplo de una etiqueta.

Clasificaciones de videos destacados

Clasificaciones diarias, semanales y de largo plazo por país con descripción, creador, vistas del periodo, vistas orgánicas y totales, tasa de interacción, tasa de visualización de seis segundos y el ID de Marketplace del creador.

Fichas de Creator Marketplace

Distribución de seguidores por edad, género, país y dispositivo, mediana de vistas, tasas de interacción y de crecimiento de seguidores, y la tarifa inicial que cada creador indica para un video patrocinado.

SocQ y TikTok Creative Center

Creative Center es el sitio de investigación de TikTok para explorar clasificaciones en una interfaz web. SocQ devuelve esas mismas clasificaciones como registros de API que puede almacenar, comparar y combinar.

FuncionalidadSocQTikTok Creative Center
AccesoClave de API y registros JSONInterfaz web
Recopilación masivaHasta 300 anuncios, 100 hashtags o 100 videos por tareaNavegación página por página
Análisis posteriorLos ID de una clasificación alimentan el siguiente endpointNavegación manual entre páginas
SalidaCampos estables de SocQ con descripcionesGráficos y fichas visuales

Cómo funcionan las API de TikTok Creative Center

Los seis endpoints usan el mismo ciclo asíncrono de envío, consulta y lectura.

  1. 1. Leer una clasificación

    Envíe filtros a Top Ads, Trending Hashtags o Top Videos, como una palabra clave, un país o un periodo.

  2. 2. Consultar la tarea

    Use el task_id devuelto con /v1/tasks/{task_id} hasta que el procesamiento se complete o falle.

  3. 3. Profundizar

    Envíe el id de un anuncio a Ad Analysis, el id de un hashtag a Hashtag Insights o valores de creator_id a Creator Marketplace.

Comience con una sola solicitud

Autentíquese con una clave de API de SocQ. Top Ads devuelve 20 resultados por defecto y acepta hasta 300.

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"}'

# Then analyze one ad:
# POST /v1/tiktok-creative-center/ad-analysis
# {"ad_id":"7697084527089729557"}
# Poll GET /v1/tasks/{task_id}

Casos de uso frecuentes de TikTok Creative Center API

Búsqueda de anuncios de la competencia

Busque en Top Ads por palabra clave, ordene por Me gusta y lea la industria, el objetivo y la puntuación de clics de cada anuncio para ver qué enfoques creativos premia una categoría.

Diagnóstico de dónde se pierde el interés en un anuncio

Envíe el id de un anuncio de Top Ads a Ad Analysis y compare su click_through_curve con su retention_curve segundo a segundo para ver dónde hacen clic los espectadores y dónde se van.

Seguimiento de hashtags por mercado

Obtenga de forma periódica los hashtags en tendencia de cada país objetivo y use popularity_curve para ver qué etiquetas siguen subiendo antes de planificar publicaciones.

Comparación de ganchos y alcance

Ordene la clasificación de videos de un país por six_second_view_rate y compare organic_views_count con views_count para ver qué aperturas retienen a los espectadores y qué videos se impulsaron sobre todo con publicidad.

Preselección de creadores

Tome valores de creator_id de las clasificaciones de videos y compare en sus fichas de Creator Marketplace los porcentajes de audiencia, la mediana de vistas, la interacción y la tarifa inicial publicada.

Alcance de los datos

Los resultados siguen lo que Creative Center publica para cada clasificación, mercado y periodo.

  • Top Ads incluye los anuncios que cumplen los umbrales de rendimiento de Creative Center y que sus anunciantes autorizaron, por lo que es una selección curada y no todos los anuncios de TikTok.
  • Las clasificaciones de videos se publican con retraso, de unos dos días la diaria y con semanas que terminan en domingo la semanal; un mercado sin clasificación devuelve cero resultados y no se cobra.
  • Las fichas de Creator Marketplace existen solo para los creadores inscritos en el Creator Marketplace de TikTok y se consultan por ID de Marketplace, de modo que los ID tomados de otro lugar no coinciden.
  • Las clasificaciones de hashtags reciben solo un país y una ventana de tiempo, sin filtro por industria, y las filas de la clasificación dejan los países principales y los videos de ejemplo para Hashtag Insights.
  • Las puntuaciones de clics, los percentiles y los valores de popularidad son medidas relativas que informa Creative Center, no informes de campañas a nivel de cuenta.

Preguntas frecuentes sobre TikTok Creative Center API

¿Qué es TikTok Creative Center API?

TikTok Creative Center API es una interfaz programática para leer los anuncios destacados, los hashtags en tendencia, las clasificaciones de videos destacados y las fichas de Creator Marketplace de TikTok Creative Center como registros JSON normalizados.

¿Necesito una cuenta de TikTok o una cuenta de anuncios?

No. Las solicitudes usan su clave de API de SocQ y leen las clasificaciones que Creative Center publica en sus páginas públicas de investigación.

¿Cómo paso de una clasificación a un anuncio, un hashtag o un creador concreto?

Cada clasificación devuelve el ID que necesita su endpoint de detalle: el id del anuncio va a Ad Analysis, el id del hashtag a Hashtag Insights junto con el mismo país, y el creator_id de Top Videos a Creator Marketplace.

¿Cuál es la diferencia entre Top Ads y Top Videos?

Top Ads devuelve anuncios pagados de TikTok con su puntuación de clics, industria y objetivo. Top Videos devuelve la clasificación de videos de un país con vistas, vistas orgánicas y tasas de interacción, además del ID de Marketplace de cada creador.

¿Qué tan actualizados están los datos?

Cada solicitud devuelve lo que Creative Center tiene publicado en ese momento, y cada registro trae una marca de tiempo collected_at. Las clasificaciones diarias de videos van unos dos días por detrás de la fecha actual y las semanales terminan en domingo.

¿Cómo se cobran los endpoints?

Top Ads, Trending Hashtags, Top Videos y Creator Marketplace cuestan 0.5 créditos por resultado devuelto. Ad Analysis cuesta 1 crédito y Hashtag Insights 0.5 créditos por solicitud.

Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.