ChannelCrawler API
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=1 to 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 ReturnedCredits Charged
1 video0.02
10 videos0.20
50 videos1.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-credits header. The JSON response also includes it as cost.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

ParameterTypeDescription
limitinteger (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
  }
}
FieldTypeDescription
channel_idstringThe requested YouTube channel ID.
countintegerNumber of videos actually returned in videos.
limitintegerMaximum number of videos requested.
videosarrayRecent videos for the channel.
cost.totalnumberCredits charged for this response.

Error Codes

CodeMeaning
401Missing or invalid API key
402Not enough credits
4xxInvalid request (e.g. malformed or out-of-range)
504Upstream 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