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).

Request and response

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
}'

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