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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
usernames | Obbligatorio | Uno 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.
- Prepara uno o più nomi utente Instagram pubblici come handle e non come URL dei profili.
- Invia con POST usernames a /v1/instagram/story-highlights.
- Interroga /v1/tasks/{task_id} finché lo stato diventa succeeded o failed.
- 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 trueCasi 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.
API correlate
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.
- 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 Post Info API
- Instagram Reels Search API
- Instagram Trending Reels 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