Instagram hashtag arama API'si: gönderileri hashtag ile bulma
Instagram'ın hashtag araması, bir hashtag içeren herkese açık fotoğraf ve videoları iki çağrıyla bulur. user_id ve q ile GET /ig_hashtag_search, hashtag'ın ID'sini döndürür; ardından GET /<HASHTAG_ID>/top_media en popüler gönderileri, /recent_media ise son 24 saatte yayımlananları listeler. Bir hesap, Facebook Login veya Unified Login ile kayan 7 günlük dönemde 30 benzersiz hashtag sorgulayabilir.
easyCoexistence, Instagram'ı Instagram Login ile bağlar; böylece Claude, ChatGPT veya kendi kodunuz, Meta'nın resmi API'si üzerinden bağlı hesabın kendi gönderileri, yorumları, bahsetmeleri ve içgörüleri üzerinde çalışır; yorumlar ve bahsetmeler geldikleri anda uç noktanıza iletilebilir.
Bir işletme veya içerik üreticisi hesabının kayan 7 günlük dönemde sorgulayabileceği benzersiz hashtag sayısı.
recent_media yalnızca sorgu anından önceki 24 saat içinde yayımlanan medyayı döndürür.
top_media sayfa başına en fazla 50 sonuç döndürür; yalnızca after imleciyle sayfalanır.
Meta'nın üç kurulumu karşılaştırdığı özette, Instagram Login ile hashtag araması desteklenmiyor olarak gösterilir.
Hashtag ID'leri statiktir ve globaldir: bir hashtag her uygulama ve kullanıcı için aynı ID'yi korur.
Hashtag araması nasıl çalışır?
İki adımda çalışır ve ID'si user_id'ye yazılan bir Instagram işletme veya içerik üreticisi hesabı adına yapılır. q değeri hashtag'ın adına ayarlanmış GET /ig_hashtag_search, Meta'nın statik ve global olduğunu söylediği ID'yi döndürür; bu ID saklanabilir. Ardından user_id ve fields ile GET /<HASHTAG_ID>/top_media veya /recent_media, gönderileri listeler.
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_counttop_media ile recent_media arasındaki fark nedir?
top_media, hashtag ile etiketlenmiş en popüler fotoğraf ve videoları döndürür; Meta popülerliği izlenme ve izleyici etkileşiminin bir karışımına göre belirler. recent_media, en son yayımlananları döndürür; bunlar sorgu anından önceki 24 saatle sınırlıdır ve Meta, yanıtlarının her zaman kronolojik sırada olmadığını belirtir. İkisi de yalnızca herkese açık medyayı döndürür, tanıtılan, öne çıkarılan ve reklam medyasını dışarıda bırakır ve sonuçları after imleciyle sayfa başına 50 kayıt olacak şekilde sayfalar.
Hangi alanlar geri döner?
Meta'nın her iki uç için listelediği medya alanları, yalnızca herkese açık fotoğraf ve videoları döndürür:
- id,
media_type(CAROUSEL_ALBUM, IMAGE veya VIDEO), permalink ve timestamp. - caption ve
comments_count; sahibi beğeni sayısını gizlemediyselike_count. - Albüm medyası için children, diğer medya için
media_url; ancak telif hakkı korumalı veya lisanslı ses içeren videolar için değil. - username yok: Meta, hashtag araması ile bulunan medyada bunu izin vermez.
Sınırlar nelerdir?
Meta bunları hesap ve hashtag başına belirler:
- Kayan 7 günde 30 benzersiz hashtag. Bir hashtag ilk sorgulandığı andan itibaren sayılır; bu süre içinde yeniden sorgulamak ücretsizdir ve 7 günlük süreyi yeniden başlatmaz.
top_mediaveyarecent_mediaalmak, ID'si zaten saklanmış olsa bile hashtag'ı sorgulamak sayılır.- GET /<
IG_ID>/recently_searched_hashtags, hesabın bu hafta aradığı benzersiz hashtag'leri listeler. - Hikayelerdeki hashtag'ler ve sorgulardaki emojiler desteklenmez; Meta'nın hassas veya uygunsuz bulduğu hashtag'ler genel bir hata döndürür.
- Bu yolla bulunan medyaya API üzerinden yorum yapılamaz.
Hashtag araması neye ihtiyaç duyar?
Uygulamanın kullanabilmesi için Meta'nın gerektirdiği Instagram Public Content Access özelliği ve instagram_basic izni için App Review onayı, ayrıca bağlı Facebook Sayfası üzerinde görev yapabilen bir kişiden Facebook Login ile alınmış bir kullanıcı erişim token'ı ya da bir Unified Login token'ı gerekir. Meta'nın genel bakışı, hashtag aramasını Instagram Login ile desteklenmez olarak listeler ve çağrıları, Instagram'ın hesap başına çağrı bütçesi yerine Meta Platform hız sınırları kapsamına girer. Meta'nın listelediği izin verilen kullanımlar arasında hashtag kampanyalarınızdan içerik bulmak, markanız hakkındaki kamuoyu duyarlılığını anlamak ve yarışma katılımcılarını belirlemek yer alır.
easyCoexistence üzerinden hashtag arayabilir misiniz?
easyCoexistence, Instagram'ı Instagram Login ile bağlar; bu da bağlı hesabın kendi gönderilerine, yorumlarına, bahsetmelerine ve içgörülerine erişir. Meta hashtag aramasını yalnızca Facebook Login ve Unified Login ile sunar; bu yüzden bu bağlantının dışındadır. Bağlantının kapsadığı şeyler ise şunlardır: hesabın kendi gönderileri list_social_posts üzerinden, yorumları ve bahsetmeleri ise geldikleri anda uç noktanıza iletilir.
Yaygın hatalar
- Haftalık kotayı testlere harcamak. Her yeni hashtag 7 günlük 30 sınırına dahil edilir ve ID'si saklı olsa bile medyasını çekmek de sayılır.
- Hashtag sonuçlarında username istemek. Meta, hashtag araması ile bulunan medyada bunu döndürmez.
- recent_media'yı bir arşiv gibi okumak. Sorgudan önceki 24 saatte yayımlanan medyayı kapsar; kesin kronolojik sırada değildir.
- Instagram Login token'ı ile çağırmak. Meta, bu kurulumda hashtag aramasını desteklenmez olarak işaretler.
Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında, bağlantı ekledikçe düşer; ilk 3 gün ücretsizdir.
Sık sorulan sorular
Instagram API, App Review olmadan hashtag arayabilir mi?
Hayır. Uygulamanın hashtag aramasını çağırabilmesi için Meta, Instagram Public Content Access özelliği ve instagram_basic için App Review onayı şart koşar.
Bir hashtag ile kimin paylaşım yaptığını görebilir miyim?
Kullanıcı adıyla hayır; Meta bunu hashtag sonuçlarından çıkarır. Her gönderinin permalink alanı, onu Instagram'da açar.
Hashtag araması hikayeleri içerir mi?
Hayır. Meta hikayelerde hashtag'i desteklemez ve her iki uç da yalnızca herkese açık fotoğraf ve videoları döndürür.
Aynı hashtag'ı yeniden sorgulamak iki kez sayılır mı?
Hayır. 7 günlük süre içindeki tekrar sorgular 30 sınırına dahil edilmez ve hashtag'ın süresini yeniden başlatmaz.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi