Búsqueda de hashtags

Puedes buscar contenido multimedia de Instagram etiquetado con hashtags concretos.

Limitaciones

• Puedes consultar un máximo de 30 hashtags únicos en nombre de una cuenta empresarial o de creador de Instagram en un período continuo de 7 días. De este modo, la consulta de un hashtag contará para este límite durante 7 días. No obstante, las consultas subsiguientes del mismo hashtag dentro de este periodo no se contarán para el límite y no restablecerán el temporizador de siete días de la consulta inicial.
• No se pueden comentar los objetos de contenido multimedia con hashtags detectados mediante la API.
• No se admiten los hashtags en Stories.
• No se admiten los emojis en las consultas de hashtags.
• La API devolverá un error genérico para todas las solicitudes que incluyan hashtags que hayamos considerado confidenciales u ofensivos.

Requisitos

Para utilizar esta API, debes superar la revisión de la aplicación y solicitar aprobación para lo siguiente:

• La función Instagram Public Content Access
• El permiso instagram_basic

Extremos

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

• GET /ig_hashtag_search: para obtener un identificador de nodo de hashtag específico.
• GET /{ig-hashtag-id}: para obtener datos acerca de un hashtag.
• GET /{ig-hashtag-id}/top_media: para obtener las fotos y los vídeos más populares con un hashtag concreto.
• GET /{ig-hashtag-id}/recent_media: para obtener las fotos y los vídeos publicados más recientemente con un hashtag concreto.
• GET /{ig-user-id}/recently_searched_hashtags: para determinar los hashtags únicos que ha buscado una cuenta empresarial o de creador de Instagram en la semana actual.

Consulta en la documentación de referencia de cada extremo los campos y parámetros admitidos y los requisitos de uso.

Usos habituales

Etiquetado de contenido multimedia con un hashtag

Para obtener todas las fotos y los vídeos que tienen un hashtag específico, primero utiliza el extremo /ig_hashtag_search e incluye el hashtag y el identificador de la cuenta empresarial o de creador que realiza la consulta. Por ejemplo, si la consulta se hace en nombre de la cuenta empresarial de Instagram con el identificador 17841405309211844, puedes realizar la consulta siguiente para obtener el identificador del hashtag “#coke”:

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

Esto devolverá el identificador del nodo del hashtag “#Coke”:

{
  "id" : "17873440459141021"
}

Ahora que tienes el identificador del hashtag (17873440459141021), puedes consultar el perímetro /top_media o /recent_media e incluir el identificador de la cuenta empresarial para obtener una colección de los objetos multimedia con el hashtag “#coke”. Por ejemplo:

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

Esto devolvería una respuesta similar a la siguiente:

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