비즈니스 검색

Instagram 그래프 API를 사용하여 다른 Instagram 비즈니스 및 크리에이터 계정에 대한 기본 메타데이터와 지표를 가져올 수 있습니다.

제한 사항

나이 제한이 있는 Instagram 비즈니스 계정에 대한 데이터는 반환되지 않습니다.

엔드포인트

API는 다음과 같은 엔드포인트로 구성됩니다. 매개변수 및 권한 요구 사항에 대한 내용은 엔드포인트 참고 자료 문서를 참조하세요.

• GET /{ig-user-id}/business_discovery

예

계정의 팔로워 및 미디어 수 가져오기

이 샘플 쿼리는 Blue Bottle Coffee Instagram 비즈니스 계정에서 팔로워 수와 게시된 미디어 개체 수를 가져오는 방법을 보여줍니다. 비즈니스 검색 쿼리는 데이터를 가져오려는 Instagram 비즈니스 또는 크리에이터 계정 사용자 이름(이 예의 경우 bluebottle)이 아니라 Instagram 비즈니스 또는 크리에이터 계정 ID(이 경우 17841405309211844)에 대해 수행됩니다.

요청 샘플

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count}&access_token={access-token}"

응답 샘플

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "id": "17841401441775531" // Blue Bottle's Instagram Account ID
  },
  "id": "17841405309211844"  // ID of the Instagram account performing the query
}

미디어 가져오기

fields 매개변수를 통해 에지를 지정하여 중첩된 요청을 보낼 수 있으므로 타게팅된 비즈니스 또는 크리에이터 계정의 media 에지를 요청하여 모든 게시된 미디어 개체를 가져올 수 있습니다.

요청 샘플

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count,media}&access_token={access-token}"

응답 샘플

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        ... // results truncated for brevity
      ],
    "id": "17841401441775531"
  },
  },
  "id": "17841405309211844"
}

미디어에 대한 기본 지표 가져오기

중첩된 요청 및 필드 확장을 사용하여 비즈니스 또는 크리에이터 계정의 미디어 개체에 대한 공개 필드를 가져올 수 있습니다. 이는 미디어 개체에 대한 직접적인 액세스 권한을 제공하지는 않습니다. 반환된 IG 미디어에서 GET 요청을 보내면 권한 부족으로 실패합니다.

예를 들어 Blue Bottle Coffee에서 게시한 각 미디어 개체의 댓글과 좋아요 수를 가져오는 방법은 다음과 같습니다.

요청 샘플

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count,media{comments_count,like_count}}&access_token={access-token}"

응답 샘플

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5841,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2998,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3644,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
        {
          "comments_count": 60,
          "like_count": 9347,
          "id": "17899363132086521"
        },
        {
          "comments_count": 63,
          "like_count": 6913,
          "id": "17893114378137541"
        },
        {
          "comments_count": 16,
          "like_count": 2791,
          "id": "17886057709171561"
        },
        {
          "comments_count": 15,
          "like_count": 3895,
          "id": "17856337633208377"
        },
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405976406927"
}