POST/v1/data/youtube/videos

YouTube Videos

Get a channel's recent videos with view counts, duration, publish dates, and thumbnails. Accepts @handle or UC... channel ID.

Target Latency

1.2s - 4.5s

Credits

2 cr/req

Parameters

Name	Type	Requirement	Description
identifier	string	REQUIRED	Channel ID (UC...), @handle, or username. 1-100 characters.
limit	number	optional	Number of videos to return (1-50).

cURL Example

curl -X POST "https://api.datablue.dev/v1/data/youtube/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "identifier": "@mkbhd",
  "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": 3.15,
  "channel": "MKBHD",
  "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
  "count": 5,
  "videos": [
    {
      "video_id": "dQw4w9WgXcQ",
      "title": "The BEST Smartphones of 2026!",
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "views": 4200000,
      "views_text": "4.2M views",
      "published": "2 weeks ago",
      "duration": "22:14",
      "duration_seconds": 1334,
      "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
      "description": "Ranking the top smartphones I've tested this year..."
    },
    {
      "video_id": "abc123def456",
      "title": "Galaxy S26 Ultra Review: The Camera King?",
      "url": "https://www.youtube.com/watch?v=abc123def456",
      "views": 2800000,
      "views_text": "2.8M views",
      "published": "3 weeks ago",
      "duration": "18:07",
      "duration_seconds": 1087,
      "thumbnail": "https://i.ytimg.com/vi/abc123def456/maxresdefault.jpg"
    }
  ]
}