Gründer und Führungskräfte sprechen auf LinkedIn zunehmend per Video, statt lange Beiträge zu schreiben. Produktdemos, Vorträge und Zusammenfassungen von Quartalszahlen landen als Videos, und eine Pipeline, die nur den Beitragstext liest, verpasst, was darin gesagt wurde.
Am 2026-11-17 hat SocQ die LinkedIn Video Transcript API ergänzt. Übergeben Sie den Link zum Beitrag, und das Transkript kommt aus den Untertiteln des Videos zurück, als reiner Text, bereit zum Zitieren, Zusammenfassen oder Durchsuchen. Dieser Leitfaden behandelt die Anfrage, die Antwort, den Preis und wie Sie den Endpunkt in einen bestehenden LinkedIn-Workflow einbinden.
Kurze Antwort: Senden Sie LinkedIn-Beitrags-URLs mit Video in
urlsanPOST /v1/linkedin/post-transcript. Fragen SieGET /v1/tasks/{task_id}ab und lesen Sie eine Zeile pro Video mit Untertiteln ausdata.results.items, mit dem Untertiteltext intext. Jedes gelieferte Transkript kostet 0,7 Credits ($0,0035).
Was der Endpunkt liefert
1 SocQ-Credit = $0,005.
| Endpunkt | Was er liefert | Preis |
|---|---|---|
| LinkedIn Video Transcript API | Eine Zeile pro LinkedIn-Video mit Untertiteln: der Untertiteltext als reiner Text, die Beitrags-URL sowie Sprache, Format und Dauer des Transkripts, sofern verfügbar | 0,7 Credits ($0,0035) pro geliefertem Transkript |
Abgerechnet werden die gelieferten Transkripte. Sie zahlen also für Videos mit Untertiteln, die eine Zeile ergeben.
Authentifizierung und asynchroner Aufgabenablauf
Alle SocQ-Anfragen authentifizieren sich mit einem API-Schlüssel, und derselbe Header gilt für das Einreichen, den Aufgabenstatus und den Abruf der Ergebnisse:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Jede Erfassung läuft als Hintergrundaufgabe:
submit -> task_id -> queued -> running -> succeeded
\-> failed
Die Antwort auf das Einreichen enthält data.task_id und data.status. Fragen Sie die Aufgabe mit dieser ID ab:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Wenn status den Wert succeeded hat, enthält die Antwort die erste Seite normalisierter Datensätze in data.results.items. limit ist standardmäßig 50 und geht bis 500; ist has_more true, übergeben Sie results.next_cursor als cursor, um die nächste Seite zu lesen. Solange eine Aufgabe queued, running oder failed ist, liefert der Endpunkt Aufgabenmetadaten ohne results.
Mit einer optionalen callback_url im Anfragekörper sendet SocQ nach Abschluss der Aufgabe einen POST mit einer Aufgabenzusammenfassung; die Datensätze lesen Sie über GET /v1/tasks/{task_id}. Eine Zeitüberschreitung auf Client-Seite bricht die Aufgabe nicht ab. Setzen Sie deshalb mit derselben Aufgaben-ID fort, statt für ein Duplikat zu bezahlen. 402 bedeutet zu wenige Credits; 429 bedeutet, dass der Schlüssel ein Raten- oder Credit-Limit erreicht hat.
Ein Transkript eines LinkedIn-Videos anfragen
Geben Sie LinkedIn-Beitrags-URLs mit Video in urls an. Beide URL-Formen funktionieren: /posts/... und /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 kann Credits anhand der Zahl der eingereichten URLs reservieren und rechnet nach Abschluss der Aufgabe auf Basis des tatsächlichen result_count ab; nicht genutzte Credits werden zurückgegeben.
Den Transkript-Datensatz verstehen
Das Beispiel der Dokumentation liefert diese Zeile (Text gekürzt):
{
"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
}
Die Felder:
idundurl: der Beitrag, zu dem das Transkript gehört. Verwenden Sie die URL als Join-Schlüssel zurück zu Ihren Beitragsdaten.text: das Transkript der Tonspur des Videos, entnommen aus seinen Untertiteln.language: die Sprache des Transkripts, sofern verfügbar. Sie kann wie im Beispielnullsein; erkennen Sie die Sprache also selbst, wenn Sie danach routen.format: wie das Transkript dargestellt wird. Im Beispiel ist esplaintext.duration_seconds: die Videodauer, sofern verfügbar.collected_at: wann SocQ die Zeile erfasst hat.
Der Text stammt aus den Untertiteln des Videos. Behandeln Sie ihn daher mit derselben Sorgfalt wie jeden Untertitel: Er kann Erkennungsfehler enthalten, besonders bei Namen von Personen und Unternehmen. Zitieren Sie ihn mit einem Link zum Beitrag. Vollständiges Schema: Dokumentation der LinkedIn Video Transcript API.
In einen LinkedIn-Workflow einbinden
Der Transkript-Endpunkt arbeitet mit Beitrags-URLs, die Sie bereits haben. Eine typische Pipeline:
- Beiträge finden. Sammeln Sie Beiträge der Personen oder Unternehmen, denen Sie folgen, mit der LinkedIn Profile Posts API oder der LinkedIn Company Posts API.
- Videobeiträge auswählen. Behalten Sie die Beiträge, die ein Video enthalten.
- Transkripte abrufen. Senden Sie diese URLs an die LinkedIn Video Transcript API.
- Verknüpfen und indexieren. Verknüpfen Sie jedes Transkript per URL mit seinem Beitrag und indexieren Sie Beitragstext und Transkript gemeinsam für Suche, Zusammenfassung oder Retrieval-Augmented Generation.
Einen breiteren Überblick über Profil-, Unternehmens-, Beitrags- und Jobdaten bieten LinkedIn per API scrapen und der Vergleich der LinkedIn Scraper APIs. Wenn Sie dieselbe Pipeline für YouTube betreiben, behandelt der Leitfaden zu YouTube-Transkripten Sprachbehandlung und fehlende Untertitel ausführlicher.
Anwendungsfälle
- Beobachtung von Führungskräften und Wettbewerbern. Machen Sie das, was Führungskräfte im Video sagen, neben ihren schriftlichen Beiträgen durchsuchbar.
- Wiederverwertung von Inhalten. Nutzen Sie das Transkript eines Vortrags oder einer Demo als Entwurf für einen Blogbeitrag, einen Newsletter oder eine Zitatkarte, mit angehängtem Quelllink.
- Vertriebs- und Marktforschung. Fassen Sie Produktankündigungen und Kundengeschichten zusammen, die es nur als Video gibt.
- Archive und RAG. Speichern Sie Transkripte mit Beitrags-URL und
collected_at, damit jede generierte Antwort ihre Quelle zitieren kann.
Tipps für den Produktivbetrieb
- URLs deduplizieren. Ein Beitrag, der als
/posts/...-Link und als/feed/update/urn:li:activity:...-Link geteilt wird, trägt dieselbe Activity-ID. Normalisieren Sie vor dem Einreichen, damit Sie nicht doppelt zahlen. - Mit weniger Zeilen als URLs rechnen. Nur Videos mit Untertiteln liefern eine Zeile. Markieren Sie die übrigen als ohne Transkript, statt sie erneut zu versuchen.
- Den Text unverändert aufbewahren. Speichern Sie den originalen
text; Bereinigung und Chunking erledigen Sie in einer abgeleiteten Kopie. - Keine Zeitstempel erfinden. Das Format im Beispiel ist
plaintext. Zitieren Sie den Beitrag, nicht eine Zeitposition.
FAQ
Was ist die LinkedIn Video Transcript API?
Ein SocQ-Endpunkt, der LinkedIn-Beitrags-URLs mit Video entgegennimmt und die im Video gesprochenen Worte als reinen Text aus den zugehörigen Untertiteln liefert.
Welche URLs akzeptiert sie?
LinkedIn-Beitrags-URLs mit Video in der Form /posts/... oder /feed/update/urn:li:activity:.... Senden Sie mehrere im Array urls.
Werden Videos ohne Untertitel berechnet?
Abgerechnet werden die gelieferten Transkripte. Jedes Video mit Untertiteln liefert eine Zeile und kostet 0,7 Credits ($0,0035); eine URL ohne Zeile verursacht keine Gebühr pro Transkript.
Transkribiert sie die Tonspur selbst?
Das Transkript stammt aus den Untertiteln des Videos. Die Dokumentation beschreibt keinen Speech-to-Text-Ersatz für Videos ohne Untertitel.
Was kosten 1.000 Transkripte?
Bei 0,7 Credits pro Stück kosten 1.000 Transkripte 700 Credits, also $3,50.
LINKEDIN API
Workflow mit einer öffentlichen LinkedIn-URL testen
Senden Sie öffentliche Eingaben und erhalten Sie normalisierte Datensätze mit nachvollziehbarem Quellkontext.
LinkedIn-APIs ansehen