비즈니스 검색

Facebook 로그인을 통한 Instagram API를 사용하여 다른 Instagram 프로페셔널 계정에 대한 기본 메타데이터와 지표를 가져올 수 있습니다.

제한 사항

나이 제한이 있는 Instagram 프로페셔널 계정에 대한 데이터는 반환되지 않습니다.

엔드포인트

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

• GET /<YOUR_APP_USERS_IG_USER_ID>/business_discovery

예

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

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

요청 샘플

가독성을 높이기 위해 형식을 지정했습니다.

curl -i -X GET \
 "https://graph.facebook.com/v20.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_ACCESS_TOKEN>"

응답 샘플

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "id": "17841401441775531" // Blue Bottle's Instagram user ID
  },
  "id": "17841405309211844"  // Your app user's Instagram user ID
}

미디어 가져오기

fields 매개변수를 통해 에지를 지정하여 중첩된 요청을 보낼 수 있으므로 타게팅된 프로페셔널 계정의 media 에지를 요청하여 모든 게시된 미디어 개체를 가져올 수 있습니다.

요청 샘플

가독성을 높이기 위해 형식을 지정했습니다.

curl -i -X GET \
 "https://graph.facebook.com/v20.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count,media} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_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/v20.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count,media{comments_count,like_count}} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_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"
}