API de busca de hashtags do Instagram: como encontrar posts por hashtag
A busca por hashtag do Instagram encontra fotos e vídeos públicos com uma hashtag, em duas chamadas. GET /ig_hashtag_search com user_id e q retorna o ID da hashtag. Depois, GET /<HASHTAG_ID>/top_media lista os posts mais populares, e /recent_media, os publicados nas últimas 24 horas. Uma conta pode consultar 30 hashtags únicas em uma janela móvel de 7 dias, com Facebook Login ou Unified Login.
O easyCoexistence conecta o Instagram com Instagram Login, para que Claude, ChatGPT ou seu próprio código trabalhem com as publicações, comentários, menções e insights da conta por meio da API oficial da Meta, e seus comentários e menções podem ser encaminhados ao seu endpoint conforme chegam.
Hashtags únicas que uma conta de empresa ou criador pode consultar em um período móvel de 7 dias.
recent_media retorna apenas mídias publicadas até 24 horas antes da consulta.
O maior número de resultados por página vem de top_media, que pagina somente com um cursor after.
Busca por hashtag com a API do Instagram via Instagram Login, na comparação das três configurações feita pela Meta.
Os IDs de hashtag são estáticos e globais: uma hashtag mantém o mesmo ID para cada app e usuário.
Como funciona a busca por hashtag?
Em duas etapas, feitas em nome de uma conta de empresa ou criador do Instagram cujo ID vai em user_id. GET /ig_hashtag_search com q definido como o nome da hashtag retorna o ID dela, que a Meta diz ser estático e global, por isso pode ser armazenado. Depois, GET /<HASHTAG_ID>/top_media ou /recent_media, com user_id e fields, lista os posts.
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_countQual é a diferença entre top_media e recent_media?
top_media retorna as fotos e vídeos mais populares marcados com a hashtag, onde a Meta mede a popularidade por uma combinação de visualizações e interação dos espectadores. recent_media retorna os publicados mais recentemente, limitados a mídias publicadas até 24 horas antes da consulta, e a Meta observa que suas respostas nem sempre estão em ordem cronológica. Os dois retornam somente mídias públicas, deixam de fora mídias impulsionadas, promovidas e de anúncios, e paginam os resultados 50 por vez com um cursor after.
Quais campos voltam?
Os campos de mídia que as referências da Meta listam para as duas arestas, que retornam somente fotos e vídeos públicos:
- id,
media_type(CAROUSEL_ALBUM, IMAGE ou VIDEO), permalink e timestamp. - caption e
comments_count, além delike_count, a menos que o dono tenha ocultado as curtidas. - children para mídias de álbum e
media_urlpara as demais, mas não para vídeos com áudio protegido por direitos autorais ou licenciado. - Não username: a Meta não permite esse campo em mídias retornadas pela busca por hashtag.
Quais são os limites?
A Meta os define por conta e por hashtag:
- 30 hashtags únicas em uma janela móvel de 7 dias. Uma hashtag conta a partir da primeira consulta; consultá-la novamente nesse período é gratuito e não reinicia seus 7 dias.
- Buscar
top_mediaourecent_mediaconta como consultar a hashtag, mesmo quando o ID já está armazenado. - GET /<
IG_ID>/recently_searched_hashtagslista as hashtags únicas que a conta pesquisou na semana atual. - Hashtags em Stories e emojis nas consultas não são suportados, e hashtags que a Meta considera sensíveis ou ofensivas retornam um erro genérico.
- Mídias encontradas dessa forma não podem receber comentários pela API.
O que a busca por hashtag exige?
A aprovação do App Review para o recurso Instagram Public Content Access e a permissão instagram_basic, que a Meta exige antes que um app possa usá-la, e um token de acesso de usuário do Facebook Login de uma pessoa que possa executar tarefas na Página vinculada, ou um token do Unified Login. A visão geral da Meta lista a busca por hashtag como não suportada com Instagram Login, e suas chamadas seguem os limites de taxa da Plataforma da Meta, e não o orçamento de chamadas por conta do Instagram. Os usos permitidos listados pela Meta incluem encontrar conteúdo de suas campanhas de hashtag, entender a opinião pública sobre sua marca e identificar participantes de concursos.
Dá para pesquisar hashtags pelo easyCoexistence?
O easyCoexistence conecta o Instagram com Instagram Login, que alcança as próprias publicações, comentários, menções e insights da conta conectada. A Meta oferece busca por hashtag somente com Facebook Login e Unified Login, então ela fica fora desta conexão. O que a conexão cobre no lugar disso: as publicações da própria conta por meio de list_social_posts, e seus comentários e menções, encaminhados para o seu endpoint conforme chegam.
Erros comuns
- Gastar a cota semanal em testes. Cada nova hashtag conta para as 30 de 7 dias, e buscar a mídia dela conta mesmo com um ID armazenado.
- Pedir username nos resultados de hashtag. A Meta não o retorna para mídias encontradas pela busca por hashtag.
- Tratar recent_media como um arquivo. Ele cobre mídias publicadas nas 24 horas antes da consulta, e não em ordem cronológica estrita.
- Chamar com um token do Instagram Login. A Meta marca a busca por hashtag como não suportada nessa configuração.
De US$ 9 até US$ 0.75 por número conectado por mês, caindo conforme você adiciona números conectados, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
A API do Instagram consegue pesquisar hashtags sem App Review?
Não. A Meta exige a aprovação do App Review para o recurso Instagram Public Content Access e para instagram_basic antes que um app possa chamar a busca por hashtag.
Dá para ver quem postou com uma hashtag?
Não pelo username, que a Meta deixa de fora dos resultados de hashtag. O permalink de cada post abre a publicação no Instagram.
A busca por hashtag inclui Stories?
Não. A Meta não oferece suporte a hashtags em Stories, e as duas arestas retornam somente fotos e vídeos públicos.
Consultar a mesma hashtag de novo conta duas vezes?
Não. Consultas repetidas dentro dos seus 7 dias não contam para as 30 e não reiniciam o cronômetro da hashtag.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em