API Reference
Channels — Videos
List recent videos for a channel with billing details and examples.
GET /v1/channels/:channel_id/videos
List recent videos for a given channel.
Use /v1/channels/:channel_id/videos to return the most recent video data for a YouTube channel.
- Add
limit=1to return just the latest video. - Returns title, views, publish date, description, and more.
- Great for checking content quality or confirming a channel is still active.
Billing
| Videos Returned | Credits Charged |
|---|---|
| 1 video | 0.02 |
| 10 videos | 0.20 |
| 50 videos | 1.00 |
| 100 videos (max) | 2.00 |
- Billing is based on the number of videos actually returned, not the requested limit.
- The minimum charge is 0.02 credits when at least one video is returned; an empty result is free.
- The maximum charge is 2.00 credits per request.
- REST responses include the charge in the
x-cost-creditsheader. The JSON response also includes it ascost.total, including when this endpoint is called through MCP.
Example: Get latest video for a channel
curl -sS \
-H "Authorization: Bearer $CC_API_KEY" \
-H "Accept: application/json" \
"https://api.channelcrawler.com/v1/channels/$CHANNEL_ID/videos?limit=1"Replace $CHANNEL_ID with the actual channel ID you want to look up.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
limit | integer (1–100) | Maximum number of videos to return (default: 10) |
🧷 Response Structure
The response includes channel and video metadata:
{
"channel_id": "UCabc123def456ghi789",
"count": 1,
"limit": 1,
"videos": [
{
"video_id": "abc123xyz",
"title": "5 Ways to Grow Your YouTube Channel in 2025",
"description": "This video breaks down five practical tips to boost growth and engagement on YouTube this year.",
"views": 48231,
"length": 615,
"likes": 2134,
"comments": 342,
"is_made_for_kids": false,
"is_monetized": true,
"category_id": 27,
"language_id": "en",
"keywords": [
"YouTube tips",
"creator growth",
"audience retention",
"video SEO"
],
"published_at": "2025-10-01T14:00:00Z",
"created_at": "2025-10-01T15:10:45Z",
"updated_at": "2025-10-02T06:12:33Z"
}
],
"cost": {
"total": 0.02
}
}| Field | Type | Description |
|---|---|---|
channel_id | string | The requested YouTube channel ID. |
count | integer | Number of videos actually returned in videos. |
limit | integer | Maximum number of videos requested. |
videos | array | Recent videos for the channel. |
cost.total | number | Credits charged for this response. |
Error Codes
| Code | Meaning |
|---|---|
401 | Missing or invalid API key |
402 | Not enough credits |
4xx | Invalid request (e.g. malformed or out-of-range) |
504 | Upstream timeout |
Best For
- Check whether a channel is active and consistent
- Identify videos with strong or weak engagement
- Scan for relevant keywords or brand mentions
- Understand consistency of views