مرجع نقاط نهاية YouTube | وثائق 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)

اختر نقطة نهاية وأرسل حقولها الموثقة فقط. عند سرد بدائل، قدم حقلا واحدا على الأقل من كل مجموعة. يجب أن تأتي قيم ترقيم الصفحات من الاستجابة السابقة؛ ولا يوجد جلب تلقائي للصفحات.

تستخدم عمليات GET معاملات الاستعلام دون جسم طلب. يستخدم Stream V3 طريقة POST مع جسم application/json ودون معاملات استعلام؛ أرسل proxy_url في ذلك الجسم فقط. يحدد مقطع الإصدار نسخة واجهة YouTube. ترفض الحقول المجهولة أو المكررة. احتفظ بالمعرفات ومؤشرات الصفحات كسلاسل نصية، بما فيها القيم الأكبر مما يستطيع JavaScript تمثيله بأمان كأرقام.

للطلبات المتزامنة: الأسعار لكل طلب ناجح، وليست لكل عنصر معاد. كل صفحة طلب مستقل. تكلف معظم العمليات $0.001. يكلف نوعا البحث V2 مبلغ $0.002؛ ويكلف نوع البث V2 مبلغ $0.004. راجع كل نقطة نهاية أدناه. لأسعار الحساب الخاصة الأولوية. لا تمرر خصومات حجم الاستخدام لدى المزود تلقائيا. تحرر استدعاءات المزود الفاشلة المبلغ المحجوز؛ وتعيد إخفاقات التسوية خطأ ولا تطلق طلبا ثانيا إلى المزود.

مهام الترجمات

يعيد POST https://api.apihop.ai/v1/youtube/web-v2/videos/captions الحالة HTTP 202 ومعرف مهمة المنصة، مع 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. تسترجع نقاط النهاية هذه ترجمات قائمة، ولا تنشئ تفريغا صوتيا بالذكاء الاصطناعي.

إذا كان قبول الإرسال غير مؤكد، فلا يعاد الطلب وقد يبقى المبلغ محجوزا حتى مهلة المهمة البالغة 30 دقيقة. قد تبقى نتيجة المزود معلقة أثناء مطابقة التسوية. خطأ الاستطلاع العابر ليس إخفاقا نهائيا للمهمة.

json

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

النطاق والقيود

يحدد المساران web وweb-v2 عائلة واجهة المزود. يدعم Stream V3 الاسترجاع بطريقة POST باستخدام وكيل HTTP الخاص بك ذي مخرج ثابت. تعيد نقاط نهاية البث بيانات وصفية وعناوين URL، وليست ملفات وسائط أو تنزيلات مضمونة. قد تتطلب أوصاف القنوات طلبا ثانيا برسوم مستقلة باستخدام continuation_token. لا توجد إعادة محاولات تلقائية.

web-get_relate_video

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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`video_id`	نعم	`string`
`continuation_token`	لا	`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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`search_query`	نعم	`string`
`language_code`	لا	`string`; القيمة الافتراضية: `"en"`
`order_by`	لا	`string`; القيمة الافتراضية: `"this_month"`
`country_code`	لا	`string`; القيمة الافتراضية: `"us"`
`continuation_token`	لا	`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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`channel_name`	نعم	`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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`channel_url`	نعم	`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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`channel_id`	نعم	`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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`channel_id`	نعم	`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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`channel_id`	نعم	`string`
`continuation_token`	لا	`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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`channel_id`	نعم	`string`
`search_query`	نعم	`string`
`language_code`	لا	`string`; القيمة الافتراضية: `"en"`
`country_code`	لا	`string`; القيمة الافتراضية: `"us"`
`continuation_token`	لا	`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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`video_id`	نعم	`string`; minLength: 11; maxLength: 11
`language_code`	لا	`string`; القيمة الافتراضية: `"zh-CN"`
`need_format`	لا	`boolean`; القيمة الافتراضية: `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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

واحد على الأقل: video_id, video_url.

الحقل	مطلوب	العقد
`video_id`	لا	`string`
`video_url`	لا	`string`
`need_format`	لا	`boolean`; القيمة الافتراضية: `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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`video_id`	نعم	`string`; minLength: 11; maxLength: 11
`language_code`	لا	`string`; القيمة الافتراضية: `"zh-CN"`
`country_code`	لا	`string`; القيمة الافتراضية: `"US"`
`sort_by`	لا	`string`; `top`, `newest`; القيمة الافتراضية: `"top"`
`continuation_token`	لا	`string`
`need_format`	لا	`boolean`; القيمة الافتراضية: `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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`continuation_token`	نعم	`string`
`language_code`	لا	`string`; القيمة الافتراضية: `"zh-CN"`
`country_code`	لا	`string`; القيمة الافتراضية: `"US"`
`need_format`	لا	`boolean`; القيمة الافتراضية: `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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

