YouTube-Daten-API | API-Dokumentation

# YouTube Data API

Query YouTube videos, channels, Shorts, comments, community posts, search results and stream metadata through 34 authenticated endpoints: 32 GET and 2 POST.

## Authentication

Use your API Hop API key in the authorization header. Availability depends on enabled gateways and API key permissions; documentation alone does not confirm production availability.

```http
Authorization: Bearer YOUR_API_KEY
```

## Requests and caption tasks

GET operations use query parameters without a request body. Stream V3 uses POST with an application/json body and no query parameters; send proxy_url only in that body. The version segment selects the YouTube interface version. Unknown or duplicate fields are rejected. Keep identifiers and pagination cursors as strings, including values larger than JavaScript can safely represent as numbers.

```bash
curl --get "https://api.apihop.ai/v1/youtube/web/channels/id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_name=LinusTechTips"
```

## Responses

Synchronous endpoints preserve the native JSON response. Caption endpoints return success, data.id, data.status, data.result and requestId. The examples below are illustrative, not live results.

```json
{"code":200,"data":{"channel_id":"UCXuqSBlHAE6Xw-yeJA0Tunw"}}
```

## Billing and pagination

For synchronous requests: Prices are per successful request, not per returned item. Every page is a separate request. Most operations cost $0.001. The two V2 search variants cost $0.002; the V2 stream variant costs $0.004. See each endpoint below. Account-specific prices take precedence. Supplier volume discounts are not automatically passed through. Failed upstream calls release the reservation; settlement failures return an error and do not trigger a second upstream request.

## Caption tasks

POST https://api.apihop.ai/v1/youtube/web-v2/videos/captions returns HTTP 202 and a platform task ID, with Location: /v1/jobs/\{id\}. Query GET https://api.apihop.ai/v1/youtube/web-v2/videos/captions/result?job_id=\{id\} every 2–5 seconds. Only the owning tenant can read the task. Result queries are free; creation costs $0.008 at the list price. No-caption results are successful and billable. The format is fixed at creation (default srt); an optional result format must match or returns HTTP 400. data.result is null until COMPLETED; tasks may end as FAILED. These endpoints retrieve existing captions, not AI transcriptions.

If submission acceptance is uncertain, the request is not replayed and its reservation may remain held until the 30-minute task deadline. A supplier result may remain pending while settlement is reconciled. A transient polling error is not a terminal task failure.

```json
{"success":true,"data":{"id":"9007199254740993001","status":"PROCESSING","result":null},"requestId":"example"}
```

## Scope and limitations

The web and web-v2 paths select the upstream interface family. Stream V3 supports POST retrieval with your own fixed-exit HTTP proxy. Stream endpoints return metadata and URLs, not media files or guaranteed downloads. Channel descriptions may require a second separately billed request using continuation_token. No automatic retries are made.

