Khám phá doanh nghiệp của người dùng Instagram

Cho phép bạn lấy dữ liệu về những Người dùng Instagram khác 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.

Tạo

Thao tác này không được hỗ trợ.

Đọc

GET /{ig-user-id}?fields=business_discovery.username({username})

Trả về dữ liệu liên quan đến Người dùng Instagram khác 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. Hãy thực hiện yêu cầu này đối với Người dùng Instagram 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 đang truy vấn, rồi xác định doanh nghiệp được nhắm mục tiêu bằng thông số username.

Các giới hạn

Hệ thống sẽ không trả về dữ liệu liên quan đến Người dùng Instagram của Tài khoản kinh doanh trên Instagram có giới hạn độ tuổi.

Thông số chuỗi truy vấn

  • {username} (bắt buộc) - Tên người dùng của Người dùng Instagram thuộc 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 muốn lấy dữ liệu.

Quyền

Một Mã truy cập người dùng Facebook có các quyền sau:

  • instagram_basic
  • instagram_manage_insights
  • pages_read_engagement hoặc pages_show_list

Nếu mã này là từ Người dùng đã được cấp vai trò trên Trang qua Trình quản lý kinh doanh, bạn cũng cần có một trong những quyền sau đây:

  • ads_management
  • pages_read_engagement
  • business_management

Phần mở rộng trường thông tin

Bạn có thể sử dụng phần mở rộng trường thông tin để lấy các trường thông tin công khai của Người dùng Instagram được nhắm mục tiêu. Hãy xem tài liệu tham khảo về Người dùng Instagram để biết danh sách các trường thông tin công khai.

Ví dụ về yêu cầu có phần mở rộng trường thông tin

Lấy dữ liệu về Người dùng Instagram của Tài khoản kinh doanh trên Instagram có tên là "Blue Bottle Coffee" và sử dụng phần mở rộng trường thông tin để yêu cầu số người theo dõi và số file phương tiện.

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count}

Phản hồi mẫu

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

Truy cập cạnh có phần mở rộng trường thông tin

Bạn cũng có thể sử dụng phần mở rộng trường thông tin để truy cập cạnh /media của Người dùng Instagram được nhắm mục tiêu, rồi chỉ định các trường thông tin và số liệu cần trả về cho từng đối tượng File phương tiện trên Instagram. Hãy xem tài liệu tham khảo về nút File phương tiện để biết danh sách các trường thông tin công khai.

Các lệnh gọi phiên bản 10.0 trở lên cho đến ngày 07/09/2021: Trường like_count của File phương tiện trên Instagram sẽ trả về 0 nếu chủ sở hữu file phương tiện đã ẩn số lượt thích của file phương tiện đó.

Các lệnh gọi phiên bản 11.0 trở lên và tất cả các phiên bản vào ngày 07/09/2021: Nếu truy vấn gián tiếp một File phương tiện trên Instagram thông qua điểm cuối khác hoặc phần mở rộng trường thông tin, trường like_count sẽ không có trong phản hồi API nếu chủ sở hữu file phương tiện đã ẩn số lượt thích của file phương tiện đó. Tuy nhiên, việc truy vấn trực tiếp File phương tiện trên Instagram (chỉ chủ sở hữu File phương tiện trên Instagram mới có thể thực hiện thao tác này) sẽ trả về số lượt thích thực tế, ngay cả khi số lượt thích của file phương tiện đó đã bị ẩn.

Yêu cầu mẫu có cạnh

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count,media}

Phản hồi mẫu có cạnh

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        {
          "id": "17911489846004508"
        }
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

Phân trang

Cạnh /media hỗ trợ tính năng phân trang theo vị trí con trỏ. Vì vậy, khi truy cập cạnh này qua phần mở rộng trường thông tin, nội dung phản hồi sẽ có con trỏ beforeafter nếu chứa nhiều trang dữ liệu. Tuy nhiên, khác với tính năng phân trang thông thường theo vị trí con trỏ, nội dung phản hồi sẽ không có trường thông tin previous hoặc next. Vì vậy, bạn sẽ phải sử dụng con trỏ beforeafter để tạo thủ công chuỗi truy vấn previousnext nhằm phân trang cho tập dữ liệu trả về.

Yêu cầu mẫu

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){media{comments_count,like_count}}

Phản hồi mẫu

{
  "business_discovery": {
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5837,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2997,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3643,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
     ],
   },
   "id": "17841401441775531"
  },
  "id": "17841405976406927"
}

Cập nhật

Thao tác này không được hỗ trợ.

Xóa

Thao tác này không được hỗ trợ.