Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

Instagram API za pretragu heštegova: pronalaženje objava po heštegu

Instagram pretraga heštegova pronalazi javne fotografije i video snimke sa heštegom, u dva poziva. GET /ig_hashtag_search sa user_id i q vraća ID heštega, zatim GET /<HASHTAG_ID>/top_media navodi najpopularnije objave, a /recent_media one koje su objavljene u poslednja 24 sata. Nalog može da pretraži 30 jedinstvenih heštegova u kliznom periodu od 7 dana, uz Facebook Login ili Unified Login.

easyCoexistence povezuje Instagram preko Instagram Login-a, pa Claude, ChatGPT ili vaš sopstveni kod radi nad sopstvenim objavama, komentarima, pominjanjima i uvidima naloga preko Metinog zvaničnog API-ja, a komentari i pominjanja mogu da se prosleđuju vašem endpointu čim stignu.

30

Jedinstveni heštegovi koje jedan poslovni ili kreatorski nalog može da pretraži u kliznom periodu od 7 dana.

24 hours

recent_media vraća samo medije objavljene u roku od 24 sata od upita.

50

Najviše rezultata po stranici vraća top_media, koja se pregleda samo pomoću after kursora.

Not supported

Pretraga heštegova preko Instagram API-ja sa Instagram Login-om, u Metinom poređenju tri varijante podešavanja.

Static

ID-jevi heštegova su statički i globalni: hešteg zadržava isti ID za svaku aplikaciju i korisnika.

Kako funkcioniše pretraga heštegova?

U dva koraka, u ime poslovnog ili kreatorskog naloga na Instagramu čiji ID ide u user_id. GET /ig_hashtag_search sa q postavljenim na naziv heštega vraća njegov ID, koji Meta navodi kao statički i globalan, pa može da se sačuva. Zatim GET /<HASHTAG_ID>/top_media ili /recent_media, sa user_id i fields, navodi objave.

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

Koja je razlika između top_media i recent_media?

top_media vraća najpopularnije fotografije i video snimke označene heštegom, pri čemu Meta popularnost procenjuje na osnovu mešavine pregleda i interakcije gledalaca. recent_media vraća najnovije objavljene, ograničene na medije objavljene u roku od 24 sata od upita, a Meta napominje da njeni odgovori nisu uvek hronološki poređani. Obe vraćaju samo javne medije, izostavljaju promovisane, pojačane i reklamne medije i listaju se po 50 rezultata, uz after kursor.

Koja polja se vraćaju?

Polja medija koja Metine reference navode za oba endpointa, a koje vraćaju samo javne fotografije i video snimke:

  • id, media_type (CAROUSEL_ALBUM, IMAGE ili VIDEO), permalink i timestamp.
  • caption i comments_count, uz like_count, osim ako vlasnik nije sakrio brojače lajkova.
  • children za medije u albumu, a media_url za ostale medije, ali ne i za video snimke sa zaštićenim ili licenciranim zvukom.
  • Ne username: Meta to ne dozvoljava za medije vraćene pretragom heštegova.

Koja su ograničenja?

Meta ih postavlja po nalogu i po heštegu:

  • 30 jedinstvenih heštegova u kliznom periodu od 7 dana. Hešteg se broji od prvog upita; ponovni upit u tom periodu je besplatan i ne resetuje njegovih 7 dana.
  • Dohvatanje top_media ili recent_media broji se kao upit za hešteg, čak i kada je njegov ID već sačuvan.
  • GET /<IG_ID>/recently_searched_hashtags navodi jedinstvene heštegove koje je nalog pretraživao u tekućoj nedelji.
  • Heštegovi na Stories i emotikoni u upitima nisu podržani, a heštegovi koje Meta smatra osetljivim ili uvredljivim vraćaju opštu grešku.
  • Na medije pronađene ovim putem ne može se komentarisati preko API-ja.

Šta je potrebno za pretragu heštegova?

Odobrenje App Review za funkciju Instagram Public Content Access i dozvolu instagram_basic, koje Meta zahteva pre nego što aplikacija može da je koristi, kao i korisnički pristupni token iz Facebook Login-a za osobu koja može da obavlja zadatke na povezanoj stranici, ili Unified Login token. U Metinom pregledu pretraga heštegova je navedena kao nepodržana uz Instagram Login, a njeni pozivi spadaju pod ograničenja učestalosti Platform-a, a ne pod Instagramov budžet poziva po nalogu. Dozvoljene namene koje Meta navodi uključuju pronalaženje sadržaja iz kampanja sa heštegovima, razumevanje javnog mišljenja o brendu i identifikovanje učesnika nagradnih igara.

Možete li da pretražujete heštegove preko easyCoexistence?

easyCoexistence povezuje Instagram preko Instagram Login-a, koji dopire do sopstvenih objava, komentara, pominjanja i uvida povezanog naloga. Meta nudi pretragu heštegova samo uz Facebook Login i Unified Login, pa je ona van ove veze. Veza umesto toga pokriva sopstvene objave naloga kroz list_social_posts, a njegove komentare i pominjanja prosleđuje vašem endpointu čim stignu.

Česte greške

  • Trošenje nedeljne kvote na testove. Svaki novi hešteg ulazi u 30 za 7 dana, a preuzimanje njegovih medija se računa čak i uz sačuvan ID.
  • Traženje username-a u rezultatima heštegova. Meta ga ne vraća za medije pronađene pretragom heštegova.
  • Čitanje recent_media kao arhive. Obuhvata medije objavljene u 24 sata pre upita, i to ne u strogo hronološkom redosledu.
  • Pozivanje sa Instagram Login tokenom. Meta u tom podešavanju označava pretragu heštegova kao nepodržanu.
Ovo radite uz EasyCoexistence

Od US$ 9 do US$ 0,75 po vezi mesečno, a cena pada kako dodajete veze, uz prva 3 dana besplatnog probnog perioda.

Često postavljana pitanja

Može li Instagram API da pretražuje heštegove bez App Review?

Ne. Meta zahteva odobrenje App Review za funkciju Instagram Public Content Access i instagram_basic pre nego što aplikacija može da pozove pretragu heštegova.

Mogu li da vidim ko je objavio sa heštegom?

Ne preko korisničkog imena, koje Meta izostavlja iz rezultata heštegova. Permalink svake objave otvara je na Instagramu.

Da li pretraga heštegova obuhvata Stories?

Ne. Meta ne podržava heštegove na Stories, a oba endpointa vraćaju samo javne fotografije i video snimke.

Da li ponovni upit za isti hešteg dva puta računa?

Ne. Ponovni upiti u okviru njegovih 7 dana ne računaju se u 30 i ne resetuju tajmer heštega.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na