Khám phá doanh nghiệp

Bạn có thể sử dụng API Đồ thị trên Instagram để lấy siêu dữ liệu và số liệu cơ bản về những Tài khoản người sáng tạo nội dung và Tài khoản kinh doanh khác trên Instagram.

Các 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 kinh doanh trên Instagram có giới hạn độ tuổi.

Đ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ố.

Ví dụ

Lấy số lượng file phương tiện và số người theo dõi của tài khoả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 kinh doanh 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 của Tài khoản người sáng tạo nội dung hoặc Tài khoản kinh doanh trên Instagram (trong trường hợp này là 17841405309211844), chứ không theo tên người dùng của Tài khoản người sáng tạo nội dung hoặc Tài khoản kinh doanh trên Instagram mà bạn đang cố lấy dữ liệu (trong ví dụ này là bluebottle).

Yêu cầu mẫu

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

Phản hồi mẫu

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

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 người sáng tạo nội dung hoặc Tài khoản kinh doanh đượ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

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

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

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

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