YouTube Search

Searches YouTube by keyword query and returns matching videos, channels, playlists, shorts, shelves, and live streams.

1 credit / request

GET /v1/youtube/search Try it

YouTube Search
GET /v1/youtube/search

Searches YouTube by keyword query and returns matching videos, channels, playlists, shorts, shelves, and live streams.

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

Parameters:
- query (query · string · required)
- uploadDate (query · string · optional)
- sortBy (query · string · optional) = relevance
- filter (query · string · optional) = all
- region (query · string · optional) = US
- continuationToken (query · string · optional) = 4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB
- includeExtras (query · string · optional) = false

Overview

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.

Searches YouTube by keyword query and returns matching videos, channels, playlists, shorts, shelves, and live streams. Each video result includes title, URL, thumbnail, view count (views), publish date, duration, channel info, and badges. Supports filtering by upload date, sorting by relevance or popularity, and paginating with continuationToken.

Required params: query.

Headers

x-api-key string required

Your Wake API access key.

Example:

YOUR_API_KEY

Query Parameters

query string required

Search query

uploadDate string

Upload date

enum: today, this_week, this_month, this_year

sortBy string

Sort by

Example:

relevance

enum: relevance, popular

filter string

Filter by these options. Note this doesn't work when you use either 'uploadDate' or 'sortBy'. It basically only works when you have a query.

Example:

all

enum: shorts

region string

2-letter country code for the request region.

Example:

continuationToken string

Continuation token to get more videos. Get 'continuationToken' from previous response.

Example:

4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB

includeExtras string

This will get you the like + comment count and the description. To get the full details of the video, use the /v1/youtube/video endpoint. *This will slow down the response slightly.*

Example:

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."
  }
}