YouTube 搜索

通过关键字查询搜索 YouTube 并返回匹配的视频、频道、播放列表、短片、书架和直播。

1 credits / 次请求

GET /v1/youtube/search 试用

YouTube 搜索
GET /v1/youtube/search

通过关键字查询搜索 YouTube 并返回匹配的视频、频道、播放列表、短片、书架和直播。

鉴权：x-api-key
示例 URL: https://api.datawake.ai/v1/youtube/search?sortBy=relevance&filter=all&region=US&continuationToken=4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB&includeExtras=false

参数：
- query (query · string · 必填)
- uploadDate (query · string · 可选)
- sortBy (query · string · 可选) = relevance
- filter (query · string · 可选) = all
- region (query · string · 可选) = US
- continuationToken (query · string · 可选) = 4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB
- includeExtras (query · string · 可选) = false

概览

WakeScrap exposes this YouTube endpoint as a live-data API. The platform keeps the documented request and response shape stable while unifying auth, request tracking, and credits billing.

通过关键字查询搜索 YouTube 并返回匹配的视频、频道、播放列表、短片、书架和直播。每个视频结果包括标题、URL、缩略图、观看次数（视图）、发布日期、持续时间、频道信息和徽章。支持按上传日期过滤、按相关性或流行度排序以及使用 continuationToken 分页。

必填参数：query。

请求头

x-api-key string 必填

你的 Wake API 访问密钥。

示例：

YOUR_API_KEY

查询参数

query string 必填

搜索查询

uploadDate string

上传日期

枚举： today, this_week, this_month, this_year

sortBy string

排序方式

示例：

relevance

枚举： relevance, popular

filter string

按这些选项进行过滤。请注意，当您使用“uploadDate”或“sortBy”时，这不起作用。它基本上只在您有查询时才起作用。

示例：

all

枚举： shorts

region string

请求区域使用的 2 位国家代码。

示例：

continuationToken string

继续令牌以获得更多视频。从之前的响应中获取“continuationToken”。

示例：

4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB

includeExtras string

这将为您带来点赞+评论计数和描述。要获取视频的完整详细信息，请使用 /v1/youtube/video 端点。 *这会稍微减慢响应速度。*

示例：

false


              curl 'https://api.datawake.ai/v1/youtube/search?sortBy=relevance&filter=all&region=US&continuationToken=4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB&includeExtras=false' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'


              const response = await fetch("https://api.datawake.ai/v1/youtube/search?sortBy=relevance&filter=all&region=US&continuationToken=4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB&includeExtras=false", {
  method: "GET",
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Accept': 'application/json',
  },
});

const data = await response.json();
console.log(data);


              import requests

response = requests.request(
    "GET",
    "https://api.datawake.ai/v1/youtube/search?sortBy=relevance&filter=all&region=US&continuationToken=4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB&includeExtras=false",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Accept": "application/json",
    },
)

print(response.json())


              $ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.datawake.ai/v1/youtube/search?sortBy=relevance&filter=all&region=US&continuationToken=4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB&includeExtras=false",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        'x-api-key: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;


              client := &http.Client{}
req, err := http.NewRequest("GET", "https://api.datawake.ai/v1/youtube/search?sortBy=relevance&filter=all&region=US&continuationToken=4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB&includeExtras=false", nil)
if err != nil {
    panic(err)
}

req.Header.Set("x-api-key", "YOUR_API_KEY")
req.Header.Set("Accept", "application/json")

resp, err := client.Do(req)
if err != nil {
    panic(err)
}
defer resp.Body.Close()

body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))


              HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.datawake.ai/v1/youtube/search?sortBy=relevance&filter=all&region=US&continuationToken=4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB&includeExtras=false"))
    .header("x-api-key", "YOUR_API_KEY")
    .header("Accept", "application/json")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());


              {
  "videos": [
    {
      "type": "video",
      "id": "BzSzwqb-OEE",
      "url": "https://www.youtube.com/watch?v=BzSzwqb-OEE",
      "title": "NF - RUNNING (Audio)",
      "thumbnail": "https://i.ytimg.com/vi/BzSzwqb-OEE/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLCasEKav1CLqeSSE2IYDqjGiIMBGw",
      "channel": {
        "id": "UCoRR6OLuIZ2-5VxtnQIaN2w",
        "title": "NFrealmusic",
        "handle": "channel/UCoRR6OLuIZ2-5VxtnQIaN2w",
        "thumbnail": "https://yt3.ggpht.com/J1_Si0TYNZ-991v09y8RpCh4_Z_ALwKmPgMYnJqjNhoglVtipf3oEN8LpzG1kS0qsv8Jptpmmg=s88-c-k-c0x00ffffff-no-rj"
      },
      "viewCountText": "14,860,541 views",
      "viewCountInt": 14860541,
      "publishedTimeText": "2 years ago",
      "publishedTime": "2023-05-28T17:08:46.499Z",
      "lengthText": "4:14",
      "lengthSeconds": 254,
      "badges": []
    }
  ],
  "channels": [],
  "playlists": [],
  "shorts": [
    {
      "type": "short",
      "id": "uMNvF-lSCHg",
      "url": "https://www.youtube.com/watch?v=uMNvF-lSCHg",
      "title": "LONG RUN ROUTINE #run #runvlog #runner #shorts #morning",
      "thumbnail": "https://i.ytimg.com/vi/uMNvF-lSCHg/hq720.jpg?sqp=-oaymwFBCNAFEJQDSFryq4qpAzMIARUAAIhCGADYAQHiAQoIGBACGAY4AUAB8AEB-AG2CIACgA-KAgwIABABGFsgXyhlMA8=&rs=AOn4CLA_P-5ExEn9EGLJDNeJedsxb3k...",
      "channel": {
        "id": "UCGRdcRxpJWi5Q2oDCrMDUuQ",
        "title": "Abby and Ryan",
        "handle": "abbyandryan",
        "thumbnail": "https://yt3.ggpht.com/8UdUEesepx1Ry_rFUPJOJgndTCKno9VTkSysnuJpFjMj63N6av0pNwnqoiKh_7PN2dw7PGIp=s68-c-k-c0x00ffffff-no-rj"
      },
      "viewCountText": "462,705 views",
      "viewCountInt": 462705,
      "publishedTimeText": "10 months ago",
      "publishedTime": "2024-07-28T17:08:46.498Z",
      "lengthText": "0:44",
      "lengthSeconds": 44,
      "badges": []
    }
  ],
  "shelves": [
    {
      "type": "shelf",
      "title": "Shorts",
      "items": [
        {
          "type": "...",
          "id": "...",
          "url": "...",
          "title": "...",
          "thumbnail": "...",
          "viewCountText": "...",
          "viewCountInt": "..."
        }
      ]
    }
  ],
  "lives": [],
  "continuationToken": "EooDEg..."
}


              {
  "error": {
    "code": "invalid_request",
    "message": "One or more required parameters are missing or invalid."
  }
}


              {
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing x-api-key header."
  }
}


              {
  "error": {
    "code": "insufficient_credits",
    "message": "This request requires available credits before execution."
  }
}