Tài liệu này đã được cập nhật.
Bản dịch sang Tiếng Việt chưa hoàn tất.
Cập nhật bằng tiếng Anh: 6 tháng 5

Thông tin chi tiết

Bạn có thể dùng API Đồ thị trên Instagram để lấy số liệu tương tác xã hội của Người dùng Instagram và các đối tượng File phương tiện trên Instagram của họ. Số lượng của mỗi số liệu được tính theo yêu cầu API.

Do những quy tắc về quyền riêng tư, các hoạt động tương tác (liên quan đến nhắn tin) với File phương tiện trong Tin trên Instagram mà người dùng tại một số khu vực thực hiện sẽ không được tính vào một vài số liệu nữa. Những khu vực này bao gồm: châu Âu (kể từ ngày 01/12/2020) và Nhật Bản (kể từ ngày 14/04/2021).

  • Đối với Tin do người dùng tại những khu vực bị ảnh hưởng tạo, số liệu replies hiện sẽ trả về giá trị 0.
  • Đối với Tin do người dùng bên ngoài những khu vực bị ảnh hưởng tạo, số liệu replies sẽ trả về số tin trả lời, không tính những tin trả lời của người dùng tại những khu vực bị ảnh hưởng.

Giới hạn

  • Mộ vài số liệu không có sẵn cho những Người dùng Instagram có ít hơn 100 người theo dõi.
  • API này chỉ báo cáo số liệu tương tác tự nhiên; các lượt tương tác trên quảng cáo chứa đối tượng file phương tiện sẽ không được tính.
  • Dữ liệu về số liệu của file phương tiện sẽ được lưu trữ trong tối đa 2 năm. Dữ liệu về số liệu của người dùng sẽ được lưu trữ trong tối đa 90 ngày.
  • Mỗi lần, bạn chỉ có thể lấy thông tin chi tiết cho một người dùng.
  • Bạn không thể lấy thông tin chi tiết cho Trang Facebook.
  • Thông tin chi tiết về tin chỉ tồn tại trong 24 giờ, ngay cả khi tin được lưu trữ hoặc nêu bật. Nếu bạn muốn lấy thông tin chi tiết mới nhất về một tin trước khi tin đó hết hạn, hãy thiết lập Webhook cho chủ đề Instagram và đăng ký trường story_insights.
  • Thông tin chi tiết về File phương tiện trên Instagram thuộc album chưa được hỗ trợ.
  • Nếu dữ liệu thông tin chi tiết bạn đang yêu cầu không tồn tại hoặc hiện không có sẵn, API sẽ trả về một tập dữ liệu trống thay cho 0 đối với từng số liệu.

UTC

Nhãn thời gian trong phần phản hồi API sẽ sử dụng giờ UTC mà không bù chênh lệch và tuân theo định dạng ISO-8601. Ví dụ: 2019-04-05T07:56:32+0000

Điểm cuối

API này bao gồm các điểm cuối sau:

Hãy xem tài liệu tham khảo của từng điểm cuối để biết các yêu cầu về quyền, thông số và số liệu hiện có.

Ví dụ

Lấy số liệu về tài khoản

Để lấy số liệu về 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 truy vấn cạnh GET /{ig-user-id}/insights và chỉ định các số liệu mà bạn muốn nhận được.

Yêu cầu mẫu

GET graph.facebook.com/17841405822304914/insights
    ?metric=impressions,reach,profile_views
    &period=day

Phản hồi mẫu

{
  "data": [
    {
      "name": "impressions",
      "period": "day",
      "values": [
        {
          "value": 32,
          "end_time": "2018-01-11T08:00:00+0000"
        },
        {
          "value": 32,
          "end_time": "2018-01-12T08:00:00+0000"
        }
      ],
      "title": "Impressions",
      "description": "Total number of times the Business Account's media objects have been viewed",
      "id": "instagram_business_account_id/insights/impressions/day"
    },
    {
      "name": "reach",
      "period": "day",
      "values": [
        {
          "value": 12,
          "end_time": "2018-01-11T08:00:00+0000"
        },
        {
          "value": 12,
          "end_time": "2018-01-12T08:00:00+0000"
        }
      ],
      "title": "Reach",
      "description": "Total number of times the Business Account's media objects have been uniquely viewed",
      "id": "instagram_business_account_id/insights/reach/day"
    },
    {
      "name": "profile_views",
      "period": "day",
      "values": [
        {
          "value": 15,
          "end_time": "2018-01-11T08:00:00+0000"
        },
        {
          "value": 15,
          "end_time": "2018-01-12T08:00:00+0000"
        }
      ],
      "title": "Profile Views",
      "description": "Total number of users who have viewed the Business Account's profile within the specified period",
      "id": "instagram_business_account_id/insights/profile_views/day"
    }
  ]
}

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

Để lấy số liệu về đối tượng file phương tiện, hãy truy vấn cạnh GET /{ig-media-id}/insights và chỉ định các số liệu mà bạn muốn nhận được.

Yêu cầu mẫu

GET graph.facebook.com/{media-id}/insights
    ?metric=engagement,impressions,reach

Phản hồi mẫu

{
  "data": [
    {
      "name": "engagement",
      "period": "lifetime",
      "values": [
        {
          "value": 8
        }
      ],
      "title": "Engagement",
      "description": "Total number of likes and comments on the media object",
      "id": "media_id/insights/engagement/lifetime"
    },
    {
      "name": "impressions",
      "period": "lifetime",
      "values": [
        {
          "value": 13
        }
      ],
      "title": "Impressions",
      "description": "Total number of times the media object has been seen",
      "id": "media_id/insights/impressions/lifetime"
    },
    {
      "name": "reach",
      "period": "lifetime",
      "values": [
        {
          "value": 13
        }
      ],
      "title": "Reach",
      "description": "Total number of unique accounts that have seen the media object",
      "id": "media_id/insights/reach/lifetime"
    }
  ]
}