YouTube Search

Search YouTube for videos. Returns video metadata including channel info, view counts, duration, thumbnails, and badges.

Execution model

Live request

Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.

Credit weight

Live catalog

Current weights are managed from the Data API Weights admin table and shown on pricing before use.

Parameters

Name	Type	Requirement	Description
query	string	Required	Search keywords (1-500 characters).
limit	number	Optional	Maximum video results (1-50).

Code example

curl -X POST "https://api.datablue.dev/v1/data/youtube/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "python web scraping tutorial 2026",
  "limit": 5
}'

System responses

200 OK

Request processed successfully.

401 UNAUTHORIZED

Missing or invalid API key.

429 RATE LIMIT

System capacity exceeded.

500 SYSTEM FAILURE

Internal core exception.

Example response

{
  "success": true,
  "time_taken": 2.87,
  "query": "python web scraping tutorial 2026",
  "count": 5,
  "results": [
    {
      "video_id": "xyz789abc123",
      "title": "Python Web Scraping Full Course 2026 - BeautifulSoup, Selenium, Playwright",
      "url": "https://www.youtube.com/watch?v=xyz789abc123",
      "channel": "Tech With Tim",
      "channel_id": "UC4JX40jDee_tINbkjycV4Sg",
      "views": 890000,
      "views_text": "890K views",
      "published": "1 month ago",
      "duration": "3:42:15",
      "duration_seconds": 13335,
      "thumbnail": "https://i.ytimg.com/vi/xyz789abc123/maxresdefault.jpg",
      "description": "Learn web scraping from scratch with Python...",
      "badges": [
        "New"
      ]
    },
    {
      "video_id": "def456ghi789",
      "title": "Scrape Any Website in 5 Minutes with Python",
      "url": "https://www.youtube.com/watch?v=def456ghi789",
      "channel": "Fireship",
      "channel_id": "UCsBjURrPoezykLs9EqgamOA",
      "views": 1200000,
      "views_text": "1.2M views",
      "published": "2 months ago",
      "duration": "8:23",
      "duration_seconds": 503,
      "thumbnail": "https://i.ytimg.com/vi/def456ghi789/maxresdefault.jpg"
    }
  ]
}