Búsqueda de hashtags

Encuentra contenido multimedia de IG público que se haya etiquetado con hashtags específicos.

Limitaciones

• Puedes solicitar como máximo 30 hashtags únicos en representación de una cuenta de empresa o creador de Instagram dentro de un plazo de 7 días. Cuando consultes un hashtag, se descontará de este límite durante 7 días. Las consultas posteriores en relación con el mismo hashtag dentro de este plazo no se descontarán de tu límite; tampoco reiniciarán el temporizador inicial de 7 días para consultas.
• No puedes hacer comentarios sobre objetos multimedia con hashtags que se descubran a través de la API.
• No se admiten los hashtags de Historias.
• No se admiten los emojis en las consultas de hashtags.
• La API devolverá un error genérico si recibe una solicitud que incluya hashtags que consideremos delicados u ofensivos.

Requisitos

Para usar esta API, debes realizar la revisión de apps y solicitar aprobación para lo siguiente:

• la función Instagram Public Content Access;
• el permiso instagram_basic.

Puntos de conexión

La API de búsqueda de hashtags tiene los siguientes nodos y perímetros:

• GET /ig_hashtag_search: para obtener el identificador del nodo de un hashtag específico
• GET /{ig-hashtag-id}: para obtener datos sobre un hashtag
• GET /{ig-hashtag-id}/top_media: para obtener las fotos y los videos más populares que tengan un hashtag específico
• GET /{ig-hashtag-id}/recent_media: para obtener las fotos y los videos que se hayan publicado más recientemente y tengan un hashtag específico
• GET /{ig-user-id}/recently_searched_hashtags: para determinar los hashtags únicos que haya buscado una cuenta de empresa o creador de Instagram en la semana en curso

Consulta la documentación de referencia de cada punto de conexión para conocer los campos compatibles, los parámetros y los requisitos de uso.

Usos habituales

Obtener contenido multimedia etiquetado con un hashtag

Para obtener las fotos y los videos que tengan un hashtag específico, primero usa el punto de conexión /ig_hashtag_search e incluye el hashtag y el identificador de la cuenta de empresa o creador de Instagram que realice la consulta. Por ejemplo, si la consulta se realiza en representación de la cuenta de Instagram para empresas con el identificador 17841405309211844, podrías obtener el identificador del hashtag "#coke" con la siguiente consulta:

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

Con esto, se devolverá el identificador del nodo de hashtag "#coke":

{
  "id" : "17873440459141021"
}

Ahora, que cuentas con el identificador de hashtag (17873440459141021), puedes consultar su perímetro /top_media o /recent_media e incluir el identificador de la cuenta de empresa para obtener una colección de objetos multimedia con el hashtag "#coke". Por ejemplo:

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

Se devolverá una respuesta similar a esta:

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