POST/v1/data/youtube/search

YouTube Search

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

Target Latency

1.2s - 4.5s

Credits

2 cr/req

Parameters

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

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