MasukMulai uji coba gratis
easyCoexistence API resmi

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.

30

Hashtag unik yang dapat dikueri oleh satu akun bisnis atau kreator dalam periode 7 hari bergulir.

24 hours

recent_media hanya mengembalikan media yang dipublikasikan dalam 24 jam sebelum kueri.

50

Jumlah hasil per halaman dari top_media paling banyak, dan paginasinya hanya memakai after cursor.

Not supported

Dalam perbandingan Meta atas tiga pengaturan, pencarian hashtag dengan Instagram Login tidak didukung.

Static

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.

Finding a hashtag's ID, then its recent posts
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_count

Apa 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, serta like_count kecuali pemilik menyembunyikan jumlah suka.
  • children untuk media album, dan media_url untuk 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_media atau recent_media dihitung sebagai kueri hashtag, meskipun ID-nya sudah tersimpan.
  • GET /<IG_ID>/recently_searched_hashtags menampilkan 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.
Melakukan ini dengan EasyCoexistence

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