tiktok/
top-search

Busque videos y carruseles de fotos de TikTok por palabra clave, con descripciones, datos del creador de contenido, enlaces de medios y conteos de interacción devueltos juntos en una sola lista JSON.

TikTok Top Search API

Videos y carruseles de fotos
Búsqueda por palabra clave
Filtros de orden y de publicación
0.7 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
queryObligatorioPalabra 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_byOpcionalOrden 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_withinOpcionalRango 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.
regionOpcionalCó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_limitOpcionalNú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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

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.

Explorar otras plataformas

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

TikTok Top Search API — FAQ

TikTok Top Search API es una interfaz para encontrar videos públicos y carruseles de fotos de TikTok a partir de una palabra clave o frase. Devuelve descripciones, creadores de contenido, enlaces de medios y conteos de interacción, con ordenamiento y filtros de tiempo de publicación opcionales.

Es una publicación de imágenes de TikTok que contiene varias fotos por las que los espectadores pueden desplazarse. En los resultados, type=photo_carousel identifica ese formato y media contiene las entradas de imágenes.

TikTok Search devuelve solo videos, mientras que Top Search puede incluir tanto videos como carruseles de fotos. Elija según si su recopilación o su visualización necesita manejar también las publicaciones de imágenes.

No hay un filtro de entrada solo para fotos. Tras la obtención, seleccione los registros cuyo type sea photo_carousel; el límite de resultados se aplica antes de su propio filtrado por formato, por lo que la cantidad de fotos restante puede ser menor.

No. region cambia la disponibilidad del contenido para la búsqueda, no el origen geográfico de cada resultado; no lo use como sustituto de un campo de ubicación del creador de contenido o de la publicación.

No. results_limit es un tope de la selección devuelta, no una garantía de que se incluya cada publicación de TikTok que coincida. Una búsqueda puede devolver menos registros que el límite solicitado.

Cada registro de contenido devuelto cuesta 0.7 créditos, sea un video o un carrusel de fotos. No hay cargo base; un límite de 100 estima 70 créditos, mientras que 20 registros devueltos cuestan 14 créditos.