API-ul de căutare a hashtag-urilor Instagram: găsirea postărilor
Căutarea după hashtag de pe Instagram găsește fotografii și videoclipuri publice care au un hashtag, în două apeluri. GET /ig_hashtag_search cu user_id și q returnează ID-ul hashtag-ului, apoi GET /<HASHTAG_ID>/top_media listează cele mai populare postări, iar /recent_media pe cele publicate în ultimele 24 de ore. Un cont poate interoga 30 de hashtag-uri unice într-o perioadă glisantă de 7 zile, cu Facebook Login sau Unified Login.
easyCoexistence conectează Instagram prin Instagram Login, astfel că Claude, ChatGPT sau propriul dumneavoastră cod lucrează cu propriile postări, comentarii, mențiuni și statisticile contului, prin API-ul oficial al Meta, iar comentariile și mențiunile pot fi transmise către endpoint-ul dumneavoastră pe măsură ce sosesc.
Hashtag-urile unice pe care un cont de firmă sau de creator le poate interoga într-o perioadă glisantă de 7 zile.
recent_media returnează doar conținutul media publicat în cele 24 de ore dinaintea interogării.
Cel mai mare număr de rezultate pe pagină vine de la top_media, care se parcurge doar cu un after cursor.
Căutarea după hashtag cu API-ul Instagram prin Instagram Login, în comparația Meta dintre cele trei configurații.
ID-urile hashtag-urilor sunt statice și globale: un hashtag păstrează același ID pentru fiecare aplicație și utilizator.
Cum funcționează căutarea după hashtag?
În doi pași, făcuți în numele unui cont profesional de Instagram (de firmă sau de creator), al cărui ID se trece în user_id. GET /ig_hashtag_search cu q setat la numele hashtag-ului returnează ID-ul acestuia, pe care Meta îl numește static și global, deci poate fi stocat. Apoi GET /<HASHTAG_ID>/top_media sau /recent_media, cu user_id și fields, listează postările.
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_countCare este diferența dintre top_media și recent_media?
top_media returnează cele mai populare fotografii și videoclipuri etichetate cu hashtag-ul, popularitatea fiind judecată de Meta după un amestec de vizualizări și interacțiunea spectatorilor. recent_media returnează cele publicate cel mai recent, limitate la conținutul media publicat în cele 24 de ore dinaintea interogării, iar Meta notează că răspunsurile nu sunt întotdeauna în ordine cronologică. Ambele returnează doar conținut media public, exclud conținutul promovat, impulsionat și cel publicitar, și parcurg rezultatele câte 50 deodată, cu un after cursor.
Ce câmpuri se returnează?
Câmpurile media pe care referințele Meta le listează pentru ambele endpoint-uri, care returnează doar fotografii și videoclipuri publice:
- id,
media_type(CAROUSEL_ALBUM, IMAGE sau VIDEO), permalink și timestamp. - caption și
comments_count, pluslike_count, dacă proprietarul nu a ascuns numărul de aprecieri. - children pentru conținutul de tip album și
media_urlpentru celelalte tipuri, dar nu pentru videoclipurile cu audio protejat prin drepturi de autor sau cu licență. - Fără username: Meta nu permite acest câmp pe conținutul găsit prin căutarea după hashtag.
Care sunt limitele?
Meta le stabilește pe cont și pe hashtag:
- 30 de hashtag-uri unice într-o perioadă glisantă de 7 zile. Un hashtag se numără de la prima interogare; interogarea lui din nou în acest interval este gratuită și nu îi repornește cele 7 zile.
- Preluarea
top_mediasaurecent_mediase numără ca interogare a hashtag-ului, chiar dacă ID-ul lui este deja stocat. - GET /<
IG_ID>/recently_searched_hashtagslistează hashtag-urile unice pe care contul le-a căutat în săptămâna curentă. - Hashtag-urile din Stories și emoji-urile din interogări nu sunt acceptate, iar hashtag-urile pe care Meta le consideră sensibile sau ofensatoare returnează o eroare generică.
- Conținutul găsit în acest fel nu poate primi comentarii prin API.
Ce are nevoie căutarea după hashtag?
Aprobarea App Review pentru funcționalitatea Instagram Public Content Access și permisiunea instagram_basic, pe care Meta le cere înainte ca o aplicație să o poată folosi, plus un token de acces de utilizator din Facebook Login, pentru o persoană care poate efectua sarcini pe Pagina asociată, sau un token Unified Login. Prezentarea generală a Meta arată că, în cazul Instagram Login, căutarea după hashtag nu este acceptată, iar apelurile ei se supun limitelor de rată ale Meta Platform, nu bugetului de apeluri per cont al Instagram. Utilizările permise de Meta includ găsirea conținutului din campaniile dumneavoastră cu hashtag-uri, înțelegerea sentimentului public despre brandul dumneavoastră și identificarea participanților la concursuri.
Puteți căuta hashtag-uri prin easyCoexistence?
easyCoexistence conectează Instagram prin Instagram Login, care ajunge la propriile postări, comentarii, mențiuni și statisticile contului conectat. Meta oferă căutarea după hashtag doar cu Facebook Login și Unified Login, astfel că este în afara acestei conexiuni. Ce acoperă conexiunea în schimb: postările proprii ale contului prin list_social_posts, iar comentariile și mențiunile sale, transmise către endpoint-ul dumneavoastră pe măsură ce sosesc.
Greșeli frecvente
- Consumarea cotei săptămânale pe teste. Fiecare hashtag nou se numără în cei 30 din 7 zile, iar preluarea conținutului său se numără chiar și cu un ID stocat.
- Solicitarea username la rezultatele hashtag-urilor. Meta nu îl returnează pentru conținutul găsit prin căutarea după hashtag.
- Citirea recent_media ca pe o arhivă. Acoperă conținutul publicat în cele 24 de ore dinaintea interogării și nu în ordine cronologică strictă.
- Apelarea cu un token Instagram Login. Meta marchează căutarea după hashtag ca neacceptată în această configurație.
US$ 9 până la US$ 0,75 per conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Poate API-ul Instagram să caute hashtag-uri fără App Review?
Nu. Meta cere aprobarea App Review pentru funcționalitatea Instagram Public Content Access și pentru instagram_basic, înainte ca o aplicație să poată apela căutarea după hashtag.
Pot vedea cine a postat cu un hashtag?
Nu după username, deoarece Meta îl exclude din rezultatele după hashtag. Permalink-ul fiecărei postări o deschide pe Instagram.
Căutarea după hashtag include Stories?
Nu. Meta nu acceptă hashtag-uri în Stories, iar ambele endpoint-uri returnează doar fotografii și videoclipuri publice.
Interogarea aceluiași hashtag a doua oară se numără de două ori?
Nu. Interogările repetate în cele 7 zile nu se scad din cei 30 și nu repornesc cronometrul hashtag-ului.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la