Instagram Stories
Le storie di Instagram sono foto e video che un account condivide per 24 ore, spesso con uno sticker link, un account taggato o un’offerta a tempo che non arriva mai nel feed principale. Salvarle mentre sono attive offre ai team di brand, marketing e ricerca una traccia di lanci, promozioni e attività dei creator che altrimenti scomparirebbe.
Funzionalità della Instagram Stories API
- Tutto ciò che l’account ha onlineUn solo nome utente restituisce tutte le storie che l’account ha online nel momento in cui invii la richiesta.
- Contenuti pronti da archiviareOgni storia include l’URL dell’immagine o del video, larghezza e altezza e un’immagine di copertina, così il contenuto può essere archiviato o rivisto in seguito.
- Quando è stata pubblicata e quando scadeL’orario di pubblicazione arriva in published_at e quello di scadenza in extra.expires_at, che ti dice esattamente quanto tempo hai prima della raccolta successiva.
- Link e menzioni restano con la storiaLe destinazioni degli sticker link sono elencate in extra.link_urls e gli account taggati in extra.mentions, associati alla storia che li conteneva.
Parametri della Instagram Stories API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
username | Obbligatorio | Nome utente dell’account Instagram pubblico di cui vuoi le storie attuali. La @ iniziale è facoltativa. |
Come usare la Instagram Stories API
Invia un nome utente, attendi che l’attività termini e leggi le storie dal risultato.
- Scegli l’account pubblico che vuoi controllare, per esempio natgeo.
- Invia con POST {"username": "natgeo"} a /v1/instagram/stories e conserva il task_id della risposta.
- Chiama GET /v1/tasks/{task_id} ogni pochi secondi finché status è succeeded.
- Leggi le storie in results.items; quando results.has_more è true, passa results.next_cursor per ottenere la pagina successiva.
curl -X POST "https://api.socq.ai/v1/instagram/stories" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"natgeo"}'
# The response contains a task_id.
# GET /v1/tasks/{task_id} returns the stories once status is succeeded.Casi d’uso della Instagram Stories API
- Archivio giornaliero delle storie: Raccogli le storie di un brand una o due volte al giorno e conserva contenuti e orari di pubblicazione, così ogni storia resta consultabile dopo la scadenza.
- Monitoraggio delle promozioni: Segui gli URL degli sticker link che i concorrenti aggiungono alle storie per vedere quali prodotti, saldi e landing page stanno spingendo questa settimana.
- Verifica delle campagne con i creator: Confronta orario, contenuti e sticker link della storia di un creator con il brief per confermare che la storia concordata sia andata online.
Consigli degli esperti per la Instagram Stories API
- Pianifica le esecuzioni a meno di 24 ore di distanza, così ogni storia viene acquisita almeno una volta mentre è attiva.
- Scarica subito dopo la raccolta le immagini e i video che vuoi conservare, perché i link ai contenuti delle storie sono indirizzi CDN temporanei.
- Quando raccogli di nuovo lo stesso account, usa l’id della storia per saltare quelle che hai già salvato.
- Per le storie che un account tiene nel proprio profilo, usa Instagram Story Highlights e Instagram Highlight Items.
API correlate
Oltre alla Instagram Stories API, usa queste API quando ti serve un altro tipo di dati pubblici di Instagram.
- Instagram Posts API — Raccoglie post pubblici, media, hashtag, menzioni, date ed engagement a partire dal nome utente.
- Instagram Reels API — Raccoglie Reels pubblici, media, audio, hashtag, menzioni ed engagement a partire dal nome utente.
- 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 Story Highlights API — Elenca i contenitori pubblici delle storie in evidenza per nome utente con titoli, contesto del proprietario, numero di media e ID riutilizzabili.
- Instagram Similar Accounts API — Elenca gli account che Instagram suggerisce come simili a un nome utente, con nomi utente, nomi, avatar e stato di verifica.
- Instagram Followers Count API
- Instagram Search API
- Instagram Comments API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Trending Reels 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