tiktok/
trending-feed

Obtenga el feed público actual de videos de TikTok de un código de región, con ID de videos, descripciones, creadores de contenido, imágenes de portada, marcas de tiempo e interacción visible.

TikTok Trending Feed API

Feed regional
Videos normalizados
Instantánea actual
0.7 créditos por resultado
Listo
README

Por SocQ · Actualizado el

TikTok Trending Feed

Los videos de TikTok Trending Feed son entradas públicas del feed expuestas para un contexto regional, con la identidad del video y del creador de contenido, descripciones, imágenes de portada, marcas de tiempo e interacción visible. Estas señales de contenido y rendimiento sirven para tomar instantáneas de descubrimiento regional, investigar creatividades y hacer comparaciones en un momento dado.

Funcionalidades de la TikTok Trending Feed API

  • Feed público por regiónAcepta un valor de región no vacío y obtiene el feed público actual de videos expuesto para ese contexto regional de la solicitud.
  • Detalle normalizado del video y del creador de contenidoDevuelve los ID y las URL de origen de los videos, las descripciones, la identidad del creador de contenido, las referencias de la imagen de portada y las marcas de tiempo de creación y recopilación en registros uniformes.
  • Métricas de interacción visiblesMantiene juntos los conteos públicos de reproducciones, Me gusta, comentarios, veces compartido y guardados de cada video devuelto.
  • Instantánea actual acotadaRecorta la respuesta de un feed regional a results_limit sin seguir la continuación del origen, y conserva una muestra actual del feed en lugar de posiciones o series históricas.

Parámetros de la TikTok Trending Feed API

ParámetrosObligatorioDescripción
regionObligatorioValor de región obligatorio y no vacío. El backend le quita los espacios y lo convierte a mayúsculas; use un código de región estándar de dos letras, como US, para el contexto regional deseado.
results_limitOpcionalTope entero opcional de 4 a 2,000; el valor predeterminado es 100 y recorta la respuesta única del feed, que puede contener menos videos.

Cómo usar la TikTok Trending Feed API

Envíe una solicitud de feed regional como tarea asíncrona y luego lea sus videos normalizados con paginación por cursor de los resultados de la tarea.

  1. Ingrese un valor de región no vacío; use un código estándar de dos letras, como US, para el contexto regional deseado, y elija un results_limit de 4 a 2,000 o mantenga el valor predeterminado de 100.
  2. Envíe region y results_limit por POST a /v1/tiktok/trending-feed y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
  4. Lea data.results.items desde /v1/tasks/{task_id}?limit=50 y continúe con results.next_cursor mientras results.has_more sea true.
curl -X POST "https://api.socq.ai/v1/tiktok/trending-feed" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region":"US","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.

Casos de uso de la TikTok Trending Feed API

  • Capturar una instantánea de descubrimiento regional: Guarde los ID de videos, las URL de origen, las descripciones, los creadores de contenido y collected_at de una solicitud de feed regional para documentar el conjunto expuesto públicamente en el momento de la recopilación.
  • Muestrear los patrones creativos actuales: Revise las descripciones, los nombres de los creadores de contenido, las imágenes de portada y las horas de creación para comparar la mezcla creativa visible en el feed de una región seleccionada.
  • Comparar la interacción visible: Use los conteos de reproducciones, Me gusta, comentarios, veces compartido y guardados junto con collected_at para comparar las señales públicas de interacción entre los videos devueltos.

Consejos de expertos para la TikTok Trending Feed API

  • Use un código de región estándar de dos letras aunque el runtime actual solo exija un valor no vacío; el backend quita los espacios y lo convierte a mayúsculas.
  • Elija results_limit como un tope y no como una cantidad esperada, porque el endpoint recorta la respuesta de un feed y no solicita páginas de continuación del origen.
  • Trate region como contexto de disponibilidad del feed y no como prueba del origen de un video; extra.region es un dato por fila y puede estar vacío o diferir de la solicitud.
  • Use los cursores de resultados de la tarea solo para paginar registros ya guardados por SocQ; no obtienen otra página del feed regional.
  • Al comparar ejecuciones repetidas, deduplique por el id del video y conserve collected_at, porque la composición y el orden del feed pueden cambiar entre solicitudes.
  • Maneje los campos del creador de contenido, las métricas, los medios de portada, las marcas de tiempo y los valores extra como datos que pueden ser nulos, y escape las descripciones públicas antes de mostrarlas.

Además de la TikTok Trending Feed API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok.

  • TikTok Comments API — Recolecta comentarios públicos de primer nivel, autores, interacción, menciones e indicadores de interacción del creador.
  • TikTok Videos API — Obtiene el creador, la descripción, el contenido multimedia, la música, las etiquetas, las menciones y la interacción desde URLs de videos.
  • TikTok User Videos API — Recolecta videos públicos del feed de un perfil por nombre de usuario, con descripciones, creadores, contenido multimedia, marcas de tiempo, interacción y contexto de la cuenta de origen.
  • TikTok Video Transcript API — Extrae el texto de transcripción disponible, el idioma, el formato y el contexto de origen desde URLs de videos públicos.
  • TikTok Song API — Obtiene los metadatos de un sonido público por ID de clip o URL de música.
  • TikTok Song Videos API — Recolecta videos públicos que usan los IDs de sonido indicados.

Explorar otras plataformas

Combine los datos de TikTok con datos públicos de otras plataformas sociales compatibles.

TikTok Trending Feed API — FAQ

TikTok Trending Feed API es una interfaz que recopila el feed público actual de videos de TikTok expuesto para un valor de región no vacío. Devuelve identidad normalizada del video, descripciones, creadores de contenido, imágenes de portada, marcas de tiempo, interacción visible y, cuando se exponen, el contexto de región o de publicidad por fila.

Envíe un valor de región no vacío; el backend le quita los espacios y lo convierte a mayúsculas. Use un código estándar de dos letras, como US, porque la documentación pública y la interfaz de origen definen así la entrada regional prevista, aunque el runtime actual no exige el formato de dos letras.

results_limit tiene 100 como valor predeterminado y acepta enteros de 4 a 2,000. Recorta una respuesta del feed regional devuelta, por lo que un límite más alto no activa la continuación del origen y no garantiza esa cantidad de videos.

Un registro puede contener el ID y la URL de origen del video, la descripción, el ID, el nombre de usuario y el nombre visible del creador de contenido, los conteos visibles de reproducciones, Me gusta, comentarios, veces compartido y guardados, una imagen de portada, las horas de creación y recopilación, además de extra.region y extra.is_ad.

No. region controla el contexto de disponibilidad del feed para la solicitud, no la ubicación del creador de contenido ni el origen del video; extra.region se proporciona por fila y puede estar vacío o ser distinto.

No. Devuelve los videos del feed expuesto en ese momento, sin campos normalizados de posición, cambio de posición, agregados de hashtags, ranking de creadores, ranking de canciones ni series históricas. Para hacer comparaciones, guarde los resultados de tareas repetidas junto con collected_at.

Cada video normalizado guardado correctamente cuesta 0.7 créditos, sin cargo base por tarea. La estimación inicial usa results_limit o su valor predeterminado de 100, y los créditos precargados que no se usen se reembolsan cuando la tarea se liquida.