Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

API de pesquisa de hashtags do Instagram: encontrar publicações por hashtag

A pesquisa de hashtags do Instagram encontra fotografias e vídeos públicos que têm uma hashtag, em duas chamadas. GET /ig_hashtag_search com user_id e q devolve o ID da hashtag e, em seguida, GET /<HASHTAG_ID>/top_media lista as publicações mais populares e /recent_media as publicadas nas últimas 24 horas. Uma conta pode consultar 30 hashtags únicas num período contínuo de 7 dias, com o Facebook Login ou o Unified Login.

O easyCoexistence liga o Instagram com o Instagram Login, para que o Claude, o ChatGPT ou o seu próprio código trabalhem com as publicações, comentários, menções e estatísticas da conta através da API oficial da Meta, e os seus comentários e menções podem ser reencaminhados para o seu endpoint à medida que chegam.

30

Hashtags únicas que uma conta empresarial ou de criador pode consultar num período contínuo de 7 dias.

24 hours

recent_media devolve apenas os conteúdos publicados nas 24 horas que antecedem a consulta.

50

Máximo de resultados por página em top_media, que só pagina com um after cursor.

Not supported

A pesquisa de hashtags com a API do Instagram com Instagram Login, nas três modalidades comparadas pela Meta.

Static

Os IDs de hashtag são estáticos e globais: uma hashtag mantém o mesmo ID para cada aplicação e utilizador.

Como funciona a pesquisa de hashtags?

Em dois passos, feitos em nome de uma conta empresarial ou de criador do Instagram cujo ID é indicado em user_id. GET /ig_hashtag_search com q definido com o nome da hashtag devolve o seu ID, que a Meta indica ser estático e global, por isso pode ser guardado. GET /<HASHTAG_ID>/top_media ou /recent_media, com user_id e fields, lista depois as publicações.

Finding a hashtag's ID, then its recent 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_count

Qual é a diferença entre top_media e recent_media?

top_media devolve as fotografias e os vídeos mais populares com a hashtag, sendo a popularidade medida pela Meta com base numa combinação de visualizações e interação dos utilizadores. recent_media devolve os conteúdos publicados mais recentemente, limitados aos publicados nas 24 horas anteriores à consulta, e a Meta indica que as respostas nem sempre seguem a ordem cronológica. Ambos devolvem apenas conteúdos públicos, excluem os conteúdos promovidos e os de anúncios, e paginam os resultados 50 de cada vez com um after cursor.

Que campos são devolvidos?

Os campos de conteúdo que as referências da Meta indicam para os dois edges, que devolvem apenas fotografias e vídeos públicos:

  • id, media_type (CAROUSEL_ALBUM, IMAGE ou VIDEO), permalink e timestamp.
  • caption e comments_count, além de like_count, a menos que o proprietário tenha ocultado as contagens de gostos.
  • children para conteúdos de álbum, e media_url para os restantes, mas não para vídeos com áudio protegido por direitos de autor ou licenciado.
  • Não username: a Meta não o permite em conteúdos devolvidos pela pesquisa de hashtags.

Quais são os limites?

A Meta define-os por conta e por hashtag:

  • 30 hashtags únicas em 7 dias contínuos. Uma hashtag conta a partir da primeira consulta; voltar a consultá-la nesse período não conta para o limite e não reinicia os seus 7 dias.
  • A obtenção de top_media ou recent_media conta como consulta da hashtag, mesmo quando o seu ID já está guardado.
  • GET /<IG_ID>/recently_searched_hashtags lista as hashtags únicas que a conta pesquisou na semana corrente.
  • Não são suportadas hashtags em Stories nem emojis nas consultas, e as hashtags que a Meta considere sensíveis ou ofensivas devolvem um erro genérico.
  • As publicações encontradas desta forma não podem ser comentadas através da API.

O que é necessário para a pesquisa de hashtags?

Aprovação do App Review para a funcionalidade Instagram Public Content Access e para a permissão instagram_basic, que a Meta exige antes de uma aplicação a poder usar, e um token de acesso de utilizador do Facebook Login, para uma pessoa que possa executar tarefas na Página associada, ou um token do Unified Login. A visão geral da Meta indica que a pesquisa de hashtags não é suportada com o Instagram Login, e as suas chamadas estão sujeitas aos limites de taxa da Plataforma da Meta e não ao orçamento de chamadas por conta do Instagram. As utilizações permitidas que a Meta indica incluem encontrar conteúdos das suas campanhas de hashtags, perceber a opinião pública sobre a sua marca e identificar participantes em concursos.

É possível pesquisar hashtags através do easyCoexistence?

O easyCoexistence liga o Instagram com o Instagram Login, que dá acesso às publicações, comentários, menções e estatísticas da própria conta ligada. A Meta oferece a pesquisa de hashtags apenas com o Facebook Login e o Unified Login, por isso está fora desta ligação. O que a ligação cobre em vez disso: as publicações da própria conta através de list_social_posts, e os seus comentários e menções, reencaminhados para o seu endpoint à medida que chegam.

Erros comuns

  • Gastar a quota semanal em testes. Cada nova hashtag conta para as 30 em 7 dias, e obter os seus conteúdos conta mesmo com um ID já guardado.
  • Pedir username nos resultados de hashtags. A Meta não o devolve para conteúdos encontrados pela pesquisa de hashtags.
  • Ler recent_media como um arquivo. Cobre os conteúdos publicados nas 24 horas anteriores à consulta, e não por ordem cronológica estrita.
  • Chamar a API com um token do Instagram Login. A Meta indica que a pesquisa de hashtags não é suportada nessa modalidade.
Fazer isto com a EasyCoexistence

De US$ 9 a US$ 0,75 por ligação por mês, a descer à medida que acrescenta ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

A API do Instagram pode pesquisar hashtags sem App Review?

Não. A Meta exige a aprovação do App Review para a funcionalidade Instagram Public Content Access e para o instagram_basic antes de uma aplicação poder chamar a pesquisa de hashtags.

Posso ver quem publicou com uma hashtag?

Não pelo username, que a Meta deixa de fora dos resultados de hashtags. O permalink de cada publicação abre-a no Instagram.

A pesquisa de hashtags inclui os Stories?

Não. A Meta não suporta hashtags em Stories, e os dois edges devolvem apenas fotografias e vídeos públicos.

Consultar de novo a mesma hashtag conta duas vezes?

Não. As consultas repetidas dentro dos seus 7 dias não contam para as 30 e não reiniciam o temporizador da hashtag.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em