API pencarian hashtag Instagram: menemukan postingan berdasarkan hashtag
Pencarian hashtag Instagram menemukan foto dan video publik yang memuat hashtag, dalam dua panggilan. GET /ig_hashtag_search dengan user_id dan q mengembalikan ID hashtag, lalu GET /<HASHTAG_ID>/top_media menampilkan postingan paling populer dan /recent_media postingan yang dipublikasikan dalam 24 jam terakhir. Sebuah akun dapat membuat kueri 30 hashtag unik dalam 7 hari bergulir, dengan Facebook Login atau Unified Login.
easyCoexistence menghubungkan Instagram dengan Instagram Login, sehingga Claude, ChatGPT, atau kode Anda sendiri dapat bekerja dengan postingan, komentar, sebutan, dan insight milik akun melalui API resmi Meta, serta komentar dan sebutannya dapat diteruskan ke endpoint Anda saat masuk.
Hashtag unik yang dapat dikueri oleh satu akun bisnis atau kreator dalam periode 7 hari bergulir.
recent_media hanya mengembalikan media yang dipublikasikan dalam 24 jam sebelum kueri.
Jumlah hasil per halaman dari top_media paling banyak, dan paginasinya hanya memakai after cursor.
Dalam perbandingan Meta atas tiga pengaturan, pencarian hashtag dengan Instagram Login tidak didukung.
ID hashtag bersifat statis dan global: sebuah hashtag memiliki ID yang sama untuk setiap aplikasi dan pengguna.
Bagaimana cara kerja pencarian hashtag?
Dalam dua langkah, dilakukan atas nama akun bisnis atau kreator Instagram yang ID-nya dimasukkan ke user_id. GET /ig_hashtag_search dengan q berisi nama hashtag mengembalikan ID-nya, yang menurut Meta bersifat statis dan global sehingga dapat disimpan. Lalu GET /<HASHTAG_ID>/top_media atau /recent_media, dengan user_id dan field, menampilkan postingannya.
GET /ig_hashtag_search?user_id=<IG_ID>&q=coffee
{ "data": [ { "id": "<HASHTAG_ID>" } ] }
GET /<HASHTAG_ID>/recent_media
?user_id=<IG_ID>
&fields=id,media_type,permalink,timestamp,like_count,comments_countApa perbedaan top_media dan recent_media?
top_media mengembalikan foto dan video paling populer yang diberi hashtag, dengan popularitas yang dinilai Meta dari campuran tayangan dan interaksi penonton. recent_media mengembalikan media yang paling baru dipublikasikan, dibatasi pada media yang dipublikasikan dalam 24 jam sebelum kueri, dan Meta mencatat bahwa responsnya tidak selalu berurutan secara kronologis. Keduanya hanya mengembalikan media publik, tidak menyertakan media promosi, media yang di-boost, dan media iklan, serta berpindah halaman 50 hasil setiap kali dengan after cursor.
Field apa saja yang dikembalikan?
Field media yang tercantum dalam referensi Meta untuk kedua edge, yang hanya mengembalikan foto dan video publik:
- id,
media_type(CAROUSEL_ALBUM, IMAGE atau VIDEO), permalink dan timestamp. - caption dan
comments_count, sertalike_countkecuali pemilik menyembunyikan jumlah suka. - children untuk media album, dan
media_urluntuk media lain, namun tidak untuk video dengan audio berhak cipta atau berlisensi. - Bukan username: Meta tidak mengizinkannya pada media yang dikembalikan oleh pencarian hashtag.
Apa batasannya?
Meta menetapkannya per akun dan per hashtag:
- 30 hashtag unik dalam 7 hari bergulir. Sebuah hashtag dihitung sejak kueri pertamanya; mengulang kueri hashtag yang sama dalam periode itu tidak dihitung dan tidak memulai ulang 7 harinya.
- Mengambil
top_mediaataurecent_mediadihitung sebagai kueri hashtag, meskipun ID-nya sudah tersimpan. - GET /<
IG_ID>/recently_searched_hashtagsmenampilkan hashtag unik yang telah dicari akun dalam minggu berjalan. - Hashtag pada Stories dan emoji dalam kueri tidak didukung, dan hashtag yang dinilai Meta sensitif atau menyinggung mengembalikan kesalahan umum.
- Media yang ditemukan dengan cara ini tidak dapat dikomentari melalui API.
Apa yang dibutuhkan pencarian hashtag?
Persetujuan App Review untuk fitur Instagram Public Content Access dan izin instagram_basic, yang disyaratkan Meta sebelum aplikasi dapat memakainya, serta token akses pengguna dari Facebook Login milik orang yang dapat menjalankan tugas di Halaman yang tertaut, atau token Unified Login. Ikhtisar Meta mencantumkan pencarian hashtag tidak didukung dengan Instagram Login, dan panggilannya tunduk pada pembatasan laju Platform Meta, bukan anggaran panggilan per akun Instagram. Penggunaan yang diizinkan Meta antara lain menemukan konten dari kampanye hashtag Anda, memahami sentimen publik tentang merek Anda, dan mengidentifikasi peserta kontes.
Bisakah mencari hashtag melalui easyCoexistence?
easyCoexistence menghubungkan Instagram dengan Instagram Login, yang menjangkau postingan, komentar, sebutan, dan insight milik akun yang terhubung. Meta menawarkan pencarian hashtag hanya dengan Facebook Login dan Unified Login, sehingga berada di luar koneksi ini. Yang dicakup koneksi sebagai gantinya: postingan milik akun melalui list_social_posts, serta komentar dan sebutannya, yang diteruskan ke endpoint Anda saat masuk.
Kesalahan umum
- Menghabiskan kuota mingguan untuk uji coba. Setiap hashtag baru dihitung ke 30 untuk 7 hari, dan mengambil medianya dihitung meskipun ID-nya sudah tersimpan.
- Meminta username pada hasil hashtag. Meta tidak mengembalikannya untuk media yang ditemukan melalui pencarian hashtag.
- Membaca recent_media sebagai arsip. Hasilnya mencakup media yang dipublikasikan dalam 24 jam sebelum kueri, dan tidak selalu berurutan secara kronologis.
- Memanggilnya dengan token Instagram Login. Meta menandai pencarian hashtag tidak didukung dalam pengaturan itu.
US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring penambahan koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Bisakah API Instagram mencari hashtag tanpa App Review?
Tidak. Meta mewajibkan persetujuan App Review untuk fitur Instagram Public Content Access dan instagram_basic sebelum aplikasi dapat memanggil pencarian hashtag.
Bisakah saya melihat siapa yang memposting dengan hashtag?
Tidak dengan username, yang tidak disertakan Meta dalam hasil hashtag. Permalink setiap postingan membukanya di Instagram.
Apakah pencarian hashtag menyertakan Stories?
Tidak. Meta tidak mendukung hashtag di Stories, dan kedua edge hanya mengembalikan foto dan video publik.
Apakah mengulang kueri hashtag yang sama dihitung dua kali?
Tidak. Kueri ulang dalam 7 harinya tidak dihitung ke 30 dan tidak memulai ulang timer hashtag.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada