# ScrapeMole YouTube Channel Videos API

> ScrapeMole YouTube Channel Videos API is a paid API for AI agents from scrapemole-api-mainnet.scrapemole.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Fetches a list of videos (or shorts/streams) from a YouTube channel by handle, URL, or channel ID

## Facts

- Endpoint: GET https://scrapemole-api-mainnet.scrapemole.workers.dev/v1/youtube/channel?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/scrapemole-youtube-channel-videos-api-3d4371dd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lXpKAQAdtLniiaxMbbeX_

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability scrapemole-youtube-channel-videos-api-3d4371dd
```

Example prompt: Pull the 20 most recent videos from the @3blue1brown YouTube channel — I want titles, view counts, upload dates, and video URLs.

## When to prefer this

Use this endpoint when you need to programmatically list recent videos from a specific YouTube channel without a YouTube Data API key or quota concerns. It is ideal for agents monitoring creator output, researching channel content, or building video inventories. It is pay-per-successful-call with no account setup, making it low-friction for one-off or infrequent use. Prefer it over YouTube's official API when you want to avoid API key management, quota limits, or account registration.

## Known failure modes

- Invalid or non-existent channel handle returns an error (not charged)
- Channel with no videos in the requested tab returns empty results
- Rate limiting or YouTube blocking scrape returns an error (not charged)
- Limit parameter outside 1-50 range may be rejected
- Network timeout on scrape returns an error (not charged)
- Insufficient USDC balance causes payment failure before the call is made

## How this service works

Pay-per-call public web data for agents: Google Trends, YouTube transcripts, YouTube search, YouTube channel videos, YouTube video details, YouTube comments, YouTube playlists. Pay per successful call in USDC with x402; errors are never charged. No accounts, no API keys.

Payments: x402 v2, scheme "exact", USDC on Base (eip155:8453). The payment is verified before the scrape and settled only when the response is 200. Terms: https://scrapemole-api-mainnet.scrapemole.workers.dev/terms

## Output

Returns a JSON object with a count of videos and an array of video objects, each containing: video URL, title, video ID, channel name and ID, view count, like count, comment count, duration in seconds and text, upload/publish date, thumbnail URL, description snippet, category, badges (e.g. 4K), whether it is a short or live stream, and country availability count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "channel"
     ],
     "properties": {
      "tab": {
       "enum": [
        "videos",
        "shorts",
        "streams"
       ],
       "type": "string",
       "default": "videos",
       "description": "Which feed."
      },
      "limit": {
       "type": "string",
       "default": "20",
       "description": "Max videos (1-50)."
      },
      "channel": {
       "type": "string",
       "examples": [
        "@3blue1brown"
       ],
       "description": "Channel @handle, URL or UC… channel ID."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 2,
  "videos": [
   {
    "url": "https://www.youtube.com/watch?v=4MJnPVnY3_o",
    "title": "The Best Espresso Machine You've Never Heard Of",
    "badges": [
     "4K"
    ],
    "isLive": false,
    "isShort": false,
    "videoId": "4MJnPVnY3_o",
    "category": "People & Blogs",
    "keywords": [],
    "position": 2,
    "channelId": "UCu7x43fFlwbBykF1r04T_wQ",
    "isLiveNow": false,
    "likeCount": 1986,
    "viewCount": 158741,
    "channelUrl": "https://www.youtube.com/channel/UCu7x43fFlwbBykF1r04T_wQ",
    "sourceType": "search",
    "uploadDate": "2026-02-07T03:00:13-08:00",
    "channelName": "Daddy Got Coffee",
    "description": "The $3,000 espresso category hasn’t changed in years — until now.\nThe Arkel Coast brings saturated group performance, flow control, shot programming, and pro-level build into a price bracket where those specs normally don’t exist.\n\n10% off Arkel Coast at Cafune  - https://geni.us/ArkelCoast (Use - D…",
    "publishDate": "2026-02-07T03:00:13-08:00",
    "searchQuery": "espresso machine review",
    "commentCount": 280,
    "durationText": "20:15",
    "isFamilySafe": true,
    "thumbnailUrl": "https://i.ytimg.com/vi/4MJnPVnY3_o/maxresdefault.jpg",
    "channelHandle": "@DaddyGotCoffee",
    "publishedText": "8 months ago",
    "viewCountText": "158,741 views",
    "durationSeconds": 1215,
    "isShortsEligible": false,
    "isVerifiedChannel": false,
    "publishedAtApprox": "2026-02-07",
    "descriptionSnippet": "The $3000 espresso category hasn't changed in years — until now. The Arkel Coast brings saturated group performance, flow ...",
    "availableCountriesCount": 249
   },
   {
    "url": "https://www.youtube.com/watch?v=miNqgmVH9I0",
    "title": "Best Entry Level Espresso Machines 2025 – Our Top Picks for Beginners",
    "badges": [
     "4K"
    ],
    "isLive": false,
    "isShort": false,
    "videoId": "miNqgmVH9I0",
    "category": "Howto & Style",
    "keywords": [
     "best entry level espresso machine 2025",
     "espresso machine for beginners"
    ],
    "position": 3,
    "channelId": "UCJwRmBtnYh_7Xs9oXUrLhZg",
    "isLiveNow": false,
    "likeCount": 1259,
    "viewCount": 169694,
    "channelUrl": "https://www.youtube.com/channel/UCJwRmBtnYh_7Xs9oXUrLhZg",
    "sourceType": "search",
    "uploadDate": "2025-11-07T12:30:07-08:00",
    "channelName": "Whole Latte Love",
    "description": "Looking for the best entry level espresso machine in 2025? 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scrapemole-youtube-channel-videos-api-3d4371dd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from scrapemole-api-mainnet.scrapemole.workers.dev](https://www.zero.xyz/host/scrapemole-api-mainnet.scrapemole.workers.dev/llms.txt)
