YouTube: API danych | Dokumentacja API

# 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)

Odpytuj filmy YouTube, kanały, Shorts, komentarze, posty społeczności, wyniki wyszukiwania i metadane strumieni przez 34 uwierzytelnione punkty końcowe: 32 GET i 2 POST.

Uwierzytelnianie

Użyj klucza API API Hop w nagłówku uwierzytelnienia. Dostępność zależy od włączonych bram i uprawnień klucza API; sama dokumentacja nie potwierdza dostępności produkcyjnej.

http

Authorization: Bearer YOUR_API_KEY

Żądania i zadania napisów

Operacje GET używają parametrów zapytania bez treści żądania. Stream V3 używa POST z treścią application/json i bez parametrów zapytania; wysyłaj proxy_url tylko w tej treści. Segment wersji wybiera wersję interfejsu YouTube. Nieznane lub zdublowane pola są odrzucane. Zachowuj identyfikatory i kursory stronicowania jako ciągi znaków, także wartości większe niż bezpieczny zakres liczb JavaScript.

bash

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

Odpowiedzi

Synchroniczne punkty końcowe zachowują natywną odpowiedź JSON. Punkty końcowe napisów zwracają success, data.id, data.status, data.result i requestId. Poniższe przykłady są ilustracyjne, a nie wynikami na żywo.

json

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

Rozliczenia i stronicowanie

Dla żądań synchronicznych: ceny dotyczą udanego żądania, a nie zwróconej pozycji. Każda strona jest osobnym żądaniem. Większość operacji kosztuje $0.001. Dwa warianty wyszukiwania V2 kosztują $0.002; wariant strumienia V2 kosztuje $0.004. Sprawdź poszczególne punkty końcowe poniżej. Pierwszeństwo mają ceny indywidualne konta. Rabaty ilościowe dostawcy nie są automatycznie przenoszone. Nieudane wywołania dostawcy zwalniają rezerwację; błędy rozliczenia zwracają błąd i nie wywołują drugiego żądania do dostawcy.

Zadania napisów

POST https://api.apihop.ai/v1/youtube/web-v2/videos/captions zwraca HTTP 202 i identyfikator zadania platformy z Location: /v1/jobs/\{id\}. Odpytuj GET https://api.apihop.ai/v1/youtube/web-v2/videos/captions/result?job_id=\{id\} co 2–5 sekund. Zadanie może odczytać tylko jego właściciel w ramach najemcy. Zapytania o wynik są bezpłatne; utworzenie kosztuje katalogowo $0.008. Wynik bez napisów jest udany i płatny. Format ustala się przy tworzeniu (domyślnie srt); opcjonalny format wyniku musi być zgodny, inaczej zwracany jest HTTP 400. data.result pozostaje null do COMPLETED; zadania mogą zakończyć się jako FAILED. Te punkty końcowe pobierają istniejące napisy, a nie transkrypcje AI.

Jeśli przyjęcie zgłoszenia jest niepewne, żądanie nie jest powtarzane, a rezerwacja może pozostać zablokowana do 30-minutowego terminu zadania. Wynik dostawcy może pozostać oczekujący podczas uzgadniania rozliczenia. Przejściowy błąd odpytywania nie jest końcowym niepowodzeniem zadania.

json

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

Zakres i ograniczenia

Ścieżki web i web-v2 wybierają rodzinę interfejsu dostawcy. Stream V3 obsługuje pobieranie POST przez własne proxy HTTP ze stałym wyjściem. Punkty końcowe strumieni zwracają metadane i adresy URL, a nie pliki multimedialne lub gwarantowane pobrania. Opisy kanałów mogą wymagać drugiego osobno płatnego żądania z continuation_token. Nie ma automatycznych ponowień.

Stream V3 używa POST JSON przez HTTPS i kosztuje $0.003 za udane żądanie. Podaj video_id i proxy_url (http:// z jawnym portem i publicznym hostem); cele prywatne, pętli zwrotnej i link-local są zabronione. Zakoduj zastrzeżone znaki danych uwierzytelniających w URL. Użyj stałego wyjścia lub trwałej sesji proxy. itags domyślnie wynosi ["137", "140"]; niedostępne formaty kończą się błędem bez zastępowania. verify_download domyślnie wynosi false. Pobieraj przez tę samą sesję proxy i rzeczywisty publiczny adres IP wyjścia z streams[].download_headers. Udana ekstrakcja URL (HTTP 200) podlega opłacie nawet wtedy, gdy all_selected_streams_verified lub streams[].verified wynosi false. Weryfikacja próbkuje małe zakresy bajtów, a nie cały plik. Adresy URL i sesje proxy wygasają niezależnie; osobne strumienie audio i wideo połącz samodzielnie.

Opis punktów końcowych

Wybierz punkt końcowy i wyślij tylko jego udokumentowane pola. Gdy wymieniono alternatywy, podaj co najmniej jedno pole z każdej grupy. Wartości stronicowania muszą pochodzić z poprzedniej odpowiedzi; nie ma automatycznego stronicowania.

Pełny opis punktów końcowych

Błędy

Błędy platformy używają HTTP 400 dla nieprawidłowych parametrów, 401 dla nieprawidłowego uwierzytelnienia, 402 dla niewystarczających środków, 403 dla odmowy dostępu do bramy, 429 dla limitów częstotliwości i 5xx dla błędów usługi lub dostawcy. Zachowaj X-Request-Id do diagnozy. Nie traktuj HTTP 200 od dostawcy z kodem błędu biznesowego jako sukcesu.

Źródła

Listę punktów końcowych i ceny sprawdzono względem oficjalnego schematu i aktualnych metadanych cen 2026-10-31. Aktualne metadane mają pierwszeństwo przed sprzecznymi cenami w opisie.

TikHub · OpenAPI · Ceny