واحد على الأقل: channel_id, continuation_token.

الحقل	مطلوب	العقد
`channel_id`	لا	`string`
`continuation_token`	لا	`string`
`language_code`	لا	`string`; القيمة الافتراضية: `"zh-CN"`
`country_code`	لا	`string`; القيمة الافتراضية: `"US"`
`need_format`	لا	`boolean`; القيمة الافتراضية: `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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`search_query`	نعم	`string`; maxLength: 200
`language_code`	لا	`string`; القيمة الافتراضية: `"zh-CN"`
`country_code`	لا	`string`; القيمة الافتراضية: `"US"`
`time_zone`	لا	`string`; القيمة الافتراضية: `"America/Los_Angeles"`
`upload_time`	لا	`string`; `hour`, `today`, `week`, `month`, `year`
`duration`	لا	`string`; `short`, `medium`, `long`
`content_type`	لا	`string`; `video`, `channel`, `playlist`, `movie`
`feature`	لا	`string`; `live`, `4k`, `hd`, `subtitles`, `creative_commons`, `360`, `vr180`, `3d`, `hdr`, `location`, `purchased`
`sort_by`	لا	`string`; `relevance`, `upload_date`, `view_count`, `rating`
`continuation_token`	لا	`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

السعر لكل طلب ناجح: $0.002 (2000 رصيد).

واحد على الأقل: keyword, continuation_token.

الحقل	مطلوب	العقد
`keyword`	لا	`string`; maxLength: 200
`continuation_token`	لا	`string`
`upload_date`	لا	`string`; `last_hour`, `today`, `this_week`, `this_month`, `this_year`
`type`	لا	`string`; `video`, `channel`, `playlist`, `movie`
`duration`	لا	`string`; `short`, `medium`, `long`
`features`	لا	`string`
`sort_by`	لا	`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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`search_query`	نعم	`string`; maxLength: 200
`language_code`	لا	`string`; القيمة الافتراضية: `"en-US"`
`country_code`	لا	`string`; القيمة الافتراضية: `"US"`
`time_zone`	لا	`string`; القيمة الافتراضية: `"America/Los_Angeles"`
`upload_time`	لا	`string`; `hour`, `today`, `week`, `month`, `year`
`sort_by`	لا	`string`; `relevance`, `upload_date`, `view_count`, `rating`
`continuation_token`	لا	`string`
`filter_mixed_content`	لا	`boolean`; القيمة الافتراضية: `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

السعر لكل طلب ناجح: $0.002 (2000 رصيد).

واحد على الأقل: keyword, continuation_token.

الحقل	مطلوب	العقد
`keyword`	لا	`string`; maxLength: 200
`continuation_token`	لا	`string`
`upload_date`	لا	`string`; `last_hour`, `today`, `this_week`, `this_month`, `this_year`
`sort_by`	لا	`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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`channel_url`	نعم	`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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`channel_id`	نعم	`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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`channel_id`	نعم	`string`
`language_code`	لا	`string`; القيمة الافتراضية: `"zh-CN"`
`country_code`	لا	`string`; القيمة الافتراضية: `"US"`
`continuation_token`	لا	`string`
`need_format`	لا	`boolean`; القيمة الافتراضية: `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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

واحد على الأقل: video_id, video_url.

الحقل	مطلوب	العقد
`video_id`	لا	`string`
`video_url`	لا	`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

السعر لكل طلب ناجح: $0.004 (4000 رصيد).

واحد على الأقل: video_id, video_url.

الحقل	مطلوب	العقد
`video_id`	لا	`string`
`video_url`	لا	`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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

واحد على الأقل: video_id, video_url.

الحقل	مطلوب	العقد
`video_id`	لا	`string`
`video_url`	لا	`string`
`itag`	نعم	`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

السعر لكل طلب ناجح: $0.008 (8000 رصيد).

واحد على الأقل: video_id, video_url.

الحقل	مطلوب	العقد
`video_id`	لا	`string`
`video_url`	لا	`string`
`language_code`	لا	`string`
`format`	لا	`string`; `srt`, `xml`, `json3`, `txt`; القيمة الافتراضية: `"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

