IG 해시태그 인기 미디어

해시태그로 태그된 가장 인기 있는 사진과 동영상 IG 미디어 개체의 컬렉션을 나타냅니다.

인기도는 www.instagram.com에서 해시태그를 검색할 때 인기 게시물을 결정하는 것과 동일한 방법으로 조회수와 시청자 상호작용을 혼합하여 결정합니다.

2021년 9월 7일까지 v10.0 이전 호출: IG 미디어의 like_count 필드는 미디어 소유자가 미디어의 좋아요 개수를 숨겼을 경우0을 반환합니다.

2021년 9월 7일에 v11.0 이상 호출 및 모든 버전: 다른 엔드포인트 또는 필드 확장을 통해 IG 미디어를 간접적으로 쿼리할 경우 미디어 소유자가 미디어의 좋아요 개수를 숨겼다면 like_count 필드는 API 응답에서 생략됩니다. IG 미디어를 직접 쿼리하면(IG 미디어 소유자만 가능) 좋아요 개수가 숨겨져 있더라도 실제 좋아요 개수가 반환됩니다.

만들기

지원되지 않는 작업입니다.

읽기

가장 많이 해시태그된 미디어 가져오기

GET /{ig-hashtag-id}/top_media?user_id={user-id}&fields={fields}

해시태그로 태그된 가장 인기 있는 사진과 동영상 IG 미디어 개체를 반환합니다.

쿼리 문자열 매개변수

{user_id}(필수) — 쿼리를 수행하는 Instagram 비즈니스 또는 크리에이터 계정의 ID입니다.
{fields} — 반환하고자 하는 필드의 쉼표로 구분된 리스트입니다. 반환 가능한 필드를 참조하세요.

제한 사항

이 에지는 전체 공개 사진과 동영상만 반환합니다.
홍보/광고 미디어는 반환되지 않습니다.
응답은 페이지당 결과 50개까지 최대 limit으로 페이지 매김됩니다.
7일 동안 최대 30개의 고유한 해시태그를 쿼리할 수 있습니다.
반환된 미디어 개체에 대해 username 필드를 요청할 수 있습니다.
이 엔드포인트는 페이지 매김된 결과에 대해 after 커서만 반환하며, before 커서는 포함되지 않습니다. 또한 after 커서 값은 언제나 각 페이지에 대해 동일하지만 여전히 결과 세트에서 결과의 다음 페이지를 가져오는 데 사용할 수 있습니다.

요구 사항

유형 설명

유형	설명
기능	`Instagram Public Content Access`
권한	`instagram_basic` 비즈니스 관리자를 통해 페이지 역할이 부여된 사용자에게서 받은 토큰일 경우 `ads_management`, `business_management`, `pages_read_engagement` 권한 중 하나도 필요합니다.
토큰	연결된 Facebook 페이지에서 작업하도록 승인을 받은 Facebook 사용자의 사용자 액세스 토큰입니다.

기능

Instagram Public Content Access

권한

instagram_basic

비즈니스 관리자를 통해 페이지 역할이 부여된 사용자에게서 받은 토큰일 경우 ads_management, business_management, pages_read_engagement 권한 중 하나도 필요합니다.

토큰

연결된 Facebook 페이지에서 작업하도록 승인을 받은 Facebook 사용자의 사용자 액세스 토큰입니다.

응답

IG 미디어 개체의 배열. 초과된 결과는 페이지 매김됩니다.

반환 가능한 필드

fields 매개변수를 사용하여 반환된 미디어 개체에 대해 다음의 필드를 요청하세요.

caption
children(사진첩 IG 미디어에 대해서만 반환됨)
comments_count
id
like_count(v10.0 이상 호출: 미디어 소유자에게 숨겨진 좋아요 숫자가 있는 경우 값은 0이 됨. v11.0 이상 호출: 미디어 소유자에게 숨겨진 좋아요 숫자가 있는 경우 필드가 생략됨)
media_type
media_url(사진첩 IG 미디어에 반환되지 않음)
permalink
timestamp(v7.0+에서만 제공)

요청 샘플

GET graph.facebook.com/17873440459141021/top_media
  ?user_id=17841405309211844
  &fields=id,media_type,comments_count,like_count

응답 샘플

{
  "data": [
    {
      "id": "17880997618081620",
      "media_type": "IMAGE",
      "comments_count": 84,
      "like_count": 177
    },
    {
      "id": "17871527143187462"
      "media_type": "IMAGE",
      "comments_count": 24,
      "like_count": 57
    },
    {       
      "id": "17896450804038745"
      "media_type": "IMAGE",
      "comments_count": 19,
      "like_count": 36
    },
    ... // Results truncated for clarity
  ],
  "paging":
    {
      "cursors":
        {
          "after": "NTAyYmE4..."
        },
      "next": "https://graph.facebook.com/..."
    }
}

업데이트

지원되지 않는 작업입니다.

삭제

지원되지 않는 작업입니다.