tiktok/
search

Busque videos públicos de TikTok por palabra clave con filtros de relevancia, fecha, Me gusta y ventana de publicación, y obtenga registros normalizados de creador de contenido, contenido, medios e interacción.

TikTok Search API

Descubrimiento por palabra clave
Muestras de investigación
Ventanas de tiempo
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 Search

Los resultados de TikTok Search son videos públicos que coinciden con una palabra clave o frase, con datos del creador de contenido, descripciones, medios, contexto de publicación e interacción visible. Estos registros sirven para descubrir temas, investigar tendencias, monitorear a la competencia y analizar oportunidades de contenido.

Funcionalidades de la TikTok Search API

  • Descubrimiento de videos por palabra claveConvierta la palabra clave de un tema, una marca, un producto o un evento en un conjunto de videos candidatos.
  • Orden por relevancia y actualidadAlterne entre relevancia, fecha y Me gusta para obtener una perspectiva temática, reciente o de videos con muchos Me gusta.
  • Ventanas de publicaciónDefina el periodo de investigación con day, week, month, three_months o six_months.
  • Campos de contenido y de creador de contenidoDevuelve campos de video, creador de contenido, interacción, hashtags y música con una estructura uniforme de resultados de búsqueda.
  • Instantáneas de búsqueda con trazabilidadRegistre cada experimento de búsqueda mediante search_query y collected_at.

Parámetros de la TikTok Search API

ParámetrosObligatorioDescripción
queryObligatorioConsulta obligatoria y no vacía por palabra clave para descubrir videos públicos de TikTok.
results_limitOpcionalLímite positivo de resultados de video solicitados. El valor predeterminado es 100.
sort_byOpcionalOrden de los resultados: relevance, date o likes. El valor predeterminado es relevance.
published_withinOpcionalVentana de publicación opcional: day, week, month, three_months o six_months.

Cómo usar la TikTok Search API

Defina primero la pregunta de investigación y luego elija la palabra clave, el objetivo de ordenamiento y la ventana de publicación.

  1. Convierta el tema de investigación en una consulta específica y elija results_limit, sort_by y published_within.
  2. Envíe la solicitud por POST a /v1/tiktok/search y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea llegue a succeeded o failed.
  4. Lea data.results.items. Cuando has_more sea true, continúe con next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"space exploration","results_limit":100,"sort_by":"relevance","published_within":"month"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la TikTok Search API

  • Exploración de mercados y categorías: Use términos de producto, categoría y caso de uso para mapear el panorama de contenido de TikTok y una muestra de creadores de contenido.
  • Seguimiento del impulso de eventos: Combine el orden por fecha con una ventana de un día o una semana para seguir el contenido reciente en torno a lanzamientos, eventos y momentos noticiosos.
  • Investigación creativa de videos con muchos Me gusta: Ordene por Me gusta y estudie los ganchos, las descripciones, las elecciones musicales y las combinaciones de hashtags que se repiten.
  • Monitoreo de menciones de marca: Ejecute consultas de marca y de producto de forma programada y guarde instantáneas para los equipos de contenido y de comunicación.

Consejos de expertos para la TikTok Search API

  • Divida un tema amplio en consultas de marca, necesidad, ocasión y tendencia, y luego combine los conjuntos de videos resultantes.
  • Elija relevance para mapear un tema, date para seguir las publicaciones nuevas y likes para estudiar los patrones creativos populares.
  • Use published_within para mantener las muestras en una escala de tiempo constante, por ejemplo week en informes recurrentes.
  • Guarde juntos query, sort_by, published_within y collected_at para poder reproducir la búsqueda.
  • Deduplique entre consultas por el id del video y conserve cada search_query que coincidió con el video.
  • Repita las consultas principales de forma programada para comparar los cambios en creadores de contenido, temas e interacción.

Además de la TikTok 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 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 Search Users API — Busca cuentas públicas de TikTok por palabra clave.

Explorar otras plataformas

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

TikTok Search API — FAQ

TikTok Search API encuentra videos de acceso público a partir de una palabra clave o frase. Devuelve datos normalizados de video, creador de contenido, descripción, medios, publicación e interacción, con ordenamiento y filtros de tiempo admitidos.

query es una palabra clave o frase obligatoria y no vacía, como una marca, un producto, una campaña, una persona o un tema de investigación.

relevance ordena los resultados por relevancia temática, date da prioridad a las publicaciones recientes y likes da prioridad al rendimiento público en Me gusta. relevance es el valor predeterminado.

published_within acepta day, week, month, three_months y six_months para los videos publicados en el periodo reciente correspondiente.

results_limit define el tope solicitado de resultados de video, debe ser un entero positivo y su valor predeterminado es 100.

Los resultados incluyen el ID del video, la URL canónica, la descripción, el idioma, la hora de publicación, el creador de contenido, la interacción pública, los hashtags, las menciones, los medios y los datos de la música.

search_query registra el término que produjo el resultado, mientras que collected_at registra la hora de recopilación para obtener instantáneas de búsqueda con trazabilidad.

Cada resultado normalizado de video de búsqueda devuelto cuesta 0.7 créditos.