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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
highlight_ids | Obbligatorio | Uno 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.
- 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.
- Invia con POST highlight_ids a /v1/instagram/highlight-items.
- Interroga /v1/tasks/{task_id} finché lo status è succeeded o failed.
- 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 trueCasi 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.
API correlate
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.
- Instagram Followers Count API
- Instagram Search API
- Instagram Comments API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Audio Reels API
- Instagram Post Info API
- Instagram Reels Search 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