API za pretraživanje hashtagova na Instagramu: pronalaženje objava prema hashtagu
Pretraga hashtagova na Instagramu pronalazi javne fotografije i videozapise s hashtagom u dva poziva. GET /ig_hashtag_search s user_id i q vraća ID hashtaga, zatim GET /<HASHTAG_ID>/top_media prikazuje najpopularnije objave, a /recent_media one objavljene u posljednja 24 sata. Račun može upitati 30 jedinstvenih hashtagova u kliznom razdoblju od 7 dana, uz Facebook Login ili Unified Login.
easyCoexistence povezuje Instagram putem Instagram Logina, pa Claude, ChatGPT ili vaš vlastiti kod rade s vlastitim objavama računa, komentarima, spominjanjima i analitikom putem Metinog službenog API-ja.
Jedinstveni hashtagovi koje jedan poslovni ili kreatorski račun može upitati u kliznom razdoblju od 7 dana.
recent_media vraća samo medije objavljene unutar 24 sata od upita.
Najviše rezultata po stranici vraća top_media, a stranice se dohvaćaju samo pomoću after kursora.
Pretraga hashtagova s Instagram API-jem uz Instagram Login, u Metinoj usporedbi triju načina postavljanja.
ID-ovi hashtagova su statični i globalni: hashtag zadržava isti ID za svaku aplikaciju i svakog korisnika.
Kako funkcionira pretraga hashtagova?
U dva koraka, u ime poslovnog ili kreatorskog računa na Instagramu čiji se ID upisuje u user_id. GET /ig_hashtag_search s q postavljenim na naziv hashtaga vraća njegov ID, za koji Meta kaže da je statičan i globalan, pa ga je moguće pohraniti. Zatim GET /<HASHTAG_ID>/top_media ili /recent_media, s user_id i fields, prikazuje objave.
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_countKoja je razlika između top_media i recent_media?
top_media vraća najpopularnije fotografije i videozapise označene hashtagom, pri čemu Meta popularnost procjenjuje prema mješavini pregleda i interakcije gledatelja. recent_media vraća najnovije objavljene, ograničene na medije objavljene u posljednja 24 sata od upita, a Meta napominje da njegovi odgovori nisu uvijek poredani kronološki. Oba vraćaju samo javne medije, isključuju promovirane, pojačane i oglasne medije te prikazuju rezultate u stranicama od po 50 uz after kursor.
Koja se polja vraćaju?
Polja medija koja Metine reference navode za oba rubna čvora, koji vraćaju samo javne fotografije i videozapise:
- id,
media_type(CAROUSEL_ALBUM, IMAGE ili VIDEO), permalink i timestamp. - caption i
comments_count, uzlike_countosim ako vlasnik nije sakrio broj sviđanja. - children za medije albuma, a
media_urlza ostale medije, ali ne za videozapise s autorski zaštićenim ili licenciranim zvukom. - Ne username: Meta to ne dopušta za medije vraćene pretragom hashtagova.
Koja su ograničenja?
Meta ih postavlja po računu i po hashtagu:
- 30 jedinstvenih hashtagova u kliznih 7 dana. Hashtag se broji od prvog upita, a ponovni upit u tom razdoblju je besplatan i ne pokreće ponovno njegovih 7 dana.
- Dohvat
top_mediailirecent_mediabroji se kao upit hashtaga, čak i kad je njegov ID već pohranjen. - GET /<
IG_ID>/recently_searched_hashtagsprikazuje jedinstvene hashtagove koje je račun pretraživao u tekućem tjednu. - Hashtagovi na pričama i emotikoni u upitima nisu podržani, a hashtagovi koje Meta smatra osjetljivima ili uvredljivima vraćaju opću pogrešku.
- Medije pronađene na ovaj način nije moguće komentirati putem API-ja.
Što je potrebno za pretragu hashtagova?
Odobrenje App Reviewa za značajku Instagram Public Content Access i dopuštenje instagram_basic, koje Meta zahtijeva prije nego što aplikacija može koristiti pretragu, te korisnički pristupni token iz Facebook Logina za osobu koja može obavljati zadatke na povezanoj stranici ili token iz Unified Logina. Metin pregled navodi da pretraga hashtagova nije podržana uz Instagram Login, a njezini pozivi podliježu Metinim ograničenjima stope za Platform, a ne ograničenjima poziva po računu na Instagramu. Dopuštene svrhe koje Meta navodi uključuju pronalaženje sadržaja iz vaših kampanja s hashtagovima, razumijevanje javnog mišljenja o vašem brendu i identifikaciju sudionika natječaja.
Možete li pretraživati hashtagove preko easyCoexistence?
easyCoexistence povezuje Instagram putem Instagram Logina, koji obuhvaća vlastite objave povezanog računa, komentare, spominjanja i analitiku. Meta nudi pretragu hashtagova samo uz Facebook Login i Unified Login, pa je ona izvan ove veze. Što veza obuhvaća umjesto toga: vlastite objave računa putem list_social_posts te njegove komentare i spominjanja, proslijeđene vašem endpointu čim stignu.
Uobičajene pogreške
- Trošenje tjedne kvote na testove. Svaki novi hashtag ubraja se u 30 za 7 dana, a dohvat njegovih medija broji se i uz pohranjen ID.
- Traženje polja username u rezultatima hashtagova. Meta ga ne vraća za medije pronađene pretragom hashtagova.
- Tretiranje recent_media kao arhive. Obuhvaća medije objavljene u 24 sata prije upita, a ne strogo kronološkim redom.
- Pozivanje s tokenom Instagram Logina. Meta u toj konfiguraciji označava pretragu hashtagova kao nepodržanu.
Komentari i spominjanja mogu se proslijediti vašem endpointu čim stignu. Od US$ 9 do US$ 0,75 po vezi mjesečno, uz sniženje kako dodajete veze, s besplatnim probnim razdobljem od 3 dana.
Često postavljana pitanja
Može li Instagram API pretraživati hashtagove bez App Reviewa?
Ne. Meta zahtijeva odobrenje App Reviewa za značajku Instagram Public Content Access i za instagram_basic prije nego što aplikacija može pozvati pretragu hashtagova.
Mogu li vidjeti tko je objavio s hashtagom?
Ne po korisničkom imenu, jer ga Meta izostavlja iz rezultata hashtagova. Permalink svake objave otvara je na Instagramu.
Uključuje li pretraga hashtagova priče?
Ne. Meta ne podržava hashtagove na pričama, a oba rubna čvora vraćaju samo javne fotografije i videozapise.
Broji li se ponovni upit istog hashtaga dvaput?
Ne. Ponovni upiti unutar njegovih 7 dana ne ubrajaju se u 30 i ne pokreću ponovno tajmer hashtaga.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na