비즈니스 검색

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

제한 사항

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

엔드포인트

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

• GET /<YOUR_APP_USERS_IG_USER_ID>/business_discovery

예

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

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

요청 샘플

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

curl -i -X GET \
 "https://graph.facebook.com/v21.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/v21.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/v21.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"
}