Поиск по хэштегам

Поиск общедоступных объектов IG Media, отмеченных определенными хэштегами.

Ограничения

• В течение каждых семи дней от лица аккаунта Instagram Business или аккаунта автора можно запрашивать не более 30 уникальных хэштегов. После запроса хэштег учитывается в ограничении в течение семи дней. Последующие запросы этого же хэштега не будут учитываться в ограничении и не изменяют начальную точку отсчета 7 дней с момента первого запроса этого хэштега.
• Оставлять комментарии к медиаобъектам с хэштегами, полученным с помощью этого API, нельзя.
• Хэштеги историй не поддерживаются.
• В запросах по хэштегам смайлики не поддерживаются.
• Если в запросе есть хэштеги, которые мы считаем конфиденциальными или оскорбительными, API вернет стандартную ошибку.

Требования

Прежде чем использовать этот API, необходимо пройти проверку приложения и запросить подтверждение для использования:

• функции Instagram Public Content Access;
• разрешения instagram_basic.

Конечные точки

API Hashtag Search включает в себя следующие узлы и границы контекста:

• GET /ig_hashtag_search — получает ID узла конкретного хэштега;
• GET /{ig-hashtag-id} — собирает данные о хэштеге;
• GET /{ig-hashtag-id}/top_media — получает самые популярные фото и видео, отмеченные конкретным хэштегом;
• GET /{ig-hashtag-id}/recent_media — получает самые свежие фото и видео, отмеченные конкретным хэштегом;
• GET /{ig-user-id}/recently_searched_hashtags — находит уникальные хэштеги, по которым на этой неделе выполнялся поиск из аккаунта Instagram Business или аккаунта автора.

Информацию о необходимых разрешениях, доступных полях и параметрах, а также требованиях к использованию конечной точки см. в соответствующей документации.

Стандартное использование

Получение медиафайлов, отмеченных хэштегом

Чтобы получить все фото и видео, отмеченные определенным хэштегом, воспользуйтесь конечной точкой /ig_hashtag_search и укажите хэштег и ID аккаунта Instagram Business или аккаунта автора, от лица которого выполняется запрос. Например, если запрос выполняется от лица аккаунта Instagram Business с ID 17841405309211844, получить ID хэштега #coke можно следующим образом:

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

При этом будет возвращен ID узла хэштега #Coke:

{
  "id" : "17873440459141021"
}

Получив ID хэштега (17873440459141021), запросите его границу контекста /top_media или /recent_media и укажите ID бизнес-аккаунта, чтобы получить подборку медиаобъектов, отмеченных хэштегом #coke. Пример:

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

Ответ будет выглядеть так:

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