instagram/
hashtag-posts

Raccogli i post pubblici di Instagram per uno o più hashtag, con dettagli dell’autore, didascalie, media, hashtag di origine, timestamp e metriche di engagement visibili.

Instagram Hashtag Posts API

Scoperta per hashtag
Record dei post
Filtri per tempo e media
0,5 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

Instagram Hashtag Posts

I post di Instagram per hashtag sono foto o Reels pubblici associati a un hashtag cercato, con didascalie, identità del creator, media, timestamp ed engagement visibile. Questi segnali di contenuto e provenienza supportano la scoperta di argomenti, il confronto tra hashtag, la ricerca sui creator e il monitoraggio in un intervallo di tempo definito.

Funzionalità della Instagram Hashtag Posts API

  • Raccolta per più hashtagInvia uno o più hashtag con o senza #, con results_limit applicato separatamente a ogni hashtag inviato.
  • Filtri per tempo e mediaLimita la scoperta all’ultima ora, giorno, settimana, mese o anno e scegli tutti i post oppure solo i Reels.
  • Record dei post normalizzatiRicevi in un’unica forma ID dei post, shortcode, URL canonici, didascalie, dettagli dell’autore, riferimenti ai media, hashtag, menzioni e timestamp.
  • Contesto di origine ed engagementConserva l’hashtag inviato che ha prodotto ogni record insieme al numero disponibile di Mi piace, commenti, visualizzazioni e riproduzioni.

Parametri della Instagram Hashtag Posts API

ParametriObbligatorioDescrizione
hashtagsObbligatorioUno o più hashtag non vuoti, con o senza #, separati da virgole o da a capo.
results_limitFacoltativoNumero massimo di record richiesti per hashtag; il valore predefinito è 100 e accetta interi da 10 a 2.000.
published_withinFacoltativoFinestra di pubblicazione facoltativa: hour, day, week, month o year.
media_typeFacoltativoFiltro sul contenuto; all include i tipi di post supportati e reels limita i risultati ai Reels.

Come usare la Instagram Hashtag Posts API

Invia gli hashtag come attività asincrona, interroga il relativo ID attività e leggi i record dei post normalizzati con la paginazione a cursore.

  1. Prepara uno o più hashtag univoci, con o senza # iniziale.
  2. Invia con POST hashtags e i campi facoltativi results_limit, published_within e media_type a /v1/instagram/hashtag-posts.
  3. Interroga /v1/tasks/{task_id} finché lo status è succeeded o failed.
  4. Leggi /v1/tasks/{task_id}?limit=50 e segui results.next_cursor finché results.has_more è true.
curl -X POST "https://api.socq.ai/v1/instagram/hashtag-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["travel","photography"],"results_limit":20,"published_within":"week","media_type":"all"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casi d’uso della Instagram Hashtag Posts API

  • Scoperta di contenuti per argomento: Costruisci dataset verificabili di post pubblici associati a hashtag di campagne, eventi, community o settori.
  • Confronto tra hashtag: Confronta engagement visibile e pattern di contenuto, mantenendo l’hashtag inviato che ha prodotto ogni record.
  • Monitoraggio dei Reels recenti: Combina una finestra di pubblicazione con il filtro solo Reels per esaminare contenuti brevi e tempestivi attorno a hashtag selezionati.
  • Arricchimento di creator e contenuti: Unisci identità del post, contesto dell’autore, didascalie, media e metriche visibili a record di ricerca, campagna o moderazione.

Consigli degli esperti per la Instagram Hashtag Posts API

  • Deduplica gli hashtag di input e usa un’unica grafia per ogni argomento; il collector elabora ogni valore inviato in modo indipendente.
  • Pianifica il volume per hashtag, perché results_limit si applica a ogni hashtag e non all’intera richiesta.
  • Usa insieme published_within e media_type quando un monitoraggio ricorrente richiede un intervallo di tempo e un tipo di contenuto coerenti.
  • Deduplica i risultati sovrapposti con ID dei post, shortcode o URL canonici stabili, conservando extra.hashtag per la provenienza.
  • Gestisci media, contatori, timestamp e altri campi pubblici come facoltativi, perché la disponibilità della fonte può variare da post a post.

Oltre alla Instagram Hashtag Posts API, usa queste API quando ti serve un altro tipo di dati pubblici di Instagram.

  • Instagram Search API — Cerca profili pubblici per parola chiave o handle con identità e segnali visibili dell’account.
  • Instagram Comments API — Raccoglie commenti pubblici, autori, date, Mi piace e risposte dagli URL dei post.
  • Instagram Profiles API — Recupera identità del profilo pubblico, bio, link, flag dell’account, categorie e conteggi visibili a partire dal nome utente.
  • Instagram Post Info API — Consulta URL pubblici noti di post, Reel o IGTV storici con didascalie, identità dell’autore, media, date, engagement visibile e contesto dell’input.
  • Instagram Reels Search API — Cerca Reels pubblici per testo con didascalie, creator, media, date, engagement visibile e contesto della query.
  • Instagram Hashtag Search API — Trova gli hashtag che corrispondono a una parola chiave, con nomi, ID, URL delle pagine degli hashtag e numero di post pubblici.

Esplora altre piattaforme

Combina i dati di Instagram con i dati pubblici delle altre piattaforme social supportate.

Instagram Hashtag Posts API — FAQ

Instagram Hashtag Posts API è un’interfaccia programmatica per recuperare i post pubblici di Instagram associati a uno o più hashtag inviati. Restituisce identità normalizzata dei post, didascalie, autori, media, timestamp, contesto dell’hashtag di origine e metriche di engagement visibili.

Invia un array hashtags non vuoto; i valori possono includere oppure omettere il # iniziale. results_limit accetta da 10 a 2.000, ha come valore predefinito 100 e si applica separatamente a ogni hashtag.

published_within accetta hour, day, week, month o year. media_type accetta all o reels, con all usato quando il campo è omesso.

Un risultato normalizzato può includere ID, shortcode, URL, didascalia, autore, media, hashtag, menzioni, created_at, collected_at, conteggi visibili di Mi piace, commenti, visualizzazioni e riproduzioni, oltre a extra.hashtag per l’input corrispondente.

La fatturazione è di 0,5 crediti per ogni record normalizzato restituito, senza costo base. Le stime moltiplicano il results_limit per hashtag per il numero di hashtag inviati; l’utilizzo finale segue i record effettivamente restituiti.