instagram/
posts

Raccogli i post pubblici di Instagram per uno o più nomi utente, con didascalie, dettagli dell’autore, media, hashtag, menzioni, timestamp ed engagement visibile normalizzati.

Instagram Posts API

Post
Metadati dei media
Dati pubblici
0,34 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 Posts

I post di Instagram sono pubblicazioni del feed con didascalie, contesto dell’autore, immagini o video, timestamp, hashtag, menzioni ed engagement visibile. Questi segnali di contenuto supportano la ricerca sui creator, la revisione delle campagne, l’analisi dei media e i report storici.

Funzionalità della Instagram Posts API

  • Raccolta dei post per nome utenteRaccogli i post pubblici di Instagram per uno o più nomi utente con un’unica forma di risposta normalizzata.
  • Riferimenti e dimensioni dei mediaRestituisce nei campi media normalizzati i riferimenti pubblici a media e miniature, le dimensioni e la durata dei video.
  • Record di foto e videoNormalizza i post pubblici di foto e video nella stessa struttura di risposta.
  • Campi di contenuto ed engagementInclude in ogni record del post testo della didascalia, identità dell’autore, orario di pubblicazione, metriche visibili, hashtag e menzioni.
  • Confine dei dati pubbliciTiene fuori dai limiti della risposta i contenuti privati, rimossi, limitati o visibili solo con l’accesso.

Parametri della Instagram Posts API

ParametriObbligatorioDescrizione
usernamesObbligatorioNomi utente pubblici di Instagram senza @, separati da virgole o da a capo.
results_limitFacoltativoNumero massimo di record che l’attività di raccolta deve richiedere. Deve essere un intero positivo.

Come usare la Instagram Posts API

Invia nomi utente pubblici 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ù nomi utente pubblici di Instagram senza @.
  2. Invia con POST usernames e un results_limit facoltativo a /v1/instagram/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 quando ci sono altri record.
curl -X POST "https://api.socq.ai/v1/instagram/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["natgeo"],"results_limit":25}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Casi d’uso della Instagram Posts API

  • Raccolta dei post dei profili: Raccogli i post pubblici di nomi utente Instagram selezionati in record normalizzati con riferimenti ai media e identificatori stabili.
  • Ricerca sui contenuti: Raccogli didascalie pubbliche, timestamp, hashtag e contatori di engagement visibili dei post esaminati dai team di ricerca o di analytics.
  • Flussi di archiviazione: Salva metadati pubblici dei post, riferimenti ai media, contesto dell’autore, URL di origine e orari di raccolta per code di revisione, sistemi di reportistica o record interni.
  • Controllo qualità delle campagne: Esamina i post pubblici restituiti per i nomi utente di creator o brand prima di unire i record selezionati ai dati della campagna.
  • Arricchimento dei contenuti dei profili: Unisci ID dei post, dettagli dell’autore, didascalie, riferimenti ai media e metriche visibili ai record esistenti di profili o campagne.

Consigli degli esperti per la Instagram Posts API

  • Invia i nomi utente senza il prefisso @ e mantieni piccoli i batch mentre convalidi un nuovo flusso di lavoro.
  • Metti in conto che alcuni record pubblici omettano riferimenti ai media, contatori o timestamp, a seconda della disponibilità della fonte.
  • Applica nuovi tentativi prudenti e backoff in caso di risposte 429, challenge o blocco temporaneo, invece di riprovare in modo aggressivo.
  • Usa Reels API per la raccolta dei Reel a livello di profilo, Search API per la scoperta e Comments API quando contano i thread di commenti pubblici.
  • Evita di progettare flussi di lavoro attorno ad account privati, storie, storie in evidenza o campi visibili solo con l’accesso.

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

  • Instagram Reels API — Raccoglie Reels pubblici, media, audio, hashtag, menzioni ed engagement a partire dal nome utente.
  • 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 Tagged Posts API — Raccoglie i post pubblici che taggano i profili selezionati con autori, media, menzioni, contesto degli utenti taggati ed engagement.
  • Instagram Transcript API — Estrae testo della trascrizione, lingua, formato, URL della fonte e shortcode dagli URL pubblici di post o Reels.
  • 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.

Esplora altre piattaforme

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

Instagram Posts API — FAQ

Instagram Posts API raccoglie i post accessibili pubblicamente per uno o più nomi utente Instagram. Restituisce didascalie, dettagli dell’autore, riferimenti ai media, hashtag, menzioni, timestamp e conteggi di engagement visibili, tutti normalizzati.

L’endpoint attuale accetta uno o più nomi utente pubblici. Non accetta come input della richiesta l’URL o lo shortcode di un singolo post.

Sì. Quando i risultati pubblici espongono i dati dei media, gli elementi normalizzati possono includere URL di immagini o video, miniature, dimensioni e durata dei video.

I campi comuni includono ID del post, shortcode, URL canonico, autore, didascalia, orario di pubblicazione, metriche visibili, riferimenti ai media, hashtag, menzioni e momento di raccolta.

No. I post privati, rimossi, limitati o visibili solo con l’accesso possono restituire dati limitati o nessun record, perché l’endpoint raccoglie solo risultati accessibili pubblicamente.

Può restituire riferimenti pubblici ai media quando sono esposti dai risultati pubblici. I client devono comunque gestire URL di media mancanti, in scadenza o con restrizioni, perché la disponibilità può variare in base al tipo di post e alla risposta della fonte.

Usa frequenze di richiesta prudenti, batch di nomi utente più piccoli, backoff dopo risposte 429 o challenge e riprova più tardi quando una fonte pubblica è temporaneamente non disponibile.