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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
usernames | Obbligatorio | Nomi utente pubblici di Instagram senza @, separati da virgole o da a capo. |
results_limit | Facoltativo | Numero 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.
- Prepara uno o più nomi utente pubblici di Instagram senza @.
- Invia con POST usernames e un results_limit facoltativo a /v1/instagram/posts.
- Interroga /v1/tasks/{task_id} finché lo status è succeeded o failed.
- 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.
API correlate
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.
- Instagram Followers Count API
- Instagram Search API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Reels Search 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 Hashtag Search API
- Instagram Account Age Checker API