On September 4, 2024, we announced the deprecation of the Instagram Basic Display API.

Starting December 4, 2024, all requests to the Instagram Basic Display API will return an error message. We recommend that you migrate your app to the Instagram API to avoid any disruption to your services.

Visit our News for Developers blog post to learn more.

Lấy trang cá nhân và file phương tiện của người dùng

Hướng dẫn này giải thích cách lấy trang cá nhân và file phương tiện của người dùng Instagram.

Lấy trang cá nhân của người dùng

Thực hiện các bước sau đây để lấy dữ liệu trên trang cá nhân (trường thông tin) của người dùng Instagram từ Người dùng.

Bước 1: Lấy mã truy cập và quyền

Làm theo hướng dẫn Lấy mã truy cập và quyền của chúng tôi để lấy Mã truy cập dành cho người dùng Instagram từ người dùng. Bạn sẽ cần có quyền instagram_graph_user_profile. Vì vậy, hãy yêu cầu phạm vi user_profile khi bạn cần người dùng ủy quyền.

Bước 2: Truy vấn nút Người dùng

Gửi yêu cầu đến điểm cuối sau đây:

GET /me?fields={fields}&access_token={access-token}

Thay thế {fields} bằng danh sách được phân tách bằng dấu phẩy gồm các trường thông tin về Người dùng mà bạn muốn nhận được và thay thế {access-token} bằng mã truy cập của người dùng. Điểm cuối GET /me sẽ xác định ID của người dùng từ mã này và chuyển hướng yêu cầu đến nút Người dùng.

Yêu cầu mẫu

curl -X GET \
  'https://graph.instagram.com/me?fields=id,username&access_token=IGQVJ...'

Phản hồi mẫu

{
  "id": "17841405793187218",
  "username": "jayposiris"
}

Lấy file phương tiện của người dùng

Thực hiện các bước sau đây để lấy tập hợp File phương tiện từ Người dùng Instagram.

Bước 1: Lấy mã truy cập và quyền

Làm theo hướng dẫn Lấy mã truy cập và quyền của chúng tôi để lấy Mã truy cập dành cho người dùng Instagram từ người dùng. Bạn sẽ cần có quyền instagram_graph_user_profileinstagram_graph_user_media permissions. Vì vậy, hãy yêu cầu phạm vi user_profileuser_media khi bạn cần người dùng ủy quyền.

Bước 2: Truy vấn cạnh File phương tiện của người dùng

Gửi yêu cầu đến điểm cuối sau đây:

GET /me/media?fields={fields}&access_token={access-token}

Thay thế {fields} bằng danh sách được phân tách bằng dấu phẩy gồm các trường thông tin về File phương tiện mà bạn muốn nhận được cho từng File phương tiện có trong phản hồi (hoặc bỏ qua toàn bộ thông số fields nếu bạn chỉ muốn nhận được ID), đồng thời thay thế {access-token} bằng mã truy cập của người dùng. Điểm cuối GET /me sẽ xác định ID của người dùng từ mã này và chuyển hướng yêu cầu đến nút Người dùng.

Yêu cầu mẫu

curl -X GET \
  'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'

Phản hồi mẫu

{
  "data": [
    {
      "id": "17895695668004550",
      "caption": ""
    },
    {
      "id": "17899305451014820",
      "caption": ""
    },
    {
      "id": "17896450804038745",
      "caption": ""
    },
    {
      "id": "17881042411086627",
      "caption": ""
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

Lấy dữ liệu từ file phương tiện

Thực hiện các bước sau đây để lấy dữ liệu (trường thông tin) về hình ảnh, video hoặc album.

Bước 1: Lấy mã truy cập và quyền

Làm theo hướng dẫn Lấy mã truy cập và quyền của chúng tôi để lấy Mã truy cập dành cho người dùng Instagram từ người dùng. Bạn sẽ cần có quyền instagram_graph_user_media. Vì vậy, hãy yêu cầu phạm vi user_media khi bạn cần người dùng ủy quyền.

Bước 2: Truy vấn nút File phương tiện

Gửi yêu cầu đến điểm cuối sau đây:

GET /{media-id}?fields={fields}&access_token={access-token}

Thay thế {media-id} bằng ID của hình ảnh, video hoặc album mà bạn muốn truy vấn, thay thế {fields} bằng danh sách được phân tách bằng dấu phẩy gồm các trường thông tin về File phương tiện mà bạn muốn nhận được, đồng thời thay thế {access-token} bằng mã truy cập của người dùng.

Yêu cầu mẫu

curl -X GET \
  'https://graph.instagram.com/17895695668004550?fields=id,media_type,media_url,username,timestamp&access_token=IGQVJ...'

Phản hồi mẫu

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

Bước 2 (Thay thế): Truy vấn cạnh File phương tiện của người dùng

Bạn có thể truy vấn cạnh File phương tiện của người dùng để lấy tập hợp File phương tiện từ Người dùng và sử dụng tính năng mở rộng trường để nhận được phản hồi chứa các trường thông tin về File phương tiện cho từng File phương tiện trong tập hợp đó. Để thực hiện, hãy gửi yêu cầu đến điểm cuối sau đây:

GET /me/media?fields={fields}&access_token={access-token}

Thay thế {fields} bằng danh sách được phân tách bằng dấu phẩy gồm các trường thông tin về File phương tiện mà bạn muốn nhận được cho từng File phương tiện trong tập hợp, đồng thời thay thế {access-token} bằng mã truy cập của người dùng. Điểm cuối GET /me sẽ xác định ID của người dùng từ mã này và chuyển hướng yêu cầu đến nút Người dùng.

Yêu cầu mẫu

curl -X GET \
  'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'

Phản hồi mẫu

{
  "data": [
    {
      "id": "17895695668004550",
      "caption": ""
    },
    {
      "id": "17899305451014820",
      "caption": ""
    },
    {
      "id": "17896450804038745",
      "caption": ""
    },
    {
      "id": "17881042411086627",
      "caption": ""
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

Lấy nội dung album

Thực hiện các bước sau đây để lấy tập hợp File phương tiện là hình ảnh và video từ File phương tiện là album.

Bước 1: Lấy mã truy cập và quyền

Làm theo hướng dẫn Lấy mã truy cập và quyền của chúng tôi để lấy Mã truy cập dành cho người dùng Instagram từ người dùng. Bạn sẽ cần có quyền instagram_graph_user_media. Vì vậy, hãy yêu cầu phạm vi user_media khi bạn cần người dùng ủy quyền.

Bước 2: Truy vấn cạnh File phương tiện con

Gửi yêu cầu đến điểm cuối sau đây:

GET /{media-id}/children?fields={fields}&access_token={access-token}

Thay thế {media-id} bằng ID của album mà bạn muốn truy vấn, thay thế {fields} bằng danh sách được phân tách bằng dấu phẩy gồm các trường thông tin về File phương tiện mà bạn muốn nhận được cho từng File phương tiện là hình ảnh và video trong tập hợp (hoặc bỏ qua toàn bộ thông số fields nếu bạn chỉ muốn nhận được ID), đồng thời thay thế {access-token} bằng mã truy cập của người dùng.

Yêu cầu mẫu

curl -X GET \
  'https://graph.instagram.com/17896450804038745/children?access_token=IGQVJ...'

Phản hồi mẫu

{
  "data": [
    {
      "id": "17880997618081620"
    },
    {
      "id": "17871527143187462"
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "previous": "https://graph.faceb...",
    "next": "https://graph.faceb..."
  }
}