Tìm kiếm hashtag

Tìm File phương tiện công khai trên Instagram đã được gắn thẻ bằng các hashtag cụ thể.

Giới hạn

• Bạn có thể truy vấn tối đa 30 hashtag riêng biệt thay cho 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 khoảng thời gian 7 ngày tuần tự. Sau khi bạn truy vấn một hashtag, hashtag đó sẽ tính vào giới hạn này trong 7 ngày. Nếu thực hiện các truy vấn tiếp theo cho cùng một hashtag trong khoảng thời gian này, bạn sẽ không bị tính vào giới hạn và bộ hẹn giờ 7 ngày từ lần truy vấn đầu tiên sẽ không bị khởi động lại.
• Bạn không thể bình luận trên các đối tượng file phương tiện có hashtag mà bạn tìm thấy qua API này.
• Không hỗ trợ hashtag trên Tin.
• Không hỗ trợ biểu tượng cảm xúc trong các truy vấn hashtag.
• API này sẽ trả về một lỗi chung cho bất kỳ yêu cầu nào có hashtag mà chúng tôi xem là nhạy cảm hoặc xúc phạm.

Yêu cầu

Để sử dụng API này, bạn phải trải qua quy trình Xét duyệt ứng dụng và yêu cầu phê duyệt:

• tính năng Instagram Public Content Access
• quyền instagram_basic

Điểm cuối

API Tìm kiếm hashtag bao gồm các nút và cạnh sau đây:

• GET /ig_hashtag_search - để lấy ID nút của hashtag cụ thể
• GET /{ig-hashtag-id} - để lấy dữ liệu về hashtag
• GET /{ig-hashtag-id}/top_media - để lấy những ảnh và video phổ biến nhất có hashtag cụ thể
• GET /{ig-hashtag-id}/recent_media - để lấy những ảnh và video đăng gần đây nhất có hashtag cụ thể
• GET /{ig-user-id}/recently_searched_hashtags - để xác định các hashtag riêng biệt mà 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ìm kiếm trong tuần hiện tại

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ề cách sử dụng, thông số và trường thông tin được hỗ trợ.

Cách dùng phổ biến

Lấy file phương tiện được gắn thẻ hashtag

Để lấy tất cả ảnh và video có hashtag cụ thể, trước tiên, hãy sử dụng điểm cuối /ig_hashtag_search rồi thêm hashtag và 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 đang thực hiện truy vấn. Ví dụ: nếu truy vấn được thực hiện thay cho Tài khoản kinh doanh trên Instagram có ID 17841405309211844, bạn có thể lấy ID cho hashtag "#coke" bằng cách thực hiện truy vấn sau:

GET graph.facebook.com/ig_hashtag_search
  ?user_id=17841405309211844
  &q=coke

Thao tác này sẽ trả về ID của nút hashtag "#Coke":

{
  "id" : "17873440459141021"
}

Bây giờ, khi đã có ID hashtag (17873440459141021), bạn có thể truy vấn cạnh /top_media hoặc /recent_media và thêm ID tài khoản kinh doanh để lấy tập hợp các đối tượng file phương tiện có hashtag "#coke". Ví dụ:

GET graph.facebook.com/17873440459141021/recent_media
  ?user_id=17841405309211844

Thao tác này sẽ trả về phản hồi có dạng như sau:

{
  "data": [
    {
      "id": "17880997618081620"
    },
    {
      "id": "17871527143187462"
    },
    {       
      "id": "17896450804038745"     
    }
  ]
}