YouTube Scrape

API Documentation

Search Endpoint

The base URL to get search results:

GET https://your-worker.workers.dev/api/search

Query Parameters

Parameter	Type	Required	Description
q	string	Yes	The search query for YouTube
pageToken	string	No	Token for pagination (returned in previous response)
key	string	No*	Required if using pageToken. Returned in initial response

Example Request

GET https://your-worker.workers.dev/api/search?q=cloudflare

Example Response

{
  "results": [
    {
      "video": {
        "id": "video-id",
        "title": "Video Title",
        "url": "https://www.youtube.com/watch?v=video-id",
        "duration": "12:34",
        "snippet": "",
        "upload_date": "1 month ago",
        "thumbnail_src": "https://i.ytimg.com/vi/video-id/default.jpg",
        "views": "1,234,567 views"
      },
      "uploader": {
        "username": "Channel Name",
        "url": "https://www.youtube.com/@channel-name",
        "verified": true
      }
    }
  ],
  "version": "0.1.5",
  "parser": "json_format",
  "key": "api-key",
  "estimatedResults": "1234567",
  "nextPageToken": "next-page-token"
}

Pagination

To get the next page of results, use the nextPageToken and key from the previous response:

GET https://your-worker.workers.dev/api/search?q=cloudflare&pageToken=next-page-token&key=api-key

Error Responses

Status Code	Description
400	Missing required query parameter
500	Server error or YouTube parsing error