Referensi endpoint YouTube | Dokumentasi API

# YouTube endpoint reference

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

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.

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.

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.

### web-get_relate_video

`GET https://api.apihop.ai/v1/youtube/web/videos/related`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `video_id` | Yes | `string` |
| `continuation_token` | No | `string` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web/videos/related" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "video_id=LuIL5JATZsc"
```

### web-search_video

`GET https://api.apihop.ai/v1/youtube/web/search/videos`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `search_query` | Yes | `string` |
| `language_code` | No | `string`; default: `"en"` |
| `order_by` | No | `string`; default: `"this_month"` |
| `country_code` | No | `string`; default: `"us"` |
| `continuation_token` | No | `string` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web/search/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "search_query=Minecraft"
```

### web-get_channel_id

`GET https://api.apihop.ai/v1/youtube/web/channels/id`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `channel_name` | Yes | `string` |

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

### web-get_channel_id_v2

`GET https://api.apihop.ai/v1/youtube/web/channels/id/by-url`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `channel_url` | Yes | `string` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web/channels/id/by-url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_url=https://www.youtube.com/@CozyCraftYT"
```

### web-get_channel_url

`GET https://api.apihop.ai/v1/youtube/web/channels/url`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `channel_id` | Yes | `string` |

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

### web-get_channel_info

`GET https://api.apihop.ai/v1/youtube/web/channels/info`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `channel_id` | Yes | `string` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web/channels/info" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_id=UCXuqSBlHAE6Xw-yeJA0Tunw"
```

### web-get_channel_short_videos

`GET https://api.apihop.ai/v1/youtube/web/channels/shorts`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `channel_id` | Yes | `string` |
| `continuation_token` | No | `string` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web/channels/shorts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_id=UCXuqSBlHAE6Xw-yeJA0Tunw"
```

### web-search_channel

`GET https://api.apihop.ai/v1/youtube/web/channels/search`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `channel_id` | Yes | `string` |
| `search_query` | Yes | `string` |
| `language_code` | No | `string`; default: `"en"` |
| `country_code` | No | `string`; default: `"us"` |
| `continuation_token` | No | `string` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web/channels/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_id=UCXuqSBlHAE6Xw-yeJA0Tunw" \
  --data-urlencode "search_query=AMD"
```

### web_v2-get_video_info

`GET https://api.apihop.ai/v1/youtube/web-v2/videos/info`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `video_id` | Yes | `string`; minLength: 11; maxLength: 11 |
| `language_code` | No | `string`; default: `"zh-CN"` |
| `need_format` | No | `boolean`; default: `true` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/videos/info" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "video_id=oaSNBz4qMQY"
```

### web_v2-get_video_info_v2

`GET https://api.apihop.ai/v1/youtube/web-v2/videos/info-v2`

Price per successful request: **$0.001** (1000 credits).

At least one: `video_id`, `video_url`.

| Field | Required | Contract |
| --- | --- | --- |
| `video_id` | No | `string` |
| `video_url` | No | `string` |
| `need_format` | No | `boolean`; default: `true` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/videos/info-v2" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "video_id=dQw4w9WgXcQ"
```

### web_v2-get_video_comments

`GET https://api.apihop.ai/v1/youtube/web-v2/videos/comments`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `video_id` | Yes | `string`; minLength: 11; maxLength: 11 |
| `language_code` | No | `string`; default: `"zh-CN"` |
| `country_code` | No | `string`; default: `"US"` |
| `sort_by` | No | `string`; `top`, `newest`; default: `"top"` |
| `continuation_token` | No | `string` |
| `need_format` | No | `boolean`; default: `true` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/videos/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "video_id=LuIL5JATZsc"
```

### web_v2-get_video_comment_replies

`GET https://api.apihop.ai/v1/youtube/web-v2/videos/comments/replies`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `continuation_token` | Yes | `string` |
| `language_code` | No | `string`; default: `"zh-CN"` |
| `country_code` | No | `string`; default: `"US"` |
| `need_format` | No | `boolean`; default: `true` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/videos/comments/replies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "continuation_token=example"
```

### web_v2-get_channel_description

`GET https://api.apihop.ai/v1/youtube/web-v2/channels/description`

Price per successful request: **$0.001** (1000 credits).

At least one: `channel_id`, `continuation_token`.

