File phương tiện hàng đầu có hashtag trên Instagram

Biểu thị tập hợp đối tượng File phương tiện trên Instagram của ảnh và video phổ biến nhất được gắn thẻ hashtag.

Mức độ phổ biến được xác định bằng lượt xem lẫn lượt tương tác của người xem thông qua phương thức tương tự dùng để xác định bài viết hàng đầu khi tìm kiếm hashtag trên www.instagram.com.

Tạo

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

Đọc

Lấy file phương tiện phổ biến nhất có hashtag

GET /{ig-hashtag-id}/top_media?user_id={user-id}&fields={fields}

Trả về các đối tượng File phương tiện trên Instagram của ảnh và video phổ biến nhất được gắn thẻ hashtag.

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

• {user_id} (bắt buộc) - 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 thực hiện truy vấn.
• {fields} - Danh sách các trường mà bạn muốn nhận được, được phân tách bằng dấu phẩy. Xem Các trường có thể trả về.

Giới hạn

• Cạnh này chỉ trả về các ảnh và video công khai.
• Sẽ không trả về file phương tiện quảng cáo/được quảng cáo.
• Nội dung phản hồi được phân trang với tối đa limit 50 kết quả mỗi trang.
• Bạn có thể truy vấn tối đa 30 hashtag riêng biệt trong khoảng thời gian 7 ngày.
• Bạn không thể yêu cầu trường username cho các đối tượng file phương tiện được trả về.
• Điểm cuối này chỉ trả về con trỏ after cho các kết quả được phân trang; con trỏ before sẽ không được đưa vào. Ngoài ra, giá trị con trỏ after sẽ luôn giống nhau đối với mỗi trang. Tuy nhiên, bạn vẫn có thể dùng con trỏ này để lấy trang kết quả tiếp theo trong tập kết quả.

Yêu cầu

Phản hồi

Mảng đối tượng File phương tiện trên Instagram. Các kết quả vượt quá sẽ được phân trang.

Các trường có thể trả về

Bạn có thể sử dụng thông số fields để yêu cầu các trường sau đây cho đối tượng file phương tiện được trả về:

• caption
• children (chỉ được trả về cho File phương tiện trên Instagram của album)
• comments_count
• id
• like_count (Các lệnh gọi v10.0 trở xuống: giá trị sẽ là 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 v11 trở lên: sẽ không có trường thông tin nếu chủ sở hữu file phương tiện đã ẩn số lượt thích của file phương tiện đó.)
• media_type
• media_url (không được trả về cho File phương tiện trên Instagram của album)
• permalink
• timestamp (chỉ có trên phiên bản 7.0 trở lên)

Yêu cầu mẫu

GET graph.facebook.com/17873440459141021/top_media
  ?user_id=17841405309211844
  &fields=id,media_type,comments_count,like_count

Phản hồi mẫu

{
  "data": [
    {
      "id": "17880997618081620",
      "media_type": "IMAGE",
      "comments_count": 84,
      "like_count": 177
    },
    {
      "id": "17871527143187462"
      "media_type": "IMAGE",
      "comments_count": 24,
      "like_count": 57
    },
    {       
      "id": "17896450804038745"
      "media_type": "IMAGE",
      "comments_count": 19,
      "like_count": 36
    },
    ... // Results truncated for clarity
  ],
  "paging":
    {
      "cursors":
        {
          "after": "NTAyYmE4..."
        },
      "next": "https://graph.facebook.com/..."
    }
}

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ợ.