YouTube API ข้อมูล | เอกสาร 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)

ค้นวิดีโอ ช่อง Shorts ความคิดเห็น โพสต์ชุมชน ผลค้นหา และเมทาดาทาสตรีม YouTube ผ่าน 34 เอนด์พอยต์ที่ต้องยืนยันตัวตน: 32 GET และ 2 POST

การยืนยันตัวตน

ใช้คีย์ API ของ API Hop ในเฮดเดอร์ยืนยันตัวตน ความพร้อมขึ้นอยู่กับเกตเวย์ที่เปิดใช้และสิทธิ์คีย์ API เอกสารเพียงอย่างเดียวไม่ยืนยันความพร้อมในระบบจริง

http

Authorization: Bearer YOUR_API_KEY

คำขอและงานคำบรรยาย

การดำเนินการ GET ใช้พารามิเตอร์คิวรีโดยไม่มีเนื้อหาคำขอ Stream V3 ใช้ POST พร้อมเนื้อหา application/json และไม่มีพารามิเตอร์คิวรี ส่ง proxy_url เฉพาะในเนื้อหานั้น ส่วนเวอร์ชันเลือกเวอร์ชันอินเทอร์เฟซ YouTube ฟิลด์ไม่รู้จักหรือซ้ำถูกปฏิเสธ เก็บตัวระบุและเคอร์เซอร์แบ่งหน้าเป็นสตริง รวมถึงค่าที่มากกว่าช่วงตัวเลขปลอดภัยของ JavaScript

bash

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

การตอบกลับ

เอนด์พอยต์แบบซิงโครนัสคงการตอบกลับ JSON เดิม เอนด์พอยต์คำบรรยายส่ง success, data.id, data.status, data.result และ requestId ตัวอย่างด้านล่างใช้ประกอบคำอธิบาย ไม่ใช่ผลจริง

json

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

การคิดค่าบริการและแบ่งหน้า

สำหรับคำขอซิงโครนัส: ราคาคิดต่อคำขอสำเร็จ ไม่ใช่ต่อรายการที่ส่งกลับ แต่ละหน้าเป็นคำขอแยก การดำเนินการส่วนใหญ่ราคา $0.001 การค้นหา V2 สองรูปแบบราคา $0.002 ส่วนสตรีม V2 ราคา $0.004 ดูแต่ละเอนด์พอยต์ด้านล่าง ราคาประจำบัญชีมีผลก่อน ส่วนลดปริมาณผู้ให้บริการไม่ได้ส่งต่ออัตโนมัติ การเรียกต้นทางล้มเหลวจะคืนยอดกันไว้ การชำระยอดล้มเหลวส่งข้อผิดพลาดและไม่เรียกต้นทางซ้ำ

งานคำบรรยาย

POST https://api.apihop.ai/v1/youtube/web-v2/videos/captions ส่ง HTTP 202 และ ID งานของแพลตฟอร์ม พร้อม Location: /v1/jobs/\{id\} เรียก GET https://api.apihop.ai/v1/youtube/web-v2/videos/captions/result?job_id=\{id\} ทุก 2–5 วินาที เฉพาะผู้เช่าเจ้าของเท่านั้นที่อ่านงานได้ การอ่านผลฟรี การสร้างราคา $0.008 ตามราคาปกติ ผลที่ไม่มีคำบรรยายถือว่าสำเร็จและคิดค่าบริการ รูปแบบกำหนดเมื่อสร้าง (ค่าเริ่มต้น srt) รูปแบบผลลัพธ์เสริมต้องตรงกัน มิฉะนั้นส่ง HTTP 400 โดย data.result เป็น null จนถึง COMPLETED งานอาจจบเป็น FAILED เอนด์พอยต์เหล่านี้ดึงคำบรรยายที่มีอยู่ ไม่ได้ถอดเสียงด้วย AI

หากไม่แน่ใจว่ารับการส่งงานหรือไม่ จะไม่ส่งคำขอซ้ำและยอดกันไว้อาจค้างจนถึงกำหนดงาน 30 นาที ผลผู้ให้บริการอาจยังรอระหว่างกระทบยอด ข้อผิดพลาดชั่วคราวในการตรวจสถานะไม่ใช่ความล้มเหลวสิ้นสุดของงาน

json

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

ขอบเขตและข้อจำกัด

เส้นทาง web และ web-v2 เลือกตระกูลอินเทอร์เฟซต้นทาง Stream V3 รองรับการดึงด้วย POST ผ่านพร็อกซี HTTP ทางออกคงที่ของคุณ เอนด์พอยต์สตรีมส่งเมทาดาทาและ URL ไม่ส่งไฟล์สื่อหรือรับประกันดาวน์โหลด คำอธิบายช่องอาจต้องเรียกเพิ่มแยกคิดค่าบริการด้วย continuation_token ไม่มีลองซ้ำอัตโนมัติ

Stream V3 ใช้ POST JSON ผ่าน HTTPS ราคา $0.003 ต่อคำขอสำเร็จ ส่ง video_id และ proxy_url (http:// พร้อมพอร์ตชัดเจนและโฮสต์สาธารณะ) ห้ามปลายทางส่วนตัว loopback และ link-local เข้ารหัสอักขระสงวนในข้อมูลรับรองแบบ URL ใช้ทางออกคงที่หรือเซสชันพร็อกซีแบบยึดติด ค่าเริ่มต้น itags คือ ["137", "140"] รูปแบบไม่พร้อมจะล้มเหลวโดยไม่แทนที่ ค่าเริ่มต้น verify_download คือ false ดาวน์โหลดผ่านเซสชันพร็อกซีเดียวกันและ IP ทางออกสาธารณะจริงด้วย streams[].download_headers การดึง URL สำเร็จ (HTTP 200) คิดค่าบริการแม้ all_selected_streams_verified หรือ streams[].verified เป็น false การตรวจสุ่มช่วงไบต์เล็ก ไม่ใช่ไฟล์ทั้งหมด URL และเซสชันพร็อกซีหมดอายุแยกกัน รวมสตรีมเสียงและวิดีโอที่แยกด้วยตนเอง

เอกสารอ้างอิง

เลือกเอนด์พอยต์และส่งเฉพาะฟิลด์ที่ระบุในเอกสาร หากมีตัวเลือก ให้ส่งอย่างน้อยหนึ่งฟิลด์จากแต่ละกลุ่ม ค่าแบ่งหน้าต้องมาจากการตอบกลับก่อนหน้า ไม่มีการแบ่งหน้าอัตโนมัติ

เอกสารอ้างอิงฉบับเต็ม

ข้อผิดพลาด

ข้อผิดพลาดแพลตฟอร์มใช้ HTTP 400 สำหรับพารามิเตอร์ไม่ถูกต้อง 401 สำหรับการยืนยันตัวตนไม่ถูกต้อง 402 สำหรับเครดิตไม่พอ 403 สำหรับปฏิเสธสิทธิ์เกตเวย์ 429 สำหรับจำกัดอัตรา และ 5xx สำหรับบริการหรือผู้ให้บริการล้มเหลว เก็บ X-Request-Id เพื่อแก้ปัญหา อย่าถือ HTTP 200 จากต้นทางที่มีรหัสธุรกิจล้มเหลวว่าสำเร็จ

แหล่งข้อมูล

ตรวจรายการเอนด์พอยต์และราคากับสคีมาทางการและเมทาดาทาราคาปัจจุบันเมื่อ 2026-10-31 เมทาดาทาปัจจุบันมีผลก่อนราคาที่เขียนบรรยายหากขัดกัน

TikHub · OpenAPI · ราคา