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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
hashtags | Obbligatorio | Uno o più hashtag non vuoti, con o senza #, separati da virgole o da a capo. |
results_limit | Facoltativo | Numero massimo di record richiesti per hashtag; il valore predefinito è 100 e accetta interi da 10 a 2.000. |
published_within | Facoltativo | Finestra di pubblicazione facoltativa: hour, day, week, month o year. |
media_type | Facoltativo | Filtro 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.
- Prepara uno o più hashtag univoci, con o senza # iniziale.
- Invia con POST hashtags e i campi facoltativi results_limit, published_within e media_type a /v1/instagram/hashtag-posts.
- Interroga /v1/tasks/{task_id} finché lo status è succeeded o failed.
- 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 trueCasi 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.
API correlate
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.
- Instagram Followers Count API
- Instagram Posts API
- Instagram Reels API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Account Age Checker API