curl --request GET \
  --url https://api.scraperize.com/v1/youtube/search \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.scraperize.com/v1/youtube/search"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.scraperize.com/v1/youtube/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.scraperize.com/v1/youtube/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.scraperize.com/v1/youtube/search"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.scraperize.com/v1/youtube/search")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.scraperize.com/v1/youtube/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "query": "lofi hip hop",
    "region": null,
    "filters": {
      "uploadDate": null,
      "sortBy": "relevance",
      "type": null,
      "duration": null
    },
    "showingResultsFor": null,
    "includingResultsFor": null,
    "hashtag": null,
    "estimatedResults": 11370869,
    "results": [
      {
        "type": "playlist",
        "kind": "mix",
        "id": "RDATfmbG9maSBoaXAgaG9w",
        "url": "https://www.youtube.com/playlist?list=RDATfmbG9maSBoaXAgaG9w",
        "title": "Mix • Lofi hip hop",
        "videoCount": null,
        "channelName": "Академия глубокой релаксации, Kudasaibeats, RŮDE, and more",
        "channelId": null,
        "firstVideoId": "R8om0QifqII",
        "thumbnailUrl": "https://i.ytimg.com/vi/R8om0QifqII/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLBN0ePqpHQrvDXXKRJL_9Fgj53naQ",
        "thumbnails": [
          {
            "url": "https://i.ytimg.com/vi/R8om0QifqII/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLBN0ePqpHQrvDXXKRJL_9Fgj53naQ",
            "width": 480,
            "height": 270
          }
        ],
        "position": 1,
        "shelfTitle": null
      },
      {
        "type": "video",
        "id": "n61ULEU7CO0",
        "url": "https://www.youtube.com/watch?v=n61ULEU7CO0",
        "title": "Best of lofi hip hop 2021 ✨ [beats to relax/study to]",
        "descriptionSnippet": "Listen on Spotify, Apple music and more → https://fanlink.tv/BestofLofi2021 The new Lofi Girl compilation “Best of 2021” is out now ...",
        "viewCount": 58551430,
        "viewCountText": "58,551,430 views",
        "concurrentViewers": null,
        "publishedText": "4 years ago",
        "wasLive": false,
        "durationSeconds": 22258,
        "durationText": "6:10:58",
        "badges": [
          "1 product"
        ],
        "channelId": "UCSJ4gkVC6NrvII8umztf0Ow",
        "channelName": "Lofi Girl",
        "channelHandle": null,
        "isChannelVerified": true,
        "thumbnailUrl": "https://i.ytimg.com/vi/n61ULEU7CO0/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAi4TCpAtbxLFIBULRlcZHudl1uFw",
        "thumbnails": [
          {
            "url": "https://i.ytimg.com/vi/n61ULEU7CO0/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAi4TCpAtbxLFIBULRlcZHudl1uFw",
            "width": 720,
            "height": 404
          },
          {
            "url": "https://i.ytimg.com/vi/n61ULEU7CO0/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBsbMTx1evh72jfc4JDtfDXYVhYNg",
            "width": 360,
            "height": 202
          }
        ],
        "previewUrl": "https://i.ytimg.com/an_webp/n61ULEU7CO0/mqdefault_6s.webp?du=3000&sqp=CICLs9cG&rs=AOn4CLBirO-GQGnSLhV-m_dz0O2g1dEFRQ",
        "frameUrl": null,
        "collaborators": [],
        "position": 2,
        "shelfTitle": null
      },
      {
        "type": "live",
        "id": "rFZHOHl-L8A",
        "url": "https://www.youtube.com/watch?v=rFZHOHl-L8A",
        "title": "lofi hip hop radio 📚 beats to relax/study to",
        "descriptionSnippet": "Spooky season is officially upon us 2026 Halloween playlist available now: https://lnk.to/halloween-lofi02 | Listen on Spotify, ...",
        "viewCount": null,
        "viewCountText": "10,197 watching",
        "concurrentViewers": 10197,
        "publishedText": null,
        "wasLive": false,
        "durationSeconds": null,
        "durationText": null,
        "badges": [
          "LIVE",
          "24 products"
        ],
        "channelId": "UCSJ4gkVC6NrvII8umztf0Ow",
        "channelName": "Lofi Girl",
        "channelHandle": null,
        "isChannelVerified": true,
        "thumbnailUrl": "https://i.ytimg.com/vi/rFZHOHl-L8A/hq720.jpg?v=6ad62bed&sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCdekX1ygqqUJynjbliA5ayfR7tlw",
        "thumbnails": [
          {
            "url": "https://i.ytimg.com/vi/rFZHOHl-L8A/hq720.jpg?v=6ad62bed&sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCdekX1ygqqUJynjbliA5ayfR7tlw",
            "width": 720,
            "height": 404
          },
          {
            "url": "https://i.ytimg.com/vi/rFZHOHl-L8A/hq720.jpg?v=6ad62bed&sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDN3Yy-Dw3B9x_HYcTaGXq7gEVppA",
            "width": 360,
            "height": 202
          }
        ],
        "previewUrl": null,
        "frameUrl": null,
        "collaborators": [],
        "position": 3,
        "shelfTitle": null
      }
    ],
    "counts": {
      "video": 14,
      "short": 25,
      "live": 5,
      "channel": 0,
      "playlist": 1
    },
    "count": 45,
    "cursor": "eyJrIjoibG9maSBoaXAgaG9wIiwiYyI6IkVxMERFZ3hzYjJacElHaHBjQ0JvYjNBYW5BTlRRbE5EUVZKYVUxSkZSbFZhYlRGcFVucHNkRmxXVGtOaU1rWlpVVmRrYUZKNmJETm5aMFZNWW1wWmVGWlZlRVpXVkdSRVZIcERRMEZSZEhsU2JIQkpWREJvYzB4VmR6UlJXVWxDUXpCT1RWcFdjRFZUVld4RlQxVktkbWRuUlV4UldGb3hXakprU2xNeFRrVlNSVmREUVZGMGMxWkdTbkJrVlZwS1ZqRlpNVTVKU1VKRE1FbzFWMnRrTVUxcVNUVk1XR3hDWjJkRlRGRllTbkpOVjJoeFlVWkdUbVZJVDBOQlVYUTJWbnBXTTJORmNGcE5XRXB1VlZsSlFrTXdUa2RTTUhoMlZWVnNiMkpYT1ROblowVk1Zekl3TWxOdFNrOU9WM1JvVjIwdFEwRlJkSGxoU0VwRVVucENWMlJJWjNwYU5FbENRM3BPVVZKcmJ6VlZNRlpWVlhwU1RtZG5SVXhPTURWUVZUQlNURmxxUWtsaVJsZERRVkYwVlZVd1JUSlNNRkUxVkZkc2RsUlpTVUpETWxJeFl6SmFkRlJHT1dsaVZFWjJaMmRGVEUxVmJ6QlpWR3hxVmtSS2MyRXpaVU5CVVhNMVZGUlNjVmR1Vm5oYVNHTjNUa2xKUWtNelRrZFBSRUpLVEZaU1VtRldZM2RuWjBWTVlsVmplRmxYVmtWT01qbHJZMWQxZVVGUldVdENRV2RYUlVGTWNVRlJVVWxCYUVGYUdJSGc2QmdpQzNObFlYSmphQzFtWldWayIsImYiOnsidXBsb2FkRGF0ZSI6bnVsbCwic29ydEJ5IjoicmVsZXZhbmNlIiwidHlwZSI6bnVsbCwiZHVyYXRpb24iOm51bGx9LCJyIjpudWxsfQ",
    "hasMore": true,
    "fetchedAt": "2026-11-05T19:15:07.802Z"
  },
  "meta": {
    "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
    "creditsCharged": 1,
    "creditsRemaining": 4999,
    "cached": false
  }
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request was invalid.",
    "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "API key required — pass it in the `x-api-key` header.",
    "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
  }
}

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "This request costs 1 credit, but your balance is 0. Top up to continue.",
    "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Request validation failed",
    "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
    "details": [
      {
        "path": "url",
        "message": "url is required"
      }
    ]
  }
}

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded — max 100 requests per 60s. Retry in ~30s.",
    "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
  }
}

{
  "error": {
    "code": "UPSTREAM_BLOCKED",
    "message": "The source is temporarily unavailable. Please try again shortly.",
    "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
  }
}