Pesquisa de hashtag

Encontre mídias do Instagram públicas marcadas com hashtags específicas.

Limitações

• É possível consultar um máximo de 30 hashtags únicas em nome de uma conta comercial ou de criador de conteúdo do Instagram dentro de um período de 7 dias consecutivos. Após consultar uma hashtag, ela será contabilizada no limite máximo por 7 dias. Consultas posteriores na mesma hashtag nesse intervalo de tempo não serão contabilizadas no limite e não redefinirão o temporizador inicial de consulta de 7 dias.
• Não é possível comentar em objetos de mídia com hashtags descobertos por meio da API.
• Não há suporte para hashtags em Stories.
• Não há suporte para emojis nas consultas de hashtag.
• A API retornará um erro genérico para solicitações que incluírem hashtags consideradas sensíveis ou ofensivas.

Requisitos

Para usar esta API, é necessário passar pela análise do app e solicitar aprovação para:

• o recurso Instagram Public Content Access
• a permissão instagram_basic

Pontos de extremidade

A API de Pesquisa de Hashtag consiste nos nós e nas bordas a seguir:

• GET /ig_hashtag_search, para obter o ID do nó de uma hashtag específica
• GET /{ig-hashtag-id}, para obter dados sobre uma hashtag
• GET /{ig-hashtag-id}/top_media, para obter as fotos e os vídeos mais populares com uma hashtag específica
• GET /{ig-hashtag-id}/recent_media, para obter as fotos e os vídeos mais recentes publicados com uma hashtag específica
• GET /{ig-user-id}/recently_searched_hashtags, para determinar as hashtags únicas pesquisadas por uma conta comercial ou de criador de conteúdo do Instagram na semana atual

Consulte a documentação de referência de cada ponto de extremidade para ver requisitos de campos, parâmetros e usos suportados.

Usos comuns

Como obter mídias marcadas com uma hashtag

Para obter as fotos e os vídeos com uma hashtag específica, use primeiro o ponto de extremidade /ig_hashtag_search e inclua a hashtag e o ID da conta comercial ou de criador de conteúdo do Instagram que está fazendo a consulta. Por exemplo, se a consulta for feita em nome de uma conta comercial do Instagram com o ID 17841405309211844, será possível obter o ID da hashtag "#coke" por meio da consulta a seguir:

GET graph.facebook.com/ig_hashtag_search
  ?user_id=17841405309211844
  &q=coke

Isso retornará o ID do nó da hashtag "#Coke":

{
  "id" : "17873440459141021"
}

Após obter o ID da hashtag (17873440459141021), será possível consultar a borda /top_media ou /recent_media e incluir a identificação da conta comercial para obter uma coleção de objetos de mídia com a hashtag "#coke". Por exemplo:

GET graph.facebook.com/17873440459141021/recent_media
  ?user_id=17841405309211844

Isso retornará uma resposta semelhante a esta:

{
  "data": [
    {
      "id": "17880997618081620"
    },
    {
      "id": "17871527143187462"
    },
    {       
      "id": "17896450804038745"     
    }
  ]
}