특정 해시태그로 태그된 전체 공개 IG 미디어를 검색합니다.
해시태그 검색 API는 다음과 같은 노드 및 에지로 구성됩니다.
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 비즈니스 또는 크리에이터 계정이 이번 주에 검색한 고유한 해시태그 확인지원되는 필드, 매개변수 및 사용 요구 사항에 대한 내용은 각 엔드포인트 참고 자료 문서를 참조하세요.
특정 해시태그가 있는 모든 사진과 동영상을 가져오려면 먼저 /ig_hashtag_search
엔드포인트를 사용하고 쿼리를 보내는 Instagram 비즈니스 또는 크리에이터 계정의 ID와 해당 해시태그를 포함합니다. 예를 들어 17841405309211844
라는 ID로 Instagram 비즈니스 계정을 대신하여 쿼리를 보낼 경우 다음 쿼리를 수행하여 "#coke" 해시태그에 대한 ID를 가져올 수 있습니다.
GET graph.facebook.com/ig_hashtag_search ?user_id=17841405309211844 &q=coke
"#Coke" 해시태그 노드에 대한 ID가 반환됩니다.
{ "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" } ] }