Khám phá doanh nghiệp

Bạn có thể sử dụng API Instagram qua phương thức Đăng nhập bằng Facebook để lấy siêu dữ liệu và số liệu cơ bản về những tài khoản công việc khác trên Instagram.

Giới hạn

Hệ thống sẽ không trả về dữ liệu liên quan đến các tài khoản công việc có giới hạn độ tuổi trên Instagram.

Điểm cuối

API này bao gồm các điểm cuối dưới đây. Hãy xem tài liệu tham khảo của điểm cuối để biết các yêu cầu về quyền và thông số.

• GET /<YOUR_APP_USERS_IG_USER_ID>/business_discovery

Ví dụ

Lấy số lượng người theo dõi và file phương tiện

Truy vấn mẫu này cho thấy cách lấy số người theo dõi và số lượng đối tượng file phương tiện đã đăng của tài khoản công việc trên Instagram có tên Blue Bottle Coffee. Lưu ý rằng các truy vấn khám phá doanh nghiệp sẽ được thực hiện bằng ID tài khoản công việc trên Instagram của người dùng ứng dụng (trong trường hợp này là 17841405309211844) với tên người dùng của tài khoản công việc trên Instagram mà người dùng ứng dụng của bạn đang cố lấy dữ liệu (trong ví dụ này là bluebottle).

Yêu cầu mẫu

Được định dạng để dễ đọc.

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>"

Phản hồi mẫu

{
  "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
}

Lấy file phương tiện

Bạn có thể chỉ định một cạnh qua thông số fields để gửi các yêu cầu lồng nhau. Vì thế, bạn có thể yêu cầu cạnh media của tài khoản công việc được nhắm mục tiêu để lấy tất cả đối tượng file phương tiện đã đăng.

Yêu cầu mẫu

Được định dạng để dễ đọc.

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>"

Phản hồi mẫu

{
  "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"
}

Lấy số liệu cơ bản về file phương tiện

Bạn có thể sử dụng cả yêu cầu lồng nhau lẫn phần mở rộng trường để lấy các trường công khai cho đối tượng file phương tiện của Tài khoản người sáng tạo nội dung hoặc Tài khoản kinh doanh. Lưu ý rằng việc này sẽ không cấp cho bạn quyền truy cập trực tiếp vào đối tượng file phương tiện. Bạn sẽ không thực hiện được yêu cầu GET trên bất kỳ File phương tiện trên Instagram nào trả về do không đủ quyền.

Ví dụ: sau đây là cách lấy số bình luận và lượt thích cho mỗi đối tượng file phương tiện mà Blue Bottle Coffee đã đăng:

Yêu cầu mẫu

Được định dạng để dễ đọc.

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>"

Phản hồi mẫu

{
  "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"
}