API di ricerca hashtag di Instagram: trovare post per hashtag
La ricerca hashtag di Instagram trova foto e video pubblici con un hashtag, in due chiamate. GET /ig_hashtag_search con user_id e q restituisce l'ID dell'hashtag, poi GET /<HASHTAG_ID>/top_media elenca i post più popolari e /recent_media quelli pubblicati nelle ultime 24 ore. Un account può interrogare 30 hashtag unici in un periodo mobile di 7 giorni, con Facebook Login o Unified Login.
easyCoexistence collega Instagram con Instagram Login, quindi Claude, ChatGPT o il tuo codice lavora sui post, i commenti, le menzioni e le statistiche dell'account tramite l'API ufficiale di Meta, e i suoi commenti e menzioni possono essere inoltrati al tuo endpoint non appena arrivano.
Hashtag unici che un account aziendale o creator può interrogare in un periodo mobile di 7 giorni.
recent_media restituisce solo i media pubblicati entro 24 ore dalla query.
top_media restituisce il maggior numero di risultati per pagina e pagina solo con il cursore after.
La ricerca hashtag con l'API di Instagram tramite Instagram Login, nel confronto di Meta tra le tre configurazioni.
Gli ID degli hashtag sono statici e globali: un hashtag mantiene lo stesso ID per ogni app e utente.
Come funziona la ricerca hashtag?
In due passaggi, eseguiti per conto di un account aziendale o creator di Instagram il cui ID va in user_id. GET /ig_hashtag_search con q impostato sul nome dell'hashtag restituisce il suo ID, che Meta indica come statico e globale, quindi può essere memorizzato. GET /<HASHTAG_ID>/top_media oppure /recent_media, con user_id e fields, elenca quindi i post.
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_countQual è la differenza tra top_media e recent_media?
top_media restituisce le foto e i video più popolari taggati con l'hashtag; Meta valuta la popolarità con un mix di visualizzazioni e interazioni degli utenti. recent_media restituisce i più recenti, limitati ai media pubblicati entro 24 ore dalla query, e Meta precisa che le risposte non sono sempre in ordine cronologico. Entrambi restituiscono solo media pubblici, escludono i media promossi, sponsorizzati e pubblicitari, e impaginano i risultati 50 alla volta con un cursore after.
Quali campi vengono restituiti?
I campi media che i riferimenti di Meta elencano per entrambi gli edge, che restituiscono solo foto e video pubblici:
- id,
media_type(CAROUSEL_ALBUM, IMAGE o VIDEO), permalink e timestamp. - caption e
comments_count, piùlike_counta meno che il proprietario non abbia nascosto i conteggi dei like. - children per i media album, e
media_urlper gli altri media, tranne i video con audio protetto da copyright o con licenza. - Non username: Meta non lo consente sui media restituiti dalla ricerca hashtag.
Quali sono i limiti?
Meta li imposta per account e per hashtag:
- 30 hashtag unici in 7 giorni mobili. Un hashtag conta dalla sua prima query; interrogarlo di nuovo in quel periodo è gratuito e non riavvia i suoi 7 giorni.
- Richiedere
top_mediaorecent_mediaconta come interrogare l'hashtag, anche quando il suo ID è già memorizzato. - GET /<
IG_ID>/recently_searched_hashtagselenca gli hashtag unici che l'account ha cercato nella settimana corrente. - Hashtag nelle Stories ed emoji nelle query non sono supportati, e gli hashtag che Meta giudica sensibili o offensivi restituiscono un errore generico.
- I media trovati in questo modo non possono ricevere commenti tramite l'API.
Di cosa ha bisogno la ricerca hashtag?
L'approvazione della App Review per la funzionalità Instagram Public Content Access e per il permesso instagram_basic, che Meta richiede prima che un'app possa usarla, e un token di accesso utente di Facebook Login per una persona che può svolgere attività sulla Pagina collegata, oppure un token Unified Login. La panoramica di Meta elenca la ricerca hashtag come non supportata con Instagram Login, e le sue chiamate rientrano nei limiti di frequenza della Platform di Meta, non nel budget di chiamate per account di Instagram. Gli usi consentiti elencati da Meta includono trovare contenuti delle campagne con hashtag, capire l'opinione pubblica sul brand e identificare i partecipanti ai concorsi.
È possibile cercare hashtag tramite easyCoexistence?
easyCoexistence collega Instagram con Instagram Login, che raggiunge i post, i commenti, le menzioni e le statistiche dell'account collegato. Meta offre la ricerca hashtag solo con Facebook Login e Unified Login, quindi è fuori da questa connessione. Ciò che la connessione copre invece: i post dell'account tramite list_social_posts, e i suoi commenti e menzioni, inoltrati al tuo endpoint non appena arrivano.
Errori comuni
- Consumare la quota settimanale nei test. Ogni nuovo hashtag conta nei 30 ogni 7 giorni, e recuperarne i media conta anche con un ID già memorizzato.
- Richiedere username nei risultati degli hashtag. Meta non lo restituisce per i media trovati tramite la ricerca hashtag.
- Leggere recent_media come un archivio. Copre i media pubblicati nelle 24 ore precedenti la query, e non in rigoroso ordine cronologico.
- Chiamarla con un token di Instagram Login. Meta indica la ricerca hashtag come non supportata in questa configurazione.
Da US$ 9 fino a US$ 0,75 per connessione al mese, in calo man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.
Domande frequenti
L'API di Instagram può cercare hashtag senza App Review?
No. Meta richiede l'approvazione della App Review per la funzionalità Instagram Public Content Access e per instagram_basic prima che un'app possa chiamare la ricerca hashtag.
Posso vedere chi ha pubblicato con un hashtag?
Non per username, che Meta esclude dai risultati degli hashtag. Il permalink di ogni post lo apre su Instagram.
La ricerca hashtag include le Stories?
No. Meta non supporta gli hashtag nelle Stories, ed entrambi gli edge restituiscono solo foto e video pubblici.
Interrogare di nuovo lo stesso hashtag conta due volte?
No. Le query ripetute entro i suoi 7 giorni non contano nei 30 e non riavviano il timer dell'hashtag.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il