| Field | Required | Contract |
| --- | --- | --- |
| `channel_id` | No | `string` |
| `continuation_token` | No | `string` |
| `language_code` | No | `string`; default: `"zh-CN"` |
| `country_code` | No | `string`; default: `"US"` |
| `need_format` | No | `boolean`; default: `true` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/channels/description" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_id=UCeu6U67OzJhV1KwBansH3Dg"
```

### web_v2-get_general_search

`GET https://api.apihop.ai/v1/youtube/web-v2/search`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `search_query` | Yes | `string`; maxLength: 200 |
| `language_code` | No | `string`; default: `"zh-CN"` |
| `country_code` | No | `string`; default: `"US"` |
| `time_zone` | No | `string`; default: `"America/Los_Angeles"` |
| `upload_time` | No | `string`; `hour`, `today`, `week`, `month`, `year` |
| `duration` | No | `string`; `short`, `medium`, `long` |
| `content_type` | No | `string`; `video`, `channel`, `playlist`, `movie` |
| `feature` | No | `string`; `live`, `4k`, `hd`, `subtitles`, `creative_commons`, `360`, `vr180`, `3d`, `hdr`, `location`, `purchased` |
| `sort_by` | No | `string`; `relevance`, `upload_date`, `view_count`, `rating` |
| `continuation_token` | No | `string` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "search_query=Python编程"
```

### web_v2-get_general_search_v2

`GET https://api.apihop.ai/v1/youtube/web-v2/search-v2`

Price per successful request: **$0.002** (2000 credits).

At least one: `keyword`, `continuation_token`.

| Field | Required | Contract |
| --- | --- | --- |
| `keyword` | No | `string`; maxLength: 200 |
| `continuation_token` | No | `string` |
| `upload_date` | No | `string`; `last_hour`, `today`, `this_week`, `this_month`, `this_year` |
| `type` | No | `string`; `video`, `channel`, `playlist`, `movie` |
| `duration` | No | `string`; `short`, `medium`, `long` |
| `features` | No | `string` |
| `sort_by` | No | `string`; `relevance`, `upload_date`, `view_count`, `rating` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/search-v2" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keyword=Python tutorial"
```

### web_v2-get_shorts_search

`GET https://api.apihop.ai/v1/youtube/web-v2/search/shorts`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `search_query` | Yes | `string`; maxLength: 200 |
| `language_code` | No | `string`; default: `"en-US"` |
| `country_code` | No | `string`; default: `"US"` |
| `time_zone` | No | `string`; default: `"America/Los_Angeles"` |
| `upload_time` | No | `string`; `hour`, `today`, `week`, `month`, `year` |
| `sort_by` | No | `string`; `relevance`, `upload_date`, `view_count`, `rating` |
| `continuation_token` | No | `string` |
| `filter_mixed_content` | No | `boolean`; default: `true` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/search/shorts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "search_query=Python编程"
```

### web_v2-get_shorts_search_v2

`GET https://api.apihop.ai/v1/youtube/web-v2/search/shorts-v2`

Price per successful request: **$0.002** (2000 credits).

At least one: `keyword`, `continuation_token`.

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/search/shorts-v2" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keyword=coding tips"
```

### web_v2-get_channel_id

`GET https://api.apihop.ai/v1/youtube/web-v2/channels/id`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `channel_url` | Yes | `string` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/channels/id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_url=https://www.youtube.com/@CozyCraftYT"
```

### web_v2-get_channel_url

`GET https://api.apihop.ai/v1/youtube/web-v2/channels/url`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `channel_id` | Yes | `string` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/channels/url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_id=UCeu6U67OzJhV1KwBansH3Dg"
```

### web_v2-get_channel_videos

`GET https://api.apihop.ai/v1/youtube/web-v2/channels/videos`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `channel_id` | Yes | `string` |
| `language_code` | No | `string`; default: `"zh-CN"` |
| `country_code` | No | `string`; default: `"US"` |
| `continuation_token` | No | `string` |
| `need_format` | No | `boolean`; default: `true` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/channels/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_id=UCJHBJ7F-nAIlMGolm0Hu4vg"
```

### web_v2-get_video_streams

`GET https://api.apihop.ai/v1/youtube/web-v2/videos/streams`

Price per successful request: **$0.001** (1000 credits).

At least one: `video_id`, `video_url`.

| Field | Required | Contract |
| --- | --- | --- |
| `video_id` | No | `string` |
| `video_url` | No | `string` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/videos/streams" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "video_id=dQw4w9WgXcQ"
```

### web_v2-get_video_streams_v2

`GET https://api.apihop.ai/v1/youtube/web-v2/videos/streams-v2`

Price per successful request: **$0.004** (4000 credits).

At least one: `video_id`, `video_url`.

