การค้นหาแฮชแท็ก

ค้นหาสื่อบน IG สาธารณะที่มีการแท็กแฮชแท็กบางรายการ

ข้อจำกัด

• คุณสามารถสืบค้นแฮชแท็กที่ไม่ซ้ำกันได้สูงสุด 30 รายการในนามของบัญชีธุรกิจหรือครีเอเตอร์บน Instagram ภายในรอบระยะเวลา 7 วัน เมื่อคุณสืบค้นแฮชแท็ก ระบบจะนับจำนวนตามขีดจำกัดนี้เป็นเวลา 7 วัน การสืบค้นแฮชแท็กเดิมครั้งต่อไปภายในกรอบระยะเวลานี้จะไม่นับเพิ่มในขีดจำกัด และจะไม่รีเซ็ตการเริ่มนับรอบ 7 วันจากการสืบค้นครั้งแรก
• คุณไม่สามารถแสดงความคิดเห็นในอ็อบเจ็กต์สื่อที่มีแฮชแท็กซึ่งคุณพบผ่านทาง API ได้
• ระบบไม่รองรับแฮชแท็กในสตอรี่
• ระบบไม่รองรับอีโมจิในการสืบค้นแฮชแท็ก
• API จะส่งคืนข้อผิดพลาดทั่วไปเมื่อคำขอมีแฮชแท็กที่เราถือว่าเป็นแฮชแท็กที่ละเอียดอ่อนหรือไม่เหมาะสม

ข้อกำหนด

หากต้องการใช้ API นี้ คุณจะต้องผ่านการตรวจสอบแอพและขอการอนุมัติสำหรับรายการต่อไปนี้:

• ฟีเจอร์ Instagram Public Content Access
• สิทธิ์การอนุญาต instagram_basic

ตำแหน่งข้อมูล

API การค้นหาแฮชแท็กประกอบไปด้วยโหนดและจุดเชื่อมโยงดังต่อไปนี้:

• GET /ig_hashtag_search - เพื่อรับ ID โหนดของแฮชแท็กแบบเฉพาะเจาะจง
• GET /{ig-hashtag-id} - เพื่อรับข้อมูลเกี่ยวกับแฮชแท็ก
• GET /{ig-hashtag-id}/top_media - เพื่อรับข้อมูลรูปภาพและวิดีโอยอดนิยมสูงสุด ซึ่งระบุแฮชแท็กแบบเฉพาะเจาะจง
• GET /{ig-hashtag-id}/recent_media - เพื่อรับข้อมูลรูปภาพและวิดีโอที่เผยแพร่ล่าสุด ซึ่งระบุแฮชแท็กแบบเฉพาะเจาะจง
• GET /{ig-user-id}/recently_searched_hashtags - เพื่อระบุแฮชแท็กที่ไม่ซ้ำกันซึ่งบัญชีธุรกิจหรือครีเอเตอร์บน Instagram ได้ค้นหาในช่วงสัปดาห์ล่าสุด

ดูช่องที่รองรับ พารามิเตอร์ และข้อกำหนดในการใช้งานได้ในเอกสารอ้างอิงของตำแหน่งข้อมูลแต่ละรายการ

การใช้งานทั่วไป

การรับสื่อที่มีการแท็กด้วยแฮชแท็ก

หากต้องการรับข้อมูลรูปภาพและวิดีโอทั้งหมดที่มีแฮชแท็กแบบเฉพาะเจาะจง ให้เริ่มต้นโดยใช้ตำแหน่งข้อมูล /ig_hashtag_search แล้วระบุแฮชแท็กและ ID ของบัญชีธุรกิจหรือครีเอเตอร์บน Instagram ที่ทำการสืบค้น ตัวอย่างเช่น หากทำการสืบค้นในนามของบัญชีธุรกิจบน Instagram ที่มี ID 17841405309211844 คุณจะได้รับ ID ของแฮชแท็ก "#coke" จากการสืบค้นดังต่อไปนี้

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

การดำเนินการนี้จะส่งคืน ID สำหรับโหนดแฮชแท็ก "#Coke" ดังนี้

{
  "id" : "17873440459141021"
}

เมื่อคุณได้ ID แฮชแท็ก (17873440459141021) มาแล้ว คุณจะสามารถสืบค้นจุดเชื่อมโยง /top_media หรือ /recent_media ของแฮชแท็กนั้นและระบุ ID บัญชีธุรกิจเพื่อรับคอลเลกชั่นข้อมูลอ็อบเจ็กต์สื่อที่มีแฮชแท็ก "#coke" ได้ ตัวอย่างเช่น:

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

การดำเนินการนี้จะส่งคืนการตอบกลับที่มีลักษณะดังนี้

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