API de búsqueda por hashtag de Instagram: encontrar publicaciones por hashtag
La búsqueda por hashtag de Instagram encuentra fotos y videos públicos que llevan un hashtag, en dos llamadas. GET /ig_hashtag_search con user_id y q devuelve el ID del hashtag, y luego GET /<HASHTAG_ID>/top_media enumera las publicaciones más populares y /recent_media las publicadas en las últimas 24 horas. Una cuenta puede consultar 30 hashtags únicos en una ventana móvil de 7 días, con Facebook Login o Unified Login.
easyCoexistence conecta Instagram con Instagram Login, para que Claude, ChatGPT o tu propio código trabajen con las publicaciones, comentarios, menciones y métricas de la cuenta a través de la API oficial de Meta, y sus comentarios y menciones pueden reenviarse a tu endpoint a medida que llegan.
Hashtags únicos que una cuenta de empresa o de creador puede consultar en un periodo móvil de 7 días.
recent_media devuelve solo las publicaciones realizadas dentro de las 24 horas previas a la consulta.
Máximo de resultados por página en top_media, que solo pagina con un cursor after.
Búsqueda por hashtag con la API de Instagram y Instagram Login, según la comparación de Meta entre las tres configuraciones.
Los ID de hashtag son estáticos y globales: un hashtag conserva el mismo ID para cada app y usuario.
¿Cómo funciona la búsqueda por hashtag?
En dos pasos, realizados en nombre de una cuenta de empresa o de creador de Instagram cuyo ID va en user_id. GET /ig_hashtag_search con q configurado con el nombre del hashtag devuelve su ID, que Meta indica que es estático y global, así que puede almacenarse. GET /<HASHTAG_ID>/top_media o /recent_media, con user_id y fields, enumera luego las publicaciones.
GET /ig_hashtag_search?user_id=<IG_ID>&q=coffee
{ "data": [ { "id": "<HASHTAG_ID>" } ] }
GET /<HASHTAG_ID>/recent_media
?user_id=<IG_ID>
&fields=id,media_type,permalink,timestamp,like_count,comments_count¿Cuál es la diferencia entre top_media y recent_media?
top_media devuelve las fotos y videos más populares etiquetados con el hashtag, donde Meta determina la popularidad con una combinación de visualizaciones e interacción de los espectadores. recent_media devuelve los más recientes, limitados a los publicados dentro de las 24 horas previas a la consulta, y Meta señala que sus respuestas no siempre están en orden cronológico. Ambos devuelven solo contenido público, excluyen el contenido promocionado, impulsado y de anuncios, y paginan los resultados de 50 en 50 con un cursor after.
¿Qué campos se devuelven?
Los campos de contenido multimedia que las referencias de Meta listan para ambos edges, que devuelven solo fotos y videos públicos:
- id,
media_type(CAROUSEL_ALBUM, IMAGE o VIDEO), permalink y timestamp. - caption y
comments_count, además delike_countsalvo que el titular haya ocultado los recuentos de me gusta. - children para contenido de álbum, y
media_urlpara otro contenido, aunque no para videos con audio protegido por derechos de autor o licenciado. - Sin username: Meta no lo permite en el contenido devuelto por la búsqueda por hashtag.
¿Cuáles son los límites?
Meta los define por cuenta y por hashtag:
- 30 hashtags únicos en 7 días móviles. Un hashtag cuenta desde su primera consulta; volver a consultarlo en ese plazo no cuesta nada y no reinicia sus 7 días.
- Obtener
top_mediaorecent_mediacuenta como consultar el hashtag, incluso cuando su ID ya está almacenado. - GET /<
IG_ID>/recently_searched_hashtagsenumera los hashtags únicos que la cuenta ha buscado en la semana en curso. - Los hashtags en Stories y los emojis en las consultas no son compatibles, y los hashtags que Meta considera sensibles u ofensivos devuelven un error genérico.
- El contenido multimedia encontrado de esta forma no puede comentarse a través de la API.
¿Qué necesita la búsqueda por hashtag?
La aprobación de App Review para la función Instagram Public Content Access y el permiso instagram_basic, que Meta exige antes de que una app pueda usarla, y un token de acceso de usuario de Facebook Login para una persona que pueda realizar tareas en la Página vinculada, o un token de Unified Login. La visión general de Meta indica que la búsqueda por hashtag no es compatible con Instagram Login, y sus llamadas se rigen por los límites de tasa de la Plataforma de Meta y no por el presupuesto de llamadas por cuenta de Instagram. Los usos permitidos que enumera Meta incluyen encontrar contenido de tus campañas de hashtags, entender el sentimiento público sobre tu marca e identificar a los participantes de concursos.
¿Puedes buscar hashtags a través de easyCoexistence?
easyCoexistence conecta Instagram con Instagram Login, que accede a las propias publicaciones, comentarios, menciones y métricas de la cuenta conectada. Meta ofrece la búsqueda por hashtag solo con Facebook Login y Unified Login, así que queda fuera de esta conexión. Lo que la conexión cubre en su lugar: las publicaciones propias de la cuenta a través de list_social_posts, y sus comentarios y menciones, reenviados a tu endpoint a medida que llegan.
Errores comunes
- Gastar la cuota semanal en pruebas. Cada hashtag nuevo cuenta para los 30 en 7 días, y obtener su contenido cuenta aunque el ID esté almacenado.
- Pedir username en los resultados de hashtags. Meta no lo devuelve para contenido encontrado mediante la búsqueda por hashtag.
- Leer recent_media como un archivo. Cubre el contenido publicado en las 24 horas previas a la consulta, y no en estricto orden cronológico.
- Llamar a la función con un token de Instagram Login. Meta marca la búsqueda por hashtag como no compatible en esa configuración.
De US$ 9 a US$ 0.75 por conexión al mes, bajando conforme agregas conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿La API de Instagram puede buscar hashtags sin App Review?
No. Meta exige la aprobación de App Review para la función Instagram Public Content Access e instagram_basic antes de que una app pueda llamar a la búsqueda por hashtag.
¿Puedo ver quién publicó con un hashtag?
No por nombre de usuario, que Meta omite en los resultados de hashtags. El permalink de cada publicación la abre en Instagram.
¿La búsqueda por hashtag incluye Stories?
No. Meta no admite hashtags en Stories, y ambos edges devuelven solo fotos y videos públicos.
¿Consultar de nuevo el mismo hashtag cuenta dos veces?
No. Las consultas repetidas dentro de sus 7 días no cuentan contra los 30 y no reinician el temporizador del hashtag.
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