Stream V3 uses POST JSON over HTTPS and costs $0.003 per successful request. Provide video_id and proxy_url (http:// with an explicit port and public host); private, loopback and link-local destinations are forbidden. URL-encode reserved characters in credentials. Use a fixed exit or sticky proxy session. itags defaults to ["137", "140"]; unavailable formats fail without substitution. verify_download defaults to false. Download through the same proxy session and actual public exit IP with streams[].download_headers. Successful URL extraction (HTTP 200) is billable even when all_selected_streams_verified or streams[].verified is false. Verification samples small byte ranges, not the complete file. URLs and proxy sessions expire independently; merge separate audio/video streams yourself.

## Reference

Select an endpoint and send only its documented fields. When alternatives are listed, provide at least one field from each group. Pagination values must come from the preceding response; there is no automatic pagination.

[Complete reference](https://apihop.ai/en/docs/api-reference/youtube/reference)

## Errors

Platform errors use HTTP 400 for invalid parameters, 401 for invalid authentication, 402 for insufficient credit, 403 for denied gateway access, 429 for rate limits, and 5xx for service or supplier failures. Keep X-Request-Id for troubleshooting. Do not treat an upstream HTTP 200 with a failed business code as success.

## Sources

The endpoint list and prices were checked against the official schema and live price metadata on 2026-10-31. Live metadata takes precedence over conflicting prose prices.

[TikHub](https://docs.tikhub.io/4592766m0) · [OpenAPI](https://api.tikhub.io/openapi.json) · [Prices](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info)

Fragen Sie YouTube-Videos, Kanäle, Shorts, Kommentare, Community-Beiträge, Suchergebnisse und Stream-Metadaten über 34 authentifizierte Endpunkte ab: 32 GET und 2 POST.

Authentifizierung

Verwenden Sie Ihren API Hop-API-Schlüssel im Autorisierungsheader. Die Verfügbarkeit hängt von aktivierten Gateways und Schlüsselberechtigungen ab; die Dokumentation bestätigt keine Produktionsfreigabe.

http

Authorization: Bearer YOUR_API_KEY

Anfragen und Untertitelaufträge

GET-Vorgänge verwenden Abfrageparameter ohne Anfragekörper. Stream V3 verwendet POST mit einem application/json-Körper ohne Abfrageparameter; proxy_url gehört ausschließlich in den Körper. Das Versionssegment wählt die YouTube-Schnittstellenversion. Unbekannte oder doppelte Felder werden abgelehnt. IDs und Seitencursor bleiben Zeichenfolgen, auch oberhalb des sicheren JavaScript-Ganzzahlbereichs.

bash

curl --get "https://api.apihop.ai/v1/youtube/web/channels/id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_name=LinusTechTips"

Antworten

Synchrone Endpunkte erhalten die ursprüngliche JSON-Antwort. Untertitelendpunkte liefern success, data.id, data.status, data.result und requestId. Die Beispiele sind illustrativ, keine Live-Ergebnisse.

json

{"code":200,"data":{"channel_id":"UCXuqSBlHAE6Xw-yeJA0Tunw"}}

Abrechnung und Seitennavigation

Für synchrone Anfragen: Abgerechnet wird je erfolgreicher Anfrage, nicht je Datensatz. Jede Seite ist eine separate Anfrage. Die meisten Operationen kosten $0.001. Die beiden V2-Suchvarianten kosten $0.002, die V2-Stream-Variante $0.004. Der Preis steht bei jedem Endpunkt. Kontospezifische Preise haben Vorrang. Mengenrabatte des Anbieters werden nicht automatisch weitergegeben. Fehlgeschlagene Anbieteranfragen geben die Reservierung frei; Abrechnungsfehler lösen keine zweite Anbieteranfrage aus.

Untertitelaufträge

POST https://api.apihop.ai/v1/youtube/web-v2/videos/captions liefert HTTP 202, eine Plattform-Auftrags-ID und Location: /v1/jobs/\{id\}. Fragen Sie GET https://api.apihop.ai/v1/youtube/web-v2/videos/captions/result?job_id=\{id\} alle 2–5 Sekunden ab. Nur der besitzende Mandant erhält Zugriff. Ergebnisabfragen sind kostenlos; Erstellung kostet laut Listenpreis $0.008. Ergebnisse ohne Untertitel gelten als erfolgreich und kostenpflichtig. Das Format wird bei Erstellung festgelegt (Standard srt); ein optionales format beim Abruf muss übereinstimmen, sonst folgt HTTP 400. data.result bleibt bis COMPLETED null; FAILED ist ebenfalls möglich. Es werden vorhandene Untertitel abgerufen, keine KI-Transkriptionen erstellt.

Ist die Annahme eines Auftrags ungewiss, wird er nicht erneut eingereicht; die Reservierung kann bis zur Auftragsfrist von 30 Minuten bestehen bleiben. Ein Anbieterergebnis kann während des Abrechnungsabgleichs ausstehen. Ein vorübergehender Abruffehler ist kein endgültiger Auftragsfehler.

json

{"success":true,"data":{"id":"9007199254740993001","status":"PROCESSING","result":null},"requestId":"example"}

Umfang und Grenzen

web und web-v2 wählen die Schnittstellenfamilie. Stream V3 unterstützt POST-Anfragen mit einem eigenen HTTP-Proxy mit fester Ausgangs-IP. Stream-Endpunkte liefern Metadaten und URLs, keine Mediendateien oder Downloadgarantie. Kanalbeschreibungen können eine zweite, separat berechnete Anfrage mit continuation_token benötigen. Es gibt keine automatischen Wiederholungen.

Stream V3 verwendet POST JSON über HTTPS und kostet $0.003 je erfolgreicher Anfrage. Übergeben Sie video_id und proxy_url (http:// mit explizitem Port und öffentlichem Host). Private, Loopback- und Link-Local-Ziele sind verboten; reservierte Zeichen in Zugangsdaten müssen URL-kodiert sein. Verwenden Sie eine feste Ausgangs-IP oder Sticky Session. itags ist standardmäßig ["137", "140"]; fehlende Formate werden nicht ersetzt. verify_download ist standardmäßig false. Laden Sie mit derselben Proxy-Sitzung, tatsächlichen öffentlichen Ausgangs-IP und streams[].download_headers herunter. Erfolgreiche URL-Ermittlung (HTTP 200) wird auch bei all_selected_streams_verified oder streams[].verified gleich false berechnet. Geprüft werden nur kleine Bytebereiche, nicht die gesamte Datei. URLs und Sitzungen laufen unabhängig ab; getrennte Audio- und Videoströme müssen Sie selbst zusammenführen.

Referenz

Senden Sie nur die dokumentierten Felder des gewählten Endpunkts. Bei Alternativgruppen ist mindestens ein Feld je Gruppe erforderlich. Seitencursor stammen aus der vorherigen Antwort; Seiten werden nicht automatisch abgerufen.

Vollständige Referenz

Fehler

HTTP 400 bezeichnet ungültige Parameter, 401 ungültige Authentifizierung, 402 unzureichendes Guthaben, 403 fehlenden Gateway-Zugriff, 429 Ratenbegrenzungen und 5xx Dienst- oder Anbieterfehler. Bewahren Sie X-Request-Id zur Fehleranalyse auf. HTTP 200 mit einem fehlerhaften Geschäftscode ist kein Erfolg.

Quellen

Endpunkte und Preise wurden am 2026-10-31 mit dem offiziellen Schema und aktuellen Preismetadaten abgeglichen. Aktuelle Metadaten haben bei widersprüchlichen Textangaben Vorrang.

TikHub · OpenAPI · Prices