instagram/
story-highlights

Raccogli i contenitori delle storie in evidenza pubbliche di Instagram a partire dai nomi utente, con titoli, identità del proprietario, contenuti multimediali, numero di elementi e ID riutilizzabili delle storie in evidenza.

Instagram Story Highlights API

Ricerca per nome utente
Contenitori delle storie in evidenza
ID riutilizzabili delle storie in evidenza
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 Story Highlights

Le storie in evidenza di Instagram sono raccolte di storie salvate sui profili pubblici, organizzate per titolo con contesto del proprietario, contenuto di copertina e numero di elementi. Questi record dei contenitori supportano inventari delle categorie dei profili, confronti tra account e selezione delle storie in evidenza per l’analisi dei singoli elementi.

Funzionalità della Instagram Story Highlights API

  • Inventario delle storie in evidenza di più profiliInvia uno o più nomi utente Instagram per elencare i contenitori delle storie in evidenza pubbliche esposti da ciascun account, mantenendo il contesto del proprietario.
  • Identità e contesto del contenitoreRicevi ID normalizzati delle storie in evidenza, titoli, URL, identità del proprietario, contenuti multimediali esposti direttamente, timestamp, conteggi pubblici e totali degli elementi riportati.
  • Passaggio al livello dei singoli elementiUsa extra.highlight_id per conservare il legame con il contenitore e passare gli ID numerici delle storie in evidenza ai flussi di raccolta dei singoli elementi.

Parametri della Instagram Story Highlights API

ParametriObbligatorioDescrizione
usernamesObbligatorioUno o più nomi utente Instagram pubblici come handle non vuoti; una @ iniziale viene accettata e rimossa prima della raccolta.

Come usare la Instagram Story Highlights API

Invia i nomi utente degli account pubblici come attività asincrona, interroga il relativo ID attività e leggi i contenitori normalizzati delle storie in evidenza con la paginazione a cursore dei risultati.

  1. Prepara uno o più nomi utente Instagram pubblici come handle e non come URL dei profili.
  2. Invia con POST usernames a /v1/instagram/story-highlights.
  3. Interroga /v1/tasks/{task_id} finché lo stato diventa succeeded o failed.
  4. Leggi data.results.items e segui results.next_cursor finché results.has_more è true.
curl -X POST "https://api.socq.ai/v1/instagram/story-highlights" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["instagram"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casi d’uso della Instagram Story Highlights API

  • Inventario delle categorie di un profilo pubblico: Organizza titoli delle storie in evidenza, identità del proprietario, URL e numero di contenuti multimediali in un inventario delle categorie di storie salvate visibili su un profilo.
  • Confronto delle storie in evidenza tra account: Confronta titoli dei contenitori, totali degli elementi riportati, riferimenti ai contenuti multimediali e timestamp disponibili tra i nomi utente pubblici inviati.
  • Selezione delle raccolte di storie: Usa extra.highlight_id insieme a titoli e media_count per selezionare i contenitori numerici delle storie in evidenza da cui recuperare poi i singoli elementi.

Consigli degli esperti per la Instagram Story Highlights API

  • Normalizza gli handle prima dell’invio, rimuovendo le @ iniziali e deduplicando i nomi utente risultanti, perché gli URL dei profili non vengono convertiti in handle.
  • Aspettati una richiesta di elenco delle storie in evidenza per ogni nome utente, senza results_limit né continuazione lato fornitore, quindi l’elenco di contenitori disponibile determina i record raccolti per ogni account.
  • Usa il next_cursor del risultato dell’attività solo per scorrere i record normalizzati salvati; non richiede a Instagram un’altra pagina di storie in evidenza.
  • Passa a instagram/highlight-items solo i valori numerici presenti di extra.highlight_id quando servono i singoli fotogrammi delle storie.
  • Considera i risultati vuoti come un possibile esito di assenza di storie in evidenza o di profilo non disponibile, ed evita ipotesi su contenuti multimediali, metriche, URL e timestamp facoltativi.

Oltre alla Instagram Story Highlights 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 Highlight Items API — Recupera le storie pubbliche salvate a partire da ID di storie in evidenza note, con testo, identità dell’autore, media, date, metriche visibili e contesto della fonte.
  • Instagram Stories API — Raccoglie le storie attualmente attive di un account pubblico a partire dal nome utente, con media delle storie, orari di pubblicazione e di scadenza.

Esplora altre piattaforme

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

Instagram Story Highlights API — FAQ

Instagram Story Highlights API è un’interfaccia programmatica per elencare i contenitori delle storie in evidenza pubbliche a partire dai nomi utente Instagram inviati. Restituisce ID normalizzati dei contenitori, titoli, identità del proprietario, contenuti multimediali, conteggi pubblici, numero di elementi e ID riutilizzabili delle storie in evidenza.

Invia un array non vuoto di handle di account Instagram. Una @ iniziale viene rimossa, ma gli URL dei profili non vengono trasformati in nomi utente, quindi normalizza e deduplica gli handle prima di inviarli.

No. Restituisce i contenitori delle storie in evidenza; usa un extra.highlight_id numerico presente con instagram/highlight-items quando ti servono i singoli elementi di storia in un contenitore.

Un record può includere ID del contenitore, URL, titolo, ID del proprietario, nome utente e nome, contenuti multimediali esposti direttamente, conteggi pubblici comuni, created_at, collected_at, extra.highlight_id ed extra.media_count.

Non sono implementati né un results_limit controllato da chi chiama né una continuazione lato fornitore. Ogni nome utente viene richiesto una sola volta, mentre cursor e limit sull’endpoint delle attività paginano soltanto i record normalizzati già salvati.

Un profilo pubblico può non avere storie in evidenza salvate, oppure l’account può essere privato, non disponibile o con restrizioni. Considera un’attività succeeded con un array items vuoto un esito valido senza risultati.

La fatturazione è di 0,5 crediti per ogni storia in evidenza normalizzata salvata, senza costo base. Le stime usano 20 risultati per ogni nome utente inviato, mentre l’utilizzo finale segue i record effettivamente salvati.