Pencarian Tagar

Temukan Media Instagram publik yang telah ditandai dengan tagar tertentu.

Batasan

Anda dapat meminta maksimal 30 tagar unik atas nama Akun Instagram Business atau Akun Kreator Instagram dalam periode 7 hari yang bergulir. Setelah Anda meng-kueri tagar, itu akan dihitung terhadap batas ini selama 7 hari. Kueri berikutnya pada tagar yang sama dalam jangka waktu ini tidak akan dihitung ke dalam batas Anda, dan tidak akan mengatur ulang kueri awalnya dalam pengatur waktu 7 hari.
Anda tidak dapat mengomentari objek media bertagar yang ditemukan melalui API.
Tagar pada Cerita tidak didukung.
Emoji dalam kueri tagar tidak didukung.
API akan menampilkan kesalahan umum untuk setiap permintaan yang menyertakan tagar yang kami anggap sensitif atau mengganggu.

Persyaratan

Untuk menggunakan API ini, Anda harus menjalani Tinjauan Aplikasi dan meminta persetujuan untuk:

fitur Instagram Public Content Access
izin instagram_basic

Endpoint

API Pencarian Tagar terdiri dari node dan edge berikut:

GET /ig_hashtag_search — untuk mendapatkan ID node tagar tertentu
GET /{ig-hashtag-id} — untuk mendapatkan data tentang tagar
GET /{ig-hashtag-id}/top_media — untuk mendapatkan foto dan video terpopuler yang memiliki tagar tertentu
GET /{ig-hashtag-id}/recent_media — untuk mendapatkan foto dan video terbitan terbaru yang memiliki tagar tertentu
GET /{ig-user-id}/recently_searched_hashtags — untuk menentukan tagar unik yang dicari oleh Akun Instagram Business atau Akun Kreator Instagram dalam minggu ini

Baca dokumentasi referensi setiap endpoint untuk kolom yang didukung, parameter, dan persyaratan penggunaan.

Penggunaan Umum

Mendapatkan Media yang Ditandai dengan Tagar

Untuk mendapatkan semua foto dan video dengan tagar tertentu, gunakan dahulu endpoint /ig_hashtag_search dan sertakan tagar dan ID Akun Instagram Business atau Akun Kreator Instagram yang membuat kueri. Contoh: jika kueri dibuat atas nama Akun Instagram Business dengan ID 17841405309211844, Anda bisa mendapatkan ID untuk tagar "#coke" dengan melakukan kueri berikut:

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

Ini akan memberikan ID untuk node tagar “#Coke”:

{
  "id" : "17873440459141021"
}

Sekarang, setelah memiliki tagar ID (17873440459141021), Anda dapat meng-kueri edge /top_media atau /recent_media dan sertakan ID Akun Bisnis untuk mendapatkan koleksi objek media yang memiliki tagar "#coke". Contoh:

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

Ini akan menampilkan tanggapan yang terlihat seperti ini:

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