instagram/
transcript

Estrai i record delle trascrizioni dagli URL di post e Reels pubblici di Instagram, con testo, lingua, formato, URL di origine e shortcode in una struttura normalizzata.

Instagram Transcript API

Trascrizioni di post e Reels
Testo semplice o WebVTT
Record collegati alla fonte
0,7 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 Transcript

I record di Instagram Transcript contengono testo ricavato dall’audio parlato nei post e nei Reels pubblici, con lingua, formato di output, URL di origine, shortcode e orario di raccolta. Questi record supportano la ricerca nei contenuti parlati, la revisione dell’accessibilità, l’indicizzazione dei contenuti e la ricerca collegata alle fonti.

Funzionalità della Instagram Transcript API

  • Più URL di origineInvia uno o più URL di post o Reels Instagram pubblici e ricevi i record delle trascrizioni per i contenuti multimediali che espongono parlato.
  • Risultati che tengono conto dei caroselliMantiene record di trascrizione separati quando un singolo post carosello produce più di una trascrizione multimediale.
  • Testo normalizzato e provenienzaRestituisce il testo della trascrizione con lingua, formato (testo semplice o WebVTT), URL di origine, identificatore del contenuto multimediale, shortcode e orario di raccolta.

Parametri della Instagram Transcript API

ParametriObbligatorioDescrizione
urlsObbligatorioUno o più URL di post o Reels Instagram pubblici, separati da virgole o a capo.

Come usare la Instagram Transcript API

Invia gli URL dei contenuti Instagram pubblici come attività asincrona, interroga il relativo ID attività e leggi tutti i record normalizzati delle trascrizioni con la paginazione a cursore.

  1. Prepara uno o più URL di post o Reels Instagram pubblici.
  2. Invia con POST l’array urls a /v1/instagram/transcript.
  3. Interroga /v1/tasks/{task_id} finché lo stato diventa succeeded o failed.
  4. Leggi /v1/tasks/{task_id}?limit=50, riconcilia zero o più record per ogni URL di input e segui results.next_cursor finché results.has_more è true.
curl -X POST "https://api.socq.ai/v1/instagram/transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.instagram.com/reel/DHsD6HGqJhp/"]}'

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

Casi d’uso della Instagram Transcript API

  • Ricerca nei contenuti parlati: Indicizza il testo delle trascrizioni con lingua, URL di origine e shortcode, così i post e i Reels pubblici selezionati si possono cercare per termini parlati.
  • Ricerca su post e Reels: Esamina il testo delle trascrizioni su un insieme curato di URL, conservando identificatori dei contenuti e orario di raccolta per i controlli sulle fonti.
  • Revisione di didascalie e accessibilità: Usa il testo restituito e i metadati del formato per preparare copie leggibili o verificare se i contenuti pubblici selezionati hanno record di parlato utilizzabili.

Consigli degli esperti per la Instagram Transcript API

  • Invia URL canonici di post o Reels pubblici e rimuovi i duplicati esatti prima di avviare un’attività, così ogni fonte prevista viene elaborata una sola volta.
  • Riconcilia i risultati per ID del record e non solo per URL, perché un contenuto senza parlato può non restituire alcun record e un singolo URL di carosello può restituirne diversi.
  • Differenzia l’analisi a valle in base a format; conserva i cue WebVTT quando conta la struttura temporale e tratta il testo semplice come testo non segmentato.
  • Usa collected_at per la provenienza della raccolta, perché created_at non viene popolato con l’orario di pubblicazione del contenuto Instagram.
  • Quando suddividi in blocchi il testo della trascrizione, conserva ID del record, URL di origine, shortcode, lingua, formato e collected_at in ogni segmento derivato.

Oltre alla Instagram Transcript 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 Tagged Posts API — Raccoglie i post pubblici che taggano i profili selezionati con autori, media, menzioni, contesto degli utenti taggati ed engagement.
  • Instagram Audio Reels API — Raccoglie i Reels pubblici a partire da un ID audio numerico noto con didascalie, creator, media, date, engagement visibile e contesto dell’audio di origine.
  • 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 Post Info API — Consulta URL pubblici noti di post, Reel o IGTV storici con didascalie, identità dell’autore, media, date, engagement visibile e contesto dell’input.

Esplora altre piattaforme

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

Instagram Transcript API — FAQ

Instagram Transcript API è un’interfaccia programmatica per estrarre i record delle trascrizioni dagli URL di post o Reels Instagram pubblici. Restituisce testo, lingua, formato testo semplice o WebVTT, URL di origine, identificatori dei contenuti, shortcode e orario di raccolta.

Invia un array urls non vuoto con URL di post o Reels Instagram pubblici. L’endpoint non accetta nomi utente, query né un singolo campo url.

No. Un contenuto senza parlato può non restituire alcun record di trascrizione, mentre un post carosello può produrne più di uno.

No. Questo endpoint accetta solo urls; la lingua viene restituita come metadato del record quando la fonte la espone.

format è plaintext, a meno che il contenuto della trascrizione restituito inizi con markup WebVTT: in quel caso è webvtt. I record possono includere anche text, language, ID, URL di origine, shortcode, created_at come null e collected_at.

La fatturazione è di 0,7 crediti per ogni record di trascrizione restituito, senza costo base. La stima usa il numero di URL inviati, mentre l’utilizzo finale segue i record effettivi, compresi più record di un singolo carosello.