instagram/
stories

Raccogli le storie che un account Instagram pubblico sta mostrando in questo momento a partire dal suo nome utente, con immagine o video, orari di pubblicazione e di scadenza e sticker link di ogni storia.

Instagram Stories API

Input con nome utente
Storie attive
Sticker link
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 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

ParametriObbligatorioDescrizione
usernameObbligatorioNome 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.

  1. Scegli l’account pubblico che vuoi controllare, per esempio natgeo.
  2. Invia con POST {"username": "natgeo"} a /v1/instagram/stories e conserva il task_id della risposta.
  3. Chiama GET /v1/tasks/{task_id} ogni pochi secondi finché status è succeeded.
  4. 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.

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.

Esplora altre piattaforme

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

Instagram Stories API — FAQ

Instagram Stories API è un’interfaccia programmatica per raccogliere le storie che un account Instagram pubblico ha attualmente online, usando il suo nome utente come input. Restituisce per ogni storia ID e link, immagine o video, immagine di copertina, autore e orario di pubblicazione.

Sì. Invia il nome utente di un account pubblico e le sue storie tornano sotto forma di dati, senza bisogno di un accesso a Instagram da parte tua.

Quando una storia contiene uno sticker link, l’URL di destinazione dello sticker viene restituito in extra.link_urls per quella storia.

Le storie restano online per 24 ore, quindi raccoglierle una o due volte al giorno permette di acquisirle tutte mentre sono attive.

L’attività termina con un messaggio che indica che il profilo non è stato trovato e i crediti trattenuti per essa tornano sul tuo saldo.

Paghi 0,5 crediti per ogni storia restituita, e una richiesta che non trova storie attive non costa nulla.