Instagram 그래프 API

IG 사용자 비즈니스 검색

다른 Instagram 비즈니스 또는 크리에이터 IG 사용자에 대한 데이터를 가져올 수 있습니다.

만들기

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

읽기

GET /{ig-user-id}?fields=business_discovery.username({username})

다른 Instagram 비즈니스 또는 크리에이터 IG 사용자에 대한 데이터를 반환합니다. 쿼리하는 Instagram 비즈니스 또는 크리에이터 IG 사용자에 대해 이 요청을 실행하고 username 매개변수로 타게팅된 비즈니스를 식별하세요.

제한 사항

나이 제한이 있는 Instagram 비즈니스 IG 사용자에 대한 데이터는 반환되지 않습니다.

쿼리 문자열 매개변수

  • {username}(필수) — 데이터를 가져오려는 Instagram 비즈니스 또는 크리에이터 IG 사용자의 사용자 이름.

권한

다음과 같은 권한이 있는 Facebook 사용자 액세스 토큰입니다.

  • instagram_basic
  • instagram_manage_insights
  • pages_read_engagement 또는 pages_show_list

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

  • ads_management
  • pages_read_engagement
  • business_management

필드 확장

필드 확장을 사용하여 타게팅된 IG 사용자에 대한 공개 필드를 가져올 수 있습니다. 공개 필드의 리스트는 IG 사용자 참고 자료를 참조하세요.

필드 확장을 포함한 요청 샘플

Instagram 비즈니스 IG 사용자 'Blue Bottle Coffee'에 대한 데이터를 가져오고 필드 확장을 사용하여 팔로워와 미디어 수를 요청하세요.

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count}

응답 샘플

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

필드 확장으로 에지에 액세스하기

또한 필드 확장을 사용하여 타게팅된 IG 사용자에 대한 /media 에지에 액세스하고 각 IG 미디어 개체에 반환해야 할 필드와 지표를 지정할 수 있습니다. 공개 필드의 리스트는 미디어 노드 참고 자료를 참조하세요.

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

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

에지가 포함된 요청 샘플

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count,media}

에지가 포함된 응답 샘플

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        {
          "id": "17911489846004508"
        }
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

페이지 매김

/media 에지는 커서 기반 페이지 매김을 지원하므로 필드 확장을 통해 액세스할 때 응답에 여러 페이지의 데이터가 있으면 응답에 before와 after 커서가 포함됩니다. 그러나 표준 커서 기반 페이지 매김과 달리, 응답에는 previous 또는 next 필드가 포함되지 않으므로 before와 after 커서를 사용하여 수동으로 previous와 next 쿼리 문자열을 구성하고 반환된 데이터 세트에 페이지를 지정해야 합니다.

요청 샘플

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){media{comments_count,like_count}}

응답 샘플

{
  "business_discovery": {
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5837,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2997,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3643,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
     ],
   },
   "id": "17841401441775531"
  },
  "id": "17841405976406927"
}

업데이트

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

삭제

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