| Field | Required | Contract |
| --- | --- | --- |
| `video_id` | No | `string` |
| `video_url` | No | `string` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/videos/streams-v2" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "video_id=dQw4w9WgXcQ"
```

### web_v2-get_signed_stream_url

`GET https://api.apihop.ai/v1/youtube/web-v2/videos/streams/signed-url`

Price per successful request: **$0.001** (1000 credits).

At least one: `video_id`, `video_url`.

| Field | Required | Contract |
| --- | --- | --- |
| `video_id` | No | `string` |
| `video_url` | No | `string` |
| `itag` | Yes | `integer` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/videos/streams/signed-url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "itag=18" \
  --data-urlencode "video_id=dQw4w9WgXcQ"
```

### web_v2-get_video_captions

`POST https://api.apihop.ai/v1/youtube/web-v2/videos/captions`

Price per successful request: **$0.008** (8000 credits).

At least one: `video_id`, `video_url`.

| Field | Required | Contract |
| --- | --- | --- |
| `video_id` | No | `string` |
| `video_url` | No | `string` |
| `language_code` | No | `string` |
| `format` | No | `string`; `srt`, `xml`, `json3`, `txt`; default: `"srt"` |

```bash
curl -X POST "https://api.apihop.ai/v1/youtube/web-v2/videos/captions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"format":"srt","video_id":"dQw4w9WgXcQ"}'
```

### web_v2-get_video_captions_result

`GET https://api.apihop.ai/v1/youtube/web-v2/videos/captions/result`

