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ámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Consulta obligatoria y no vacía por palabra clave para descubrir videos públicos de TikTok. |
results_limit | Opcional | Límite positivo de resultados de video solicitados. El valor predeterminado es 100. |
sort_by | Opcional | Orden de los resultados: relevance, date o likes. El valor predeterminado es relevance. |
published_within | Opcional | Ventana 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.
- Convierta el tema de investigación en una consulta específica y elija results_limit, sort_by y published_within.
- Envíe la solicitud por POST a /v1/tiktok/search y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea llegue a succeeded o failed.
- 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 trueCasos 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.
APIs relacionadas
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.
- 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 Song API
- TikTok Song Videos 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