¿Puede la API de TikTok buscar videos, hashtags o tendencias?
Sí, la API de TikTok puede buscar videos, anuncios y tendencias, cada uno en una API distinta: la Research API busca videos públicos por palabra clave, hashtag, nombre de usuario, región o fecha, para investigadores que TikTok aprueba. La Commercial Content API busca anuncios por palabra clave o nombre del anunciante. La API for Business devuelve los hashtags populares, sus videos en tendencia y las palabras de búsqueda en tendencia. La Display API lee el perfil y los videos propios de un usuario autorizado.
easyCoexistence conecta cuentas de TikTok mediante la API for Business de TikTok, para que Claude, ChatGPT o tu propia plataforma listen las publicaciones y comentarios de la cuenta y lean sus métricas, y get_social_credentials entrega a tu propio código el token para rutas business/ como las sugerencias de hashtags, con cada conexión vigilada las 24 horas.
Peticiones a la Research API permitidas por día, para hasta 100,000 registros, con la cuota reiniciándose a las 12 AM UTC.
Lapso más largo entre start_date y end_date en una sola consulta de video de la Research API, que devuelve hasta 100 videos por petición.
/discovery/trending_list/ clasifica los hashtags populares de un país y una categoría en los últimos 1, 7, 30 o 120 días.
/discovery/trending/search/ devuelve las palabras de búsqueda en tendencia para cuentas con Advanced Access o una Verified Business Account.
Longitud máxima de search_term que acepta la Commercial Content API, comparado como frase exacta por defecto o como frase aproximada.
¿Qué API de TikTok puede buscar?
Varias, en dos portales para desarrolladores, cada uno pensado para un tipo distinto de desarrollador. developers.tiktok.com aloja la Research API, la Commercial Content API y la Display API; business-api.tiktok.com aloja la API for Business, cuyos endpoints Discovery, Accounts y Mentions cubren las tendencias y el contenido propio de una empresa:
¿Cómo busca videos la Research API?
Con POST https://open.tiktokapis.com/v2/research/video/query/ y un access token de cliente que tenga el scope research.data.basic. El objeto query combina condiciones and, or y not, cada una una operación como EQ o IN sobre un campo como keyword, hashtag_name, username, region_code, create_date o video_length. start_date y end_date, escritos como YYYYMMDD, pueden estar separados por como máximo 30 días, y max_count devuelve hasta 100 videos por petición:
curl -X POST 'https://open.tiktokapis.com/v2/research/video/query/?fields=id,video_description,create_time' \
-H 'Authorization: Bearer <CLIENT_ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"query": {
"and": [
{ "operation": "IN", "field_name": "region_code", "field_values": ["JP", "US"] },
{ "operation": "EQ", "field_name": "hashtag_name", "field_values": ["animal"] }
],
"not": [
{ "operation": "EQ", "field_name": "video_length", "field_values": ["SHORT"] }
]
},
"max_count": 100,
"start_date": "20261001",
"end_date": "20261030"
}'¿Qué devuelve la Research API y qué tan actualizada está?
Los campos de video públicos nombrados en fields, como id, video_description, create_time, region_code, view_count, like_count, comment_count, share_count, hashtag_names y username. La FAQ de TikTok advierte que estadísticas como las de visualizaciones y seguidores pueden tardar hasta 10 días en actualizarse, y que los videos nuevos pueden tardar hasta 48 horas en aparecer en la búsqueda. La cuota diaria es de 1,000 peticiones, hasta 100,000 registros entre las APIs de investigación, y se reinicia a las 12 AM UTC.
¿Quién puede usar la Research API?
Los investigadores cuyo proyecto TikTok aprueba; una cuenta de desarrollador por sí sola no otorga acceso. TikTok enumera a instituciones académicas de EE. UU., el EEE, el Reino Unido, Canadá o Suiza, a organismos de investigación sin fines de lucro o independientes de la UE, y a organizaciones académicas o sin fines de lucro de Brasil que estudian la seguridad de los jóvenes en línea. Los solicitantes deben trabajar de forma independiente de intereses comerciales, con una propuesta de investigación definida, financiación divulgada y una revisión ética, y TikTok suele responder en un plazo de 4 semanas. Consultada sobre si los creadores, anunciantes y usuarios comerciales son elegibles, su FAQ responde que no.
¿Cómo se buscan anuncios con la Commercial Content API?
Con POST https://open.tiktokapis.com/v2/research/adlib/ad/query/ y el scope research.adlib.basic. search_term acepta hasta 50 caracteres, comparados como exact_phrase por defecto o como fuzzy_phrase, que encuentra cualquiera o todas sus palabras en cualquier orden; los filtros acotan los resultados por fechas de publicación y países objetivo, y cada llamada devuelve como máximo 10 anuncios. La página de producto de TikTok dice que los datos empiezan con anuncios de la UE y permanecen disponibles hasta un año después de que un anuncio se mostró por última vez. El público y los investigadores de cualquier país pueden solicitar acceso mediante un formulario en línea, y TikTok espera responder en un plazo de 2 días hábiles.
¿Qué tendencias devuelve la API for Business?
Las de sus endpoints Discovery, que varían según el token que reciben. /discovery/trending_list/ clasifica hasta 200 hashtags populares de un país, EE. UU. por defecto, y una categoría de industria, en los últimos 1, 7, 30 o 120 días, con el ranking, las visualizaciones y las publicaciones de cada hashtag; /discovery/video_list/ devuelve los 20 videos en tendencia principales de hasta 10 de esos hashtags. Ambos reciben un advertiser_id y un access token de anunciante. Otros dos reciben el token de una cuenta de TikTok con el scope discovery.search.words, para cuentas con Advanced Access o una Verified Business Account:
- /discovery/trending/search/: 20 palabras de búsqueda en tendencia en TikTok, o personalizadas para la cuenta con
is_personalized. - /discovery/trending/search/keyword/: 20 palabras de búsqueda recomendadas para una consulta de hasta 255 caracteres, como un producto o una marca.
¿Qué puede buscar la API propia de una cuenta de TikTok?
Hashtags para sus descripciones, y publicaciones que llevan sus hashtags de marca. GET /business/hashtag/suggestion/ recibe una palabra clave y un idioma opcional, y devuelve 10 hashtags, ordenados por coincidencia exacta y luego por número de publicaciones, cada uno con su post_count. El endpoint de menciones /business/mention/hashtag/video/list/ devuelve hasta 1,000 publicaciones públicas de los últimos 90 días que usan uno de los hashtags de marca que activó la empresa, hasta 50 de ellas, ordenadas por fecha, me gusta, comentarios o compartidos. Necesita el scope biz.brand.insights y una cuenta con Advanced Access o una Verified Business Account.
¿Puede la Display API buscar?
No. Lee el usuario que autorizó la app: /v2/user/info/ devuelve el perfil de ese usuario, /v2/video/list/ sus videos públicos, del más reciente al más antiguo y hasta 20 por página, y /v2/video/query/ videos concretos por ID, bajo los scopes user.info.basic y video.list. Ninguno de sus endpoints acepta una palabra clave ni un hashtag.
¿Qué puede buscar easyCoexistence en TikTok?
Lo que responde la API propia de la cuenta conectada. list_social_posts lista las publicaciones recientes de la cuenta y list_social_comments los comentarios de una publicación, mientras que tu propio código llama a rutas de la API for Business bajo business/ con el token de get_social_credentials, incluidas las sugerencias de hashtags. Las rutas /discovery/ piden el token de un anunciante, así que el token de la cuenta no las alcanza, y la Research API y la Commercial Content API son productos separados de developers.tiktok.com con solicitudes propias.
GET https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/
?business_id=<BUSINESS_ID>&keyword=cold%20brew&language=en
Access-Token: <ACCESS_TOKEN>Errores comunes
- Solicitar la Research API para hacer seguimiento de una marca. La FAQ de TikTok responde que no a creadores, anunciantes y usuarios comerciales, y aprueba proyectos de investigación no comerciales.
- Consultar un periodo largo en una sola llamada a la Research API. end_date puede estar como máximo 30 días después de start_date, así que divide los periodos más largos en ventanas.
- Leer las sugerencias de hashtags como tendencias. /business/hashtag/suggestion/ ordena por coincidencia exacta y número de publicaciones, mientras que /discovery/trending_list/ clasifica la popularidad en un periodo elegido.
- Llamar a los endpoints de búsqueda en tendencia desde una cuenta personal. Responden para cuentas con Advanced Access o una Verified Business Account, con discovery.search.words en el token.
De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Puedo buscar videos de TikTok por palabra clave mediante la API?
Con la Research API, una vez que TikTok apruebe tu proyecto de investigación: su consulta de video acepta condiciones keyword y hashtag_name sobre videos públicos, hasta 100 por petición.
¿Existe una API de TikTok para hashtags en tendencia?
Sí. /discovery/trending_list/ de la API for Business clasifica hasta 200 hashtags populares de un país y una categoría, cada uno con sus visualizaciones y publicaciones, para el token de un anunciante.
¿Existe una API de TikTok para videos en tendencia?
Sí. /discovery/video_list/ de la API for Business devuelve los 20 videos en tendencia principales de hasta 10 hashtags populares, con un advertiser_id y un access token de anunciante.
¿Puede la API de TikTok encontrar comentarios que mencionen mi cuenta?
Sí, para cuentas con Advanced Access o una Verified Business Account: /business/mention/comment/list/ de la Mentions API devuelve hasta 1,000 comentarios o respuestas que mencionan con @ a la cuenta, bajo los scopes biz.brand.insights y comment.list.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el