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ámetros | Obligatorio | Descripción |
|---|---|---|
region | Obligatorio | Valor 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_limit | Opcional | Tope 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.
- 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.
- Envíe region y results_limit por POST a /v1/tiktok/trending-feed y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que el estado sea succeeded o failed.
- 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.
APIs relacionadas
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.
- TikTok Profiles API
- TikTok Hashtags API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API