instagram/
highlight-items

Recupera gli elementi delle storie pubbliche da ID di storie in evidenza di Instagram noti, come record normalizzati con testo, identità dell’autore, metriche visibili, dettagli dei media e contesto di origine.

Instagram Highlight Items API

ID di storie in evidenza noti
Record degli elementi delle storie
Media e contesto di origine
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 Highlight Items

Gli elementi delle storie in evidenza di Instagram sono le storie salvate nelle storie in evidenza dei profili pubblici, con testo, identità dell’autore, riferimenti ai media, timestamp e segnali di engagement visibili. Questi record supportano inventari dei contenuti in evidenza, revisione dei media, report che tengono conto della fonte e confronti tra storie in evidenza note.

Funzionalità della Instagram Highlight Items API

  • Input di più storie in evidenzaInvia uno o più ID numerici di storie in evidenza, con una ricerca a monte per ogni identificatore fornito.
  • Record degli elementi delle storie normalizzatiRicevi in un’unica forma di record ID degli elementi, URL pubblici, testo del titolo o della didascalia, identità dell’autore, metriche visibili, metadati dei media e timestamp.
  • Attribuzione alla storia in evidenza di origineOgni elemento restituito conserva in extra.highlight_id l’ID della storia in evidenza inviato, così i record di più storie in evidenza restano distinguibili.

Parametri della Instagram Highlight Items API

ParametriObbligatorioDescrizione
highlight_idsObbligatorioUno o più ID di storie in evidenza di Instagram noti, rappresentati come stringhe numeriche non vuote, separati da virgole o da a capo.

Come usare la Instagram Highlight Items API

Invia ID di storie in evidenza noti come attività asincrona, interroga il relativo ID attività e leggi i record normalizzati salvati con la paginazione a cursore dei risultati.

  1. Prepara uno o più ID numerici attuali di storie in evidenza; se un ID non è noto, raccogli prima le Story Highlights per nome utente e leggi extra.highlight_id dal record contenitore restituito.
  2. Invia con POST highlight_ids a /v1/instagram/highlight-items.
  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 finché results.has_more è true.
# Replace the documented sample with a current highlight ID before running.
curl -X POST "https://api.socq.ai/v1/instagram/highlight-items" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"highlight_ids":["18067016518767507"]}'

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

Casi d’uso della Instagram Highlight Items API

  • Inventario dei contenuti delle storie salvate: Organizza ID degli elementi, testo, URL pubblici, riferimenti ai media e timestamp restituiti in un inventario verificabile delle storie in evidenza note.
  • Revisione dei media delle storie in evidenza: Esamina URL di immagini o video, miniature, dimensioni, durata, didascalie e contesto dell’autore per gli elementi delle storie attualmente esposti da ciascuna storia in evidenza.
  • Confronto tra storie in evidenza: Raggruppa i record per extra.highlight_id e confronta tipi di contenuto, orari di pubblicazione, autori e metriche visibili restituiti tra le storie in evidenza selezionate.

Consigli degli esperti per la Instagram Highlight Items API

  • Quando gli ID delle storie in evidenza non sono noti, chiama prima instagram/story-highlights per nome utente e usa extra.highlight_id dei risultati riusciti; questo endpoint non ricava gli ID dai nomi utente.
  • Rimuovi gli ID duplicati prima dell’invio, perché il collector esegue una ricerca indipendente per ogni valore fornito.
  • Non aggiungere results_limit: ogni ID di storia in evidenza produce gli elementi disponibili nella sua singola risposta a monte.
  • Usa resource per distinguere highlight-items da story-highlights, perché entrambe le famiglie di record normalizzati usano il tipo story.
  • Considera facoltativi testo, campi dell’autore, metriche, media, URL e timestamp, e accetta che elementi di storie non disponibili o rimossi non producano alcun record.
  • Segui results.next_cursor solo per leggere altri record salvati dell’attività; non continua la raccolta da Instagram.

Oltre alla Instagram Highlight Items 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 Transcript API — Estrae testo della trascrizione, lingua, formato, URL della fonte e shortcode dagli URL pubblici di post o Reels.
  • 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.

Esplora altre piattaforme

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

Instagram Highlight Items API — FAQ

Instagram Highlight Items API è un’interfaccia programmatica per recuperare gli elementi delle storie pubbliche da ID numerici noti di storie in evidenza di Instagram. Restituisce identità normalizzata degli elementi, testo, autori, metriche visibili, metadati dei media, timestamp e contesto della storia in evidenza di origine.

Usa un ID attuale noto di storia in evidenza oppure raccogli prima le Story Highlights per nome utente. I risultati riusciti di instagram/story-highlights espongono l’identificatore di origine come extra.highlight_id quando è disponibile; questo endpoint non accetta nomi utente.

Un elemento normalizzato può contenere ID, URL, testo, ID dell’autore, nome utente e nome, metriche visibili, metadati di immagini o video, created_at, collected_at ed extra.highlight_id. La disponibilità dei campi segue la risposta pubblica a monte.

Non viene accettato alcun results_limit e il collector esegue una richiesta a monte per ogni ID di storia in evidenza. L’endpoint dei risultati dell’attività può comunque paginare i record salvati con limit e results.next_cursor.

Una storia in evidenza può non contenere record attualmente esposti, oppure i suoi elementi possono essere stati rimossi, limitati, resi privati o diventare non disponibili. L’attività salva solo i record presenti nella risposta pubblica attuale.

La fatturazione è di 0,5 crediti per ogni record normalizzato restituito, senza costo base. La stima usa 20 record per ogni ID di storia in evidenza inviato, mentre l’utilizzo finale segue i record effettivamente restituiti.