Founder e manager parlano sempre più spesso nei video di LinkedIn invece di scrivere post lunghi. Demo di prodotto, interventi e riepiloghi dei risultati finiscono in video, e una pipeline che legge solo il testo dei post si perde ciò che vi viene detto.
Il 2026-11-17 SocQ ha aggiunto la LinkedIn Video Transcript API. Passa il link del post e la trascrizione torna dai sottotitoli associati al video, come testo semplice pronto da citare, riassumere o cercare. Questa guida tratta la richiesta, la risposta, il prezzo e come inserirla in un flusso di lavoro esistente su LinkedIn.
Risposta rapida: invia in
urlsgli URL dei post di LinkedIn che contengono un video aPOST /v1/linkedin/post-transcript. InterrogaGET /v1/tasks/{task_id}e leggi una riga per ogni video sottotitolato dadata.results.items, con il testo dei sottotitoli intext. Ogni trascrizione restituita costa 0.7 crediti ($0.0035).
Cosa restituisce l’endpoint
1 credito SocQ = $0.005.
| Endpoint | Cosa restituisce | Prezzo |
|---|---|---|
| LinkedIn Video Transcript API | Una riga per ogni video di LinkedIn sottotitolato: il testo dei sottotitoli come testo semplice, l’URL del post e, quando disponibili, lingua, formato e durata della trascrizione | 0.7 crediti ($0.0035) per trascrizione restituita |
L’addebito segue le trascrizioni restituite, quindi paghi i video sottotitolati che producono una riga.
Autenticazione e flusso asincrono delle attività
Tutte le richieste SocQ si autenticano con una chiave API, e lo stesso header vale per l’invio, lo stato dell’attività e le richieste dei risultati:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Ogni raccolta viene eseguita come attività in background:
submit -> task_id -> queued -> running -> succeeded
\-> failed
La risposta all’invio contiene data.task_id e data.status. Interroga l’attività con quell’ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Quando status è succeeded, la risposta include la prima pagina di record normalizzati in data.results.items. limit vale 50 per impostazione predefinita e arriva fino a 500; se has_more è true, passa results.next_cursor come cursor per leggere la pagina successiva. Mentre un’attività è queued, running o failed, l’endpoint restituisce i metadati dell’attività senza results.
Un callback_url facoltativo nel corpo dell’invio fa sì che SocQ invii un’unica POST con un riepilogo al termine dell’attività; leggi i record con GET /v1/tasks/{task_id}. Un timeout lato client non annulla l’attività, quindi riprendi con lo stesso ID invece di pagare un duplicato. 402 indica crediti insufficienti; 429 indica che la chiave ha raggiunto un limite di frequenza o di crediti.
Richiedere la trascrizione di un video di LinkedIn
Inserisci in urls gli URL dei post di LinkedIn che contengono un video. Funzionano entrambe le forme di URL: /posts/... e /feed/update/urn:li:activity:....
curl -X POST "https://api.socq.ai/v1/linkedin/post-transcript" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://www.linkedin.com/posts/satyanadella_keeping-over-a-million-elevators-and-escalators-activity-7518982780551340032-z4go"
]
}'
SocQ può riservare crediti in base al numero di URL inviati e calcola l’addebito finale sul result_count effettivo al termine dell’attività, restituendo i crediti non utilizzati.
Capire il record della trascrizione
L’esempio della documentazione restituisce questa riga (testo abbreviato):
{
"id": "https://www.linkedin.com/posts/satyanadella_keeping-over-a-million-elevators-and-escalators-activity-7518982780551340032-z4go",
"platform": "linkedin",
"resource": "post-transcript",
"type": "transcript",
"url": "https://www.linkedin.com/posts/satyanadella_keeping-over-a-million-elevators-and-escalators-activity-7518982780551340032-z4go",
"published_at": null,
"collected_at": "2026-11-17T14:40:24.363764Z",
"text": "TKL Rate is one of the leading companies in global infrastructure and mobility. ...",
"language": null,
"format": "plaintext",
"duration_seconds": null
}
I campi:
ideurl: il post a cui appartiene la trascrizione. Usa l’URL come chiave di join con i dati dei tuoi post.text: la trascrizione dell’audio del video, ricavata dai suoi sottotitoli.language: la lingua della trascrizione, quando disponibile. Può esserenull, come nell’esempio, quindi rileva tu la lingua se la usi per instradare i dati.format: come è rappresentata la trascrizione. Nell’esempio èplaintext.duration_seconds: la durata del video, quando disponibile.collected_at: quando SocQ ha raccolto la riga.
Il testo proviene dai sottotitoli associati al video, quindi trattalo con la stessa cautela di qualsiasi sottotitolo: può contenere errori di riconoscimento, soprattutto nei nomi di persone e aziende. Citalo insieme al link al post. Schema completo: documentazione della LinkedIn Video Transcript API.
Inserirla in un flusso di lavoro su LinkedIn
L’endpoint di trascrizione lavora sugli URL dei post che hai già. Una pipeline tipica:
- Trova i post. Raccogli i post delle persone o delle aziende che segui con la LinkedIn Profile Posts API o la LinkedIn Company Posts API.
- Seleziona i post con video. Tieni i post che contengono un video.
- Recupera le trascrizioni. Invia quegli URL alla LinkedIn Video Transcript API.
- Unisci e indicizza. Collega ogni trascrizione al suo post tramite l’URL e indicizza insieme testo del post e trascrizione per ricerca, riassunti o retrieval-augmented generation.
Per una panoramica più ampia di dati su profili, aziende, post e offerte di lavoro, leggi come fare scraping di LinkedIn con un’API e il confronto tra API per lo scraping di LinkedIn. Se esegui la stessa pipeline per YouTube, la guida alle trascrizioni di YouTube approfondisce la gestione delle lingue e dei sottotitoli mancanti.
Casi d’uso
- Monitoraggio di manager e concorrenti. Trasforma ciò che i leader dicono in video in testo ricercabile, accanto ai loro post scritti.
- Riutilizzo dei contenuti. Estrai la trascrizione di un intervento o di una demo come bozza per un articolo, una newsletter o una card con citazione, con il link alla fonte.
- Ricerca commerciale e di mercato. Riassumi annunci di prodotto e storie di clienti che esistono solo in video.
- Archivi e RAG. Salva le trascrizioni con l’URL del post e
collected_at, così ogni risposta generata può citare la sua fonte.
Consigli per la produzione
- Elimina gli URL duplicati. Un post condiviso come link
/posts/...e come link/feed/update/urn:li:activity:...ha lo stesso ID di attività. Normalizza prima dell’invio per non pagare due volte. - Aspettati meno righe che URL. Solo i video sottotitolati restituiscono una riga. Segna gli altri come privi di trascrizione invece di riprovarli.
- Conserva il testo così come arriva. Salva il
textoriginale; fai pulizia e suddivisione in blocchi su una copia derivata. - Non inventare timestamp. Il formato dell’esempio è
plaintext. Cita il post, non una posizione temporale.
Domande frequenti (FAQ)
Che cos’è la LinkedIn Video Transcript API?
Un endpoint SocQ che riceve URL di post di LinkedIn con un video e restituisce come testo semplice le parole pronunciate nel video, ricavate dai sottotitoli associati.
Quali URL accetta?
URL di post di LinkedIn che contengono un video, nella forma /posts/... o /feed/update/urn:li:activity:.... Inviane più di uno nell’array urls.
Mi vengono addebitati i video senza sottotitoli?
L’addebito segue le trascrizioni restituite. Ogni video sottotitolato restituisce una riga e costa 0.7 crediti ($0.0035); un URL che non restituisce alcuna riga non aggiunge alcun costo per trascrizione.
Trascrive direttamente l’audio?
La trascrizione proviene dai sottotitoli associati al video. La documentazione non descrive un fallback di riconoscimento vocale per i video senza sottotitoli.
Quanto costano 1,000 trascrizioni?
A 0.7 crediti ciascuna, 1,000 trascrizioni costano 700 crediti, ovvero $3.50.
LINKEDIN API
Prova il flusso di lavoro con un URL pubblico di LinkedIn
Invia input pubblici e ricevi record normalizzati con un contesto di origine tracciabile.
Scopri le API di LinkedIn