السعر لكل طلب ناجح: $0 (0 رصيد).

الحقل	مطلوب	العقد
`job_id`	نعم	`string`; `^[1-9][0-9]{0,18}$`
`format`	لا	`string`; `srt`, `xml`, `json3`, `txt`; القيمة الافتراضية: `"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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

واحد على الأقل: video_id, video_url.

الحقل	مطلوب	العقد
`video_id`	لا	`string`
`video_url`	لا	`string`
`need_format`	لا	`boolean`; القيمة الافتراضية: `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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

واحد على الأقل: channel_id, channel_url.

الحقل	مطلوب	العقد
`channel_id`	لا	`string`
`channel_url`	لا	`string`
`continuation_token`	لا	`string`
`need_format`	لا	`boolean`; القيمة الافتراضية: `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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`keyword`	نعم	`string`; maxLength: 200
`language`	لا	`string`; القيمة الافتراضية: `"en"`
`region`	لا	`string`; القيمة الافتراضية: `"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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

واحد على الأقل: keyword, continuation_token.

الحقل	مطلوب	العقد
`keyword`	لا	`string`; maxLength: 200
`continuation_token`	لا	`string`
`need_format`	لا	`boolean`; القيمة الافتراضية: `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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`channel_id`	نعم	`string`
`language_code`	لا	`string`; القيمة الافتراضية: `"zh-CN"`
`country_code`	لا	`string`; القيمة الافتراضية: `"US"`
`continuation_token`	لا	`string`
`need_format`	لا	`boolean`; القيمة الافتراضية: `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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`post_id`	نعم	`string`
`language_code`	لا	`string`; القيمة الافتراضية: `"zh-CN"`
`country_code`	لا	`string`; القيمة الافتراضية: `"US"`
`need_format`	لا	`boolean`; القيمة الافتراضية: `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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

واحد على الأقل: post_id, continuation_token.

الحقل	مطلوب	العقد
`post_id`	لا	`string`
`continuation_token`	لا	`string`
`language_code`	لا	`string`; القيمة الافتراضية: `"zh-CN"`
`country_code`	لا	`string`; القيمة الافتراضية: `"US"`
`need_format`	لا	`boolean`; القيمة الافتراضية: `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

السعر لكل طلب ناجح: $0.001 (1000 رصيد).

الحقل	مطلوب	العقد
`continuation_token`	نعم	`string`
`language_code`	لا	`string`; القيمة الافتراضية: `"zh-CN"`
`country_code`	لا	`string`; القيمة الافتراضية: `"US"`
`need_format`	لا	`boolean`; القيمة الافتراضية: `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

السعر لكل طلب ناجح: $0.003 (3000 رصيد).

يستخدم 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. يفحص التحقق عينات من نطاقات بايت صغيرة، وليس الملف الكامل. تنتهي صلاحية العناوين وجلسات الوكيل بصورة مستقلة؛ ادمج تدفقات الصوت والفيديو المنفصلة بنفسك.

الحقل	مطلوب	العقد
`video_id`	نعم	`string`; `^[A-Za-z0-9_-]{11}$`
`proxy_url`	نعم	`string`; minLength: 1; maxLength: 2048; writeOnly: true
`itags`	لا	`array`; العناصر: `string` `^[0-9]+$`; minItems: 1; maxItems: 4; uniqueItems: true; القيمة الافتراضية: `["137","140"]`
`verify_download`	لا	`boolean`; القيمة الافتراضية: `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}'

الاستجابات

تحافظ نقاط النهاية المتزامنة على استجابة JSON الأصلية. تعيد نقاط نهاية الترجمات الحقول success وdata.id وdata.status وdata.result وrequestId. الأمثلة أدناه توضيحية، وليست نتائج مباشرة.

json

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

الأخطاء

تستخدم أخطاء المنصة HTTP 400 للمعاملات غير الصحيحة، و401 للمصادقة غير الصحيحة، و402 للرصيد غير الكافي، و403 لرفض الوصول إلى البوابة، و429 لحدود المعدل، و5xx لإخفاقات الخدمة أو المزود. احتفظ بـX-Request-Id للتشخيص. لا تعتبر HTTP 200 من المزود مع رمز أعمال فاشل نجاحا.

المصادر

جرى التحقق من قائمة نقاط النهاية والأسعار مقابل المخطط الرسمي وبيانات الأسعار المباشرة في 2026-10-31. تكون الأولوية للبيانات المباشرة عند تعارضها مع الأسعار الواردة في النص.

TikHub · OpenAPI · الأسعار