TikTok Top Search
TikTok Top search reúne videos y carruseles de fotos, que son publicaciones formadas por varias imágenes, en torno a una palabra clave o frase. Las descripciones, las identidades de los creadores de contenido, los medios y los conteos de interacción ayudan a comparar cómo aparece un mismo tema en esos distintos formatos de contenido.
Funcionalidades de la TikTok Top Search API
- Encuentre videos y publicaciones de imágenes en una sola búsquedaUna misma consulta por palabra clave puede devolver publicaciones de video y carruseles de fotos, y el campo type identifica el formato para que pueda mantener ambos en un mismo conjunto de datos o separarlos para su revisión.
- Elija el orden y el rango de publicaciónOrdene el contenido coincidente por relevancia, fecha de publicación o Me gusta, y agregue un filtro de tiempo de publicación para centrar la selección devuelta en el tipo de contenido que desea inspeccionar.
- Lea el contenido junto con su creador de contenido y sus contadoresCada resultado reúne la descripción, la información del creador de contenido, los enlaces de medios y los conteos de interacción disponibles, de modo que pueda relacionar el tema y el formato de una publicación con la cuenta que la publicó.
Parámetros de la TikTok Top Search API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Palabra clave o frase obligatoria que describe lo que desea encontrar, como coffee o home workout; ingrese texto de búsqueda y no la URL de una publicación de TikTok. |
sort_by | Opcional | Orden opcional: relevance prioriza la relevancia de la coincidencia, date ordena por fecha de publicación y likes ordena por conteo de Me gusta; el valor predeterminado es relevance. |
published_within | Opcional | Rango opcional de tiempo de publicación: day selecciona ayer, week esta semana, month este mes, three_months los últimos tres meses y six_months los últimos seis meses; déjelo en blanco para no aplicar ningún filtro adicional de tiempo de publicación. |
region | Opcional | Código de región opcional de dos letras, como US o GB, que cambia qué contenido es accesible para la búsqueda; no demuestra que las publicaciones o los creadores de contenido devueltos estén ubicados en ese país. |
results_limit | Opcional | Número máximo opcional de registros de contenido, de 1 a 2000, con 100 como valor predeterminado; los videos y los carruseles de fotos cuentan para este total, y se pueden devolver menos resultados. |
Cómo usar la TikTok Top Search API
La solicitud inicia una tarea de recopilación en segundo plano, por lo que su primera respuesta entrega un ID de tarea y no los datos finales; use ese ID para comprobar el avance y obtener los resultados.
- Ingrese una palabra clave del tema, elija si relevance, date o likes es lo más útil y defina un límite de resultados; agregue un rango de publicación o una región solo cuando necesite esas opciones.
- Antes de ejecutar el ejemplo, reemplace $SOCQ_API_KEY por su propia clave de API o defina esa variable de entorno. Envíe la entrada JSON por POST a /v1/tiktok/top-search con el encabezado Authorization que se muestra abajo y guarde el task_id de la respuesta.
- Use GET /v1/tasks/{task_id} con el ID guardado para comprobar el avance. queued significa en espera, running significa que la recopilación está en curso y retrying significa que se está haciendo otro intento. Espere a succeeded antes de leer los resultados; si la tarea está en failed, lea error_message para conocer el motivo.
- Cuando la tarea tenga éxito, lea data.results.items: cada elemento de esta lista describe una publicación de video o de carrusel de fotos. Una lista vacía significa que la tarea terminó sin devolver ningún registro.
- Si data.results.has_more es true, el valor de next_cursor es el marcador de otra página de resultados guardados. Cópielo sin cambios en el parámetro cursor de GET /v1/tasks/{task_id}?cursor=... y continúe hasta que has_more sea false.
curl -X POST "https://api.socq.ai/v1/tiktok/top-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"coffee","sort_by":"relevance","results_limit":20}'Casos de uso de la TikTok Top Search API
- Armar una colección de contenido por tema: Busque un tema como coffee y guarde las descripciones, los nombres de usuario de los creadores de contenido, los enlaces y los tipos de contenido en una tabla de revisión que incluya ejemplos de videos y de publicaciones de imágenes.
- Comparar los conteos de interacción de las publicaciones devueltas: Combine los Me gusta, comentarios y veces compartido disponibles con el formato y la hora de publicación de cada publicación para preparar una hoja de comparación, y conserve la consulta y los filtros para saber cómo se seleccionaron los ejemplos.
Consejos de expertos para la TikTok Top Search API
- Al mostrar un resultado, inspeccione primero type y media: photo_carousel indica una publicación de imágenes y debe usar una galería de imágenes en lugar de un reproductor de video.
- Al recopilar varias palabras clave, use el ID de la publicación para deduplicar las coincidencias repetidas y conserve la palabra clave asociada a cada recopilación, para no contar la misma publicación varias veces por error.
- Si su flujo de trabajo solo acepta videos, use TikTok Search; si necesita tanto videos como publicaciones de imágenes, use Top Search y maneje ambos formatos en su visualización.
- Cuando un resultado de fotos no tenga duración ni conteo de reproducciones, deje esa medición vacía en lugar de interpretarla como un video de cero segundos o una publicación sin reproducciones.
APIs relacionadas
Además de la TikTok Top Search API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok.
- TikTok Profiles API — Obtiene por nombre de usuario la identidad del perfil público, biografías, indicadores de cuenta y conteos de audiencia.
- TikTok Hashtags API — Recolecta videos públicos, creadores, contenido multimedia, sonido e interacción de los hashtags indicados.
- 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 Search API — Busca videos públicos por palabra clave con filtros de orden y de publicación compatibles.
- TikTok Live Room Info API — Consulta una transmisión en vivo conocida mediante el par de IDs de la sala y del propietario, y devuelve su estado, el contexto del propietario, la portada y los conteos de audiencia.
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs 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