Price per successful request: **$0** (0 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `job_id` | Yes | `string`; `^[1-9][0-9]{0,18}$` |
| `format` | No | `string`; `srt`, `xml`, `json3`, `txt`; default: `"srt"` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/videos/captions/result" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "job_id=9007199254740993001"
```

### web_v2-get_related_videos

`GET https://api.apihop.ai/v1/youtube/web-v2/videos/related`

Price per successful request: **$0.001** (1000 credits).

At least one: `video_id`, `video_url`.

| Field | Required | Contract |
| --- | --- | --- |
| `video_id` | No | `string` |
| `video_url` | No | `string` |
| `need_format` | No | `boolean`; default: `true` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/videos/related" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "video_id=dQw4w9WgXcQ"
```

### web_v2-get_channel_shorts

`GET https://api.apihop.ai/v1/youtube/web-v2/channels/shorts`

Price per successful request: **$0.001** (1000 credits).

At least one: `channel_id`, `channel_url`.

| Field | Required | Contract |
| --- | --- | --- |
| `channel_id` | No | `string` |
| `channel_url` | No | `string` |
| `continuation_token` | No | `string` |
| `need_format` | No | `boolean`; default: `true` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/channels/shorts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_id=UCuAXFkgsw1L7xaCfnd5JJOw"
```

### web_v2-get_search_suggestions

`GET https://api.apihop.ai/v1/youtube/web-v2/search/suggestions`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `keyword` | Yes | `string`; maxLength: 200 |
| `language` | No | `string`; default: `"en"` |
| `region` | No | `string`; default: `"US"` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/search/suggestions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keyword=Rick Astley"
```

### web_v2-search_channels

`GET https://api.apihop.ai/v1/youtube/web-v2/search/channels`

Price per successful request: **$0.001** (1000 credits).

At least one: `keyword`, `continuation_token`.

| Field | Required | Contract |
| --- | --- | --- |
| `keyword` | No | `string`; maxLength: 200 |
| `continuation_token` | No | `string` |
| `need_format` | No | `boolean`; default: `true` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/search/channels" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keyword=Rick Astley"
```

### web_v2-get_channel_community_posts

`GET https://api.apihop.ai/v1/youtube/web-v2/channels/posts`

Price per successful request: **$0.001** (1000 credits).

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/channels/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_id=UCkRfArvrzheW2E7b6SVT7vQ"
```

### web_v2-get_post_detail

`GET https://api.apihop.ai/v1/youtube/web-v2/posts/detail`

Price per successful request: **$0.001** (1000 credits).

| Field | Required | Contract |
| --- | --- | --- |
| `post_id` | Yes | `string` |
| `language_code` | No | `string`; default: `"zh-CN"` |
| `country_code` | No | `string`; default: `"US"` |
| `need_format` | No | `boolean`; default: `true` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/posts/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy"
```

### web_v2-get_post_comments

`GET https://api.apihop.ai/v1/youtube/web-v2/posts/comments`

Price per successful request: **$0.001** (1000 credits).

At least one: `post_id`, `continuation_token`.

| Field | Required | Contract |
| --- | --- | --- |
| `post_id` | No | `string` |
| `continuation_token` | No | `string` |
| `language_code` | No | `string`; default: `"zh-CN"` |
| `country_code` | No | `string`; default: `"US"` |
| `need_format` | No | `boolean`; default: `true` |

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/posts/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy"
```

### web_v2-get_post_comment_replies

`GET https://api.apihop.ai/v1/youtube/web-v2/posts/comments/replies`

Price per successful request: **$0.001** (1000 credits).

```bash
curl --get "https://api.apihop.ai/v1/youtube/web-v2/posts/comments/replies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "continuation_token=example"
```

### web_v2-get_video_streams_v3

`POST https://api.apihop.ai/v1/youtube/web-v2/videos/streams-v3`

Price per successful request: **$0.003** (3000 credits).

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.

| Field | Required | Contract |
| --- | --- | --- |
| `video_id` | Yes | `string`; `^[A-Za-z0-9_-]{11}$` |
| `proxy_url` | Yes | `string`; minLength: 1; maxLength: 2048; writeOnly: true |
| `itags` | No | `array`; items: `string` `^[0-9]+$`; minItems: 1; maxItems: 4; uniqueItems: true; default: `["137","140"]` |
| `verify_download` | No | `boolean`; default: `false` |

```bash
curl -X POST "https://api.apihop.ai/v1/youtube/web-v2/videos/streams-v3" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"video_id":"phlZ2J3x4hI","proxy_url":"http://USERNAME:PASSWORD@proxy.example.com:1000","itags":["137","140"],"verify_download":false}'
```

## 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"}}
```

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

Pilih endpoint dan kirim hanya kolom yang didokumentasikan. Jika alternatif dicantumkan, berikan setidaknya satu kolom dari setiap kelompok. Nilai paginasi harus berasal dari respons sebelumnya; tidak ada paginasi otomatis.

Operasi GET menggunakan parameter kueri tanpa isi permintaan. Stream V3 menggunakan POST dengan isi application/json dan tanpa parameter kueri; kirim proxy_url hanya dalam isi tersebut. Segmen versi memilih versi antarmuka YouTube. Kolom yang tidak dikenal atau duplikat ditolak. Simpan pengenal dan kursor paginasi sebagai string, termasuk nilai yang lebih besar daripada angka yang dapat direpresentasikan JavaScript secara aman.

Untuk permintaan sinkron: harga berlaku per permintaan yang berhasil, bukan per item yang dikembalikan. Setiap halaman merupakan permintaan terpisah. Sebagian besar operasi berharga $0.001. Dua varian pencarian V2 berharga $0.002; varian streaming V2 berharga $0.004. Lihat setiap endpoint di bawah. Harga khusus akun berlaku lebih dahulu. Diskon volume penyedia tidak otomatis diteruskan kepada pelanggan. Panggilan hulu yang gagal melepaskan cadangan; kegagalan penyelesaian biaya mengembalikan kesalahan dan tidak memicu permintaan hulu kedua.

Tugas takarir

POST https://api.apihop.ai/v1/youtube/web-v2/videos/captions mengembalikan HTTP 202 dan ID tugas platform, dengan Location: /v1/jobs/\{id\}. Kueri GET https://api.apihop.ai/v1/youtube/web-v2/videos/captions/result?job_id=\{id\} setiap 2–5 detik. Hanya tenant pemilik yang dapat membaca tugas. Kueri hasil gratis; pembuatan dikenai harga katalog $0.008. Hasil tanpa takarir dianggap berhasil dan dapat ditagihkan. Format ditetapkan saat pembuatan (bawaan srt); format hasil opsional harus cocok atau akan mengembalikan HTTP 400. data.result bernilai null hingga COMPLETED; tugas dapat berakhir sebagai FAILED. Endpoint ini mengambil takarir yang sudah ada, bukan transkripsi AI.

Jika penerimaan pengiriman belum pasti, permintaan tidak dikirim ulang dan cadangannya dapat tetap ditahan hingga tenggat tugas 30 menit. Hasil penyedia dapat tetap berstatus tertunda selama penyelesaian biaya direkonsiliasi. Kesalahan polling sementara bukan kegagalan akhir tugas.

json

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

Cakupan dan batasan

Jalur web dan web-v2 memilih keluarga antarmuka hulu. Stream V3 mendukung pengambilan melalui POST dengan proksi HTTP milik Anda sendiri yang memiliki IP keluar tetap. Endpoint streaming mengembalikan metadata dan URL, bukan file media atau jaminan unduhan. Deskripsi kanal mungkin memerlukan permintaan kedua yang ditagihkan terpisah menggunakan continuation_token. Tidak ada percobaan ulang otomatis.

web-get_relate_video

GET https://api.apihop.ai/v1/youtube/web/videos/related

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`video_id`	Ya	`string`
`continuation_token`	Tidak	`string`

bash

curl --get "https://api.apihop.ai/v1/youtube/web/videos/related" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "video_id=LuIL5JATZsc"

web-search_video

GET https://api.apihop.ai/v1/youtube/web/search/videos

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`search_query`	Ya	`string`
`language_code`	Tidak	`string`; default: `"en"`
`order_by`	Tidak	`string`; default: `"this_month"`
`country_code`	Tidak	`string`; default: `"us"`
`continuation_token`	Tidak	`string`

bash

curl --get "https://api.apihop.ai/v1/youtube/web/search/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "search_query=Minecraft"

web-get_channel_id

GET https://api.apihop.ai/v1/youtube/web/channels/id

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`channel_name`	Ya	`string`

bash

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

web-get_channel_id_v2

GET https://api.apihop.ai/v1/youtube/web/channels/id/by-url

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`channel_url`	Ya	`string`

bash

curl --get "https://api.apihop.ai/v1/youtube/web/channels/id/by-url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_url=https://www.youtube.com/@CozyCraftYT"

web-get_channel_url

GET https://api.apihop.ai/v1/youtube/web/channels/url

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`channel_id`	Ya	`string`

bash

curl --get "https://api.apihop.ai/v1/youtube/web/channels/url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_id=UCeu6U67OzJhV1KwBansH3Dg"

web-get_channel_info

GET https://api.apihop.ai/v1/youtube/web/channels/info

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`channel_id`	Ya	`string`

bash

curl --get "https://api.apihop.ai/v1/youtube/web/channels/info" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_id=UCXuqSBlHAE6Xw-yeJA0Tunw"

web-get_channel_short_videos

GET https://api.apihop.ai/v1/youtube/web/channels/shorts

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`channel_id`	Ya	`string`
`continuation_token`	Tidak	`string`

bash

curl --get "https://api.apihop.ai/v1/youtube/web/channels/shorts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_id=UCXuqSBlHAE6Xw-yeJA0Tunw"

web-search_channel

GET https://api.apihop.ai/v1/youtube/web/channels/search

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`channel_id`	Ya	`string`
`search_query`	Ya	`string`
`language_code`	Tidak	`string`; default: `"en"`
`country_code`	Tidak	`string`; default: `"us"`
`continuation_token`	Tidak	`string`

bash

curl --get "https://api.apihop.ai/v1/youtube/web/channels/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_id=UCXuqSBlHAE6Xw-yeJA0Tunw" \
  --data-urlencode "search_query=AMD"

web_v2-get_video_info

GET https://api.apihop.ai/v1/youtube/web-v2/videos/info

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`video_id`	Ya	`string`; minLength: 11; maxLength: 11
`language_code`	Tidak	`string`; default: `"zh-CN"`
`need_format`	Tidak	`boolean`; default: `true`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/videos/info" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "video_id=oaSNBz4qMQY"

web_v2-get_video_info_v2

GET https://api.apihop.ai/v1/youtube/web-v2/videos/info-v2

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Setidaknya satu: video_id, video_url.

Kolom	Wajib	Kontrak
`video_id`	Tidak	`string`
`video_url`	Tidak	`string`
`need_format`	Tidak	`boolean`; default: `true`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/videos/info-v2" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "video_id=dQw4w9WgXcQ"

web_v2-get_video_comments

GET https://api.apihop.ai/v1/youtube/web-v2/videos/comments

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`video_id`	Ya	`string`; minLength: 11; maxLength: 11
`language_code`	Tidak	`string`; default: `"zh-CN"`
`country_code`	Tidak	`string`; default: `"US"`
`sort_by`	Tidak	`string`; `top`, `newest`; bawaan: `"top"`
`continuation_token`	Tidak	`string`
`need_format`	Tidak	`boolean`; default: `true`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/videos/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "video_id=LuIL5JATZsc"

web_v2-get_video_comment_replies

GET https://api.apihop.ai/v1/youtube/web-v2/videos/comments/replies

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`continuation_token`	Ya	`string`
`language_code`	Tidak	`string`; default: `"zh-CN"`
`country_code`	Tidak	`string`; default: `"US"`
`need_format`	Tidak	`boolean`; default: `true`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/videos/comments/replies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "continuation_token=example"

web_v2-get_channel_description

GET https://api.apihop.ai/v1/youtube/web-v2/channels/description

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Setidaknya satu: channel_id, continuation_token.

Kolom	Wajib	Kontrak
`channel_id`	Tidak	`string`
`continuation_token`	Tidak	`string`
`language_code`	Tidak	`string`; default: `"zh-CN"`
`country_code`	Tidak	`string`; default: `"US"`
`need_format`	Tidak	`boolean`; default: `true`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/channels/description" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_id=UCeu6U67OzJhV1KwBansH3Dg"

web_v2-get_general_search

GET https://api.apihop.ai/v1/youtube/web-v2/search

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`search_query`	Ya	`string`; maxLength: 200
`language_code`	Tidak	`string`; default: `"zh-CN"`
`country_code`	Tidak	`string`; default: `"US"`
`time_zone`	Tidak	`string`; default: `"America/Los_Angeles"`
`upload_time`	Tidak	`string`; `hour`, `today`, `week`, `month`, `year`
`duration`	Tidak	`string`; `short`, `medium`, `long`
`content_type`	Tidak	`string`; `video`, `channel`, `playlist`, `movie`
`feature`	Tidak	`string`; `live`, `4k`, `hd`, `subtitles`, `creative_commons`, `360`, `vr180`, `3d`, `hdr`, `location`, `purchased`
`sort_by`	Tidak	`string`; `relevance`, `upload_date`, `view_count`, `rating`
`continuation_token`	Tidak	`string`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "search_query=Python编程"

web_v2-get_general_search_v2

GET https://api.apihop.ai/v1/youtube/web-v2/search-v2

Harga per permintaan yang berhasil: $0.002 (2000 credits).

Setidaknya satu: keyword, continuation_token.

Kolom	Wajib	Kontrak
`keyword`	Tidak	`string`; maxLength: 200
`continuation_token`	Tidak	`string`
`upload_date`	Tidak	`string`; `last_hour`, `today`, `this_week`, `this_month`, `this_year`
`type`	Tidak	`string`; `video`, `channel`, `playlist`, `movie`
`duration`	Tidak	`string`; `short`, `medium`, `long`
`features`	Tidak	`string`
`sort_by`	Tidak	`string`; `relevance`, `upload_date`, `view_count`, `rating`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/search-v2" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keyword=Python tutorial"

web_v2-get_shorts_search

GET https://api.apihop.ai/v1/youtube/web-v2/search/shorts

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`search_query`	Ya	`string`; maxLength: 200
`language_code`	Tidak	`string`; default: `"en-US"`
`country_code`	Tidak	`string`; default: `"US"`
`time_zone`	Tidak	`string`; default: `"America/Los_Angeles"`
`upload_time`	Tidak	`string`; `hour`, `today`, `week`, `month`, `year`
`sort_by`	Tidak	`string`; `relevance`, `upload_date`, `view_count`, `rating`
`continuation_token`	Tidak	`string`
`filter_mixed_content`	Tidak	`boolean`; default: `true`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/search/shorts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "search_query=Python编程"

web_v2-get_shorts_search_v2

GET https://api.apihop.ai/v1/youtube/web-v2/search/shorts-v2

Harga per permintaan yang berhasil: $0.002 (2000 credits).

Setidaknya satu: keyword, continuation_token.

Kolom	Wajib	Kontrak
`keyword`	Tidak	`string`; maxLength: 200
`continuation_token`	Tidak	`string`
`upload_date`	Tidak	`string`; `last_hour`, `today`, `this_week`, `this_month`, `this_year`
`sort_by`	Tidak	`string`; `relevance`, `upload_date`, `view_count`, `rating`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/search/shorts-v2" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keyword=coding tips"

web_v2-get_channel_id

GET https://api.apihop.ai/v1/youtube/web-v2/channels/id

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`channel_url`	Ya	`string`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/channels/id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_url=https://www.youtube.com/@CozyCraftYT"

web_v2-get_channel_url

GET https://api.apihop.ai/v1/youtube/web-v2/channels/url

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`channel_id`	Ya	`string`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/channels/url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_id=UCeu6U67OzJhV1KwBansH3Dg"

web_v2-get_channel_videos

GET https://api.apihop.ai/v1/youtube/web-v2/channels/videos

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`channel_id`	Ya	`string`
`language_code`	Tidak	`string`; default: `"zh-CN"`
`country_code`	Tidak	`string`; default: `"US"`
`continuation_token`	Tidak	`string`
`need_format`	Tidak	`boolean`; default: `true`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/channels/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_id=UCJHBJ7F-nAIlMGolm0Hu4vg"

web_v2-get_video_streams

GET https://api.apihop.ai/v1/youtube/web-v2/videos/streams

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Setidaknya satu: video_id, video_url.

Kolom	Wajib	Kontrak
`video_id`	Tidak	`string`
`video_url`	Tidak	`string`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/videos/streams" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "video_id=dQw4w9WgXcQ"

web_v2-get_video_streams_v2

GET https://api.apihop.ai/v1/youtube/web-v2/videos/streams-v2

Harga per permintaan yang berhasil: $0.004 (4000 credits).

Setidaknya satu: video_id, video_url.

Kolom	Wajib	Kontrak
`video_id`	Tidak	`string`
`video_url`	Tidak	`string`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/videos/streams-v2" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "video_id=dQw4w9WgXcQ"

web_v2-get_signed_stream_url

GET https://api.apihop.ai/v1/youtube/web-v2/videos/streams/signed-url

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Setidaknya satu: video_id, video_url.

Kolom	Wajib	Kontrak
`video_id`	Tidak	`string`
`video_url`	Tidak	`string`
`itag`	Ya	`integer`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/videos/streams/signed-url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "itag=18" \
  --data-urlencode "video_id=dQw4w9WgXcQ"

web_v2-get_video_captions

POST https://api.apihop.ai/v1/youtube/web-v2/videos/captions

Harga per permintaan yang berhasil: $0.008 (8000 credits).

Setidaknya satu: video_id, video_url.

Kolom	Wajib	Kontrak
`video_id`	Tidak	`string`
`video_url`	Tidak	`string`
`language_code`	Tidak	`string`
`format`	Tidak	`string`; `srt`, `xml`, `json3`, `txt`; bawaan: `"srt"`

bash

curl -X POST "https://api.apihop.ai/v1/youtube/web-v2/videos/captions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"format":"srt","video_id":"dQw4w9WgXcQ"}'

web_v2-get_video_captions_result

GET https://api.apihop.ai/v1/youtube/web-v2/videos/captions/result

Harga per permintaan yang berhasil: $0 (0 credits).

Kolom	Wajib	Kontrak
`job_id`	Ya	`string`; `^[1-9][0-9]{0,18}$`
`format`	Tidak	`string`; `srt`, `xml`, `json3`, `txt`; bawaan: `"srt"`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/videos/captions/result" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "job_id=9007199254740993001"

GET https://api.apihop.ai/v1/youtube/web-v2/videos/related

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Setidaknya satu: video_id, video_url.

Kolom	Wajib	Kontrak
`video_id`	Tidak	`string`
`video_url`	Tidak	`string`
`need_format`	Tidak	`boolean`; default: `true`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/videos/related" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "video_id=dQw4w9WgXcQ"

web_v2-get_channel_shorts

GET https://api.apihop.ai/v1/youtube/web-v2/channels/shorts

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Setidaknya satu: channel_id, channel_url.

Kolom	Wajib	Kontrak
`channel_id`	Tidak	`string`
`channel_url`	Tidak	`string`
`continuation_token`	Tidak	`string`
`need_format`	Tidak	`boolean`; default: `true`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/channels/shorts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_id=UCuAXFkgsw1L7xaCfnd5JJOw"

web_v2-get_search_suggestions

GET https://api.apihop.ai/v1/youtube/web-v2/search/suggestions

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`keyword`	Ya	`string`; maxLength: 200
`language`	Tidak	`string`; default: `"en"`
`region`	Tidak	`string`; default: `"US"`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/search/suggestions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keyword=Rick Astley"

web_v2-search_channels

GET https://api.apihop.ai/v1/youtube/web-v2/search/channels

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Setidaknya satu: keyword, continuation_token.

Kolom	Wajib	Kontrak
`keyword`	Tidak	`string`; maxLength: 200
`continuation_token`	Tidak	`string`
`need_format`	Tidak	`boolean`; default: `true`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/search/channels" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "keyword=Rick Astley"

web_v2-get_channel_community_posts

GET https://api.apihop.ai/v1/youtube/web-v2/channels/posts

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`channel_id`	Ya	`string`
`language_code`	Tidak	`string`; default: `"zh-CN"`
`country_code`	Tidak	`string`; default: `"US"`
`continuation_token`	Tidak	`string`
`need_format`	Tidak	`boolean`; default: `true`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/channels/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_id=UCkRfArvrzheW2E7b6SVT7vQ"

web_v2-get_post_detail

GET https://api.apihop.ai/v1/youtube/web-v2/posts/detail

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`post_id`	Ya	`string`
`language_code`	Tidak	`string`; default: `"zh-CN"`
`country_code`	Tidak	`string`; default: `"US"`
`need_format`	Tidak	`boolean`; default: `true`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/posts/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy"

web_v2-get_post_comments

GET https://api.apihop.ai/v1/youtube/web-v2/posts/comments

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Setidaknya satu: post_id, continuation_token.

Kolom	Wajib	Kontrak
`post_id`	Tidak	`string`
`continuation_token`	Tidak	`string`
`language_code`	Tidak	`string`; default: `"zh-CN"`
`country_code`	Tidak	`string`; default: `"US"`
`need_format`	Tidak	`boolean`; default: `true`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/posts/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy"

web_v2-get_post_comment_replies

GET https://api.apihop.ai/v1/youtube/web-v2/posts/comments/replies

Harga per permintaan yang berhasil: $0.001 (1000 credits).

Kolom	Wajib	Kontrak
`continuation_token`	Ya	`string`
`language_code`	Tidak	`string`; default: `"zh-CN"`
`country_code`	Tidak	`string`; default: `"US"`
`need_format`	Tidak	`boolean`; default: `true`

bash

curl --get "https://api.apihop.ai/v1/youtube/web-v2/posts/comments/replies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "continuation_token=example"

web_v2-get_video_streams_v3

POST https://api.apihop.ai/v1/youtube/web-v2/videos/streams-v3

Harga per permintaan yang berhasil: $0.003 (3000 credits).

Stream V3 menggunakan POST JSON melalui HTTPS dan berharga $0.003 per permintaan yang berhasil. Berikan video_id dan proxy_url (http:// dengan port eksplisit dan host publik); tujuan privat, loopback, dan link-local dilarang. Lakukan pengodean URL pada karakter khusus dalam kredensial. Gunakan IP keluar tetap atau sesi proksi yang melekat. Nilai bawaan itags adalah ["137", "140"]; format yang tidak tersedia menyebabkan kegagalan tanpa penggantian. Nilai bawaan verify_download adalah false. Unduh melalui sesi proksi dan IP keluar publik aktual yang sama dengan streams[].download_headers. Ekstraksi URL yang berhasil (HTTP 200) dapat ditagihkan meskipun all_selected_streams_verified atau streams[].verified bernilai false. Verifikasi mengambil sampel rentang byte kecil, bukan keseluruhan file. URL dan sesi proksi kedaluwarsa secara terpisah; gabungkan sendiri aliran audio/video yang terpisah.

Kolom	Wajib	Kontrak
`video_id`	Ya	`string`; `^[A-Za-z0-9_-]{11}$`
`proxy_url`	Ya	`string`; minLength: 1; maxLength: 2048; writeOnly: true
`itags`	Tidak	`array`; items: `string` `^[0-9]+$`; minItems: 1; maxItems: 4; uniqueItems: true; default: `["137","140"]`
`verify_download`	Tidak	`boolean`; default: `false`

bash

curl -X POST "https://api.apihop.ai/v1/youtube/web-v2/videos/streams-v3" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"video_id":"phlZ2J3x4hI","proxy_url":"http://USERNAME:PASSWORD@proxy.example.com:1000","itags":["137","140"],"verify_download":false}'

Respons

Endpoint sinkron mempertahankan respons JSON asli. Endpoint takarir mengembalikan success, data.id, data.status, data.result, dan requestId. Contoh di bawah bersifat ilustratif, bukan hasil langsung.

json

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

Kesalahan

Kesalahan platform menggunakan HTTP 400 untuk parameter tidak valid, 401 untuk autentikasi tidak valid, 402 untuk kredit tidak cukup, 403 untuk akses gateway yang ditolak, 429 untuk batas laju, dan 5xx untuk kegagalan layanan atau penyedia. Simpan X-Request-Id untuk pemecahan masalah. Jangan menganggap HTTP 200 dari penyedia hulu dengan kode bisnis gagal sebagai keberhasilan.

Sumber

Daftar endpoint dan harga diperiksa terhadap skema resmi dan metadata harga langsung pada 2026-10-31. Metadata langsung berlaku lebih dahulu jika bertentangan dengan harga dalam uraian teks.

TikHub · OpenAPI · Harga