YouTube veri API’si | API Belgeleri

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

32 GET ve 2 POST olmak üzere 34 kimlik doğrulamalı uç noktayla YouTube videolarını, kanallarını, Shorts içeriklerini, yorumlarını, topluluk gönderilerini, arama sonuçlarını ve akış meta verilerini sorgulayın.

Kimlik doğrulama

Yetkilendirme başlığında API Hop API anahtarınızı kullanın. Kullanılabilirlik, etkin ağ geçitlerine ve anahtar izinlerine bağlıdır; belgeler üretimde kullanılabilirliği doğrulamaz.

http

Authorization: Bearer YOUR_API_KEY

İstekler ve altyazı görevleri

GET işlemleri gövdesiz sorgu parametreleri kullanır. V3 akışı, sorgu parametresi olmadan application/json gövdeli POST kullanır; proxy_url yalnızca gövdede gönderilir. Sürüm bölümü YouTube arayüz sürümünü seçer. Bilinmeyen veya yinelenen alanlar reddedilir. Kimlikleri ve sayfalama imleçlerini, JavaScript güvenli tamsayı sınırını aşan değerler dahil, metin olarak saklayın.

bash

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

Yanıtlar

Senkron uç noktalar özgün JSON yanıtını korur. Altyazı uç noktaları success, data.id, data.status, data.result ve requestId döndürür. Örnekler açıklama amaçlıdır, canlı sonuç değildir.

json

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

Ücretlendirme ve sayfalama

Senkron istekler için: Ücret dönen öğe başına değil, başarılı istek başınadır. Her sayfa ayrı istektir. Çoğu işlem $0.001 tutarındadır. İki V2 arama çeşidi $0.002, V2 akış çeşidi $0.004 tutarındadır. Her uç noktanın fiyatı aşağıda belirtilmiştir. Hesaba özel fiyatlar önceliklidir. Sağlayıcının hacim indirimleri otomatik aktarılmaz. Sağlayıcı hataları rezervasyonu serbest bırakır; hesaplaşma hataları ikinci sağlayıcı isteği göndermez.

Altyazı görevleri

POST https://api.apihop.ai/v1/youtube/web-v2/videos/captions HTTP 202, platform görev kimliği ve Location: /v1/jobs/\{id\} döndürür. GET https://api.apihop.ai/v1/youtube/web-v2/videos/captions/result?job_id=\{id\} adresini 2–5 saniyede bir sorgulayın. Yalnızca görevin sahibi tenant erişebilir. Sonuç sorgulama ücretsizdir; oluşturmanın liste fiyatı $0.008 tutarındadır. Altyazı bulunmayan başarılı sonuçlar da ücretlendirilir. Biçim oluştururken sabitlenir (varsayılan srt); sorgudaki isteğe bağlı format eşleşmezse HTTP 400 döner. COMPLETED olana kadar data.result null kalır; FAILED ile de bitebilir. Mevcut altyazılar alınır, yapay zekâ ile transkripsiyon yapılmaz.

Gönderimin kabulü belirsizse istek tekrarlanmaz; rezervasyon görevin 30 dakikalık süresine kadar tutulabilir. Sağlayıcı sonucu, ücret mutabakatı sırasında beklemede kalabilir. Geçici sorgulama hatası görevin kesin olarak başarısız olduğu anlamına gelmez.

json

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

Kapsam ve sınırlar

web ve web-v2 arayüz ailesini seçer. V3 akışı, kendi sabit çıkışlı HTTP proxy’nizle POST isteklerini destekler. Akış uç noktaları medya dosyası veya indirme garantisi değil, meta veri ve URL döndürür. Kanal açıklamaları continuation_token ile ayrı ücretlendirilen ikinci bir istek gerektirebilir. Otomatik yeniden deneme yapılmaz.

V3 akışı HTTPS üzerinden POST JSON kullanır ve başarılı istek başına $0.003 tutarındadır. video_id ve proxy_url (açık port ve genel adresle http://) sağlayın. Özel, geri döngü ve bağlantı yerel adresleri yasaktır; kimlik bilgilerindeki ayrılmış karakterleri URL kodlayın. Sabit çıkış veya kalıcı oturum kullanın. itags varsayılanı ["137", "140"] değeridir; eksik biçimler değiştirilmeden hata döner. verify_download varsayılanı false değeridir. Aynı proxy oturumu, gerçek genel çıkış IP’si ve streams[].download_headers ile indirin. Başarılı URL çıkarımı (HTTP 200), all_selected_streams_verified veya streams[].verified false olsa bile ücretlendirilir. Yalnızca küçük bayt örnekleri doğrulanır, tüm dosya değil. URL ve oturum süreleri bağımsızdır; ayrı ses ve video akışlarını istemcide birleştirin.

Başvuru

Yalnızca seçilen uç noktanın belgelenmiş alanlarını gönderin. Her alternatif grubundan en az bir alan sağlayın. İmleçler önceki yanıttan alınır; otomatik sayfalama yoktur.

Tam başvuru

Hatalar

HTTP 400 geçersiz parametre, 401 geçersiz kimlik doğrulama, 402 yetersiz bakiye, 403 erişim reddi, 429 hız sınırı ve 5xx hizmet veya sağlayıcı hatalarını belirtir. Sorun giderme için X-Request-Id değerini saklayın. Başarısız iş kodu içeren HTTP 200 başarı değildir.

Kaynaklar

Uç noktalar ve fiyatlar 2026-10-31 tarihinde resmi şema ve güncel fiyat metaverileriyle doğrulandı. Çelişen metin fiyatlarında güncel metaveriler esas alınır.

TikHub · OpenAPI · Prices