해시태그 검색

특정 해시태그로 태그된 전체 공개 IG 미디어를 검색합니다.

제한 사항

연속 7일 동안 Instagram 비즈니스 또는 크리에이터 계정 대신 최대 30개의 고유한 해시태그를 쿼리할 수 있습니다. 해시태그를 쿼리하면 7일간의 해당 제한에 대해 카운트됩니다. 이 기간 내에 동일한 해시태그에 대해 실행되는 후속 쿼리는 제한에 카운트되지 않으며, 이로 인해 7일에 해당하는 초기 쿼리 타이머가 재설정되지도 않습니다.
API를 통해 검색된 해시태그가 달린 미디어 개체에는 댓글을 작성할 수 없습니다.
스토리의 해시태그는 지원되지 않습니다.
해시태그 쿼리에서 이모티콘은 지원되지 않습니다.
API는 민감하거나 불쾌하다고 간주한 해시태그가 포함되어 있는 요청에 대해서는 일반 오류를 반환합니다.

요구 사항

이 API를 사용하려면 앱 검수를 거쳐 다음에 대한 승인을 요청해야 합니다.

Instagram Public Content Access 기능
instagram_basic 권한

엔드포인트

해시태그 검색 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"     
    }
  ]
}