# CrowdPull YouTube Scraper Intelligence API

> CrowdPull YouTube Scraper Intelligence API is a paid API for AI agents from crowdpull.click, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Scrapes YouTube videos, channels, playlists, and search results into structured datasets including metadata, comments, and subtitles

## Facts

- Endpoint: POST https://crowdpull.click/api/actors/youtube-scraper-intelligence/call
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crowdpull-youtube-scraper-intelligence-api-d4fe8690
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7Bf-8O7nxpMpemwqH9nGk

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 crowdpull-youtube-scraper-intelligence-api-d4fe8690 -d '<json body>'
```

Example prompt: Search YouTube for 'best espresso machines 2024' and pull the top 50 video results with their metadata, subtitles, and comments so I can analyze what people are saying about home espresso gear.

## When to prefer this

Use this endpoint when you need structured YouTube data — video metadata, comments, subtitles, or channel listings — at scale without managing your own scraping infrastructure. Prefer this over direct YouTube Data API when you need comments or subtitles alongside video data, or when API quota limits are a concern. Best suited for research, competitive analysis, content auditing, or dataset building from YouTube public content.

## Known failure modes

- Invalid or private YouTube URL returns an error or empty result set
- maxResults or maxVideos exceeding 250 is rejected with validation error
- Job times out if waitForFinishSeconds is too low for large scrapes
- Payment failure (x402) if USDC balance is insufficient
- Actor runner error if YouTube blocks the scrape
- Missing resultSetId if job has not completed yet

## How this service works

CrowdPull turns public web pages into useful datasets for marketplaces, housing, reviews, jobs, social posts, drug prices, video, and public records.

## Output

Returns a job token and job object with an ID and status (and optionally a resultSetId). The agent must poll or wait for the async job to complete to retrieve the actual scraped YouTube dataset containing video metadata, comments, subtitles, and channel information.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "required": [],
   "properties": {
    "url": {
     "type": "string",
     "description": "Single public URL accepted by the selected source."
    },
    "urls": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Public URLs accepted by the selected source."
    },
    "query": {
     "type": "string",
     "description": "Search query or keyword."
    },
    "location": {
     "type": "string",
     "description": "City, ZIP, state, neighborhood, or source-supported location."
    },
    "maxItems": {
     "type": "integer",
     "default": 25,
     "maximum": 250,
     "minimum": 1
    },
    "maxVideos": {
     "type": "integer",
     "maximum": 250,
     "minimum": 1
    },
    "startUrls": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Public source URLs to collect from."
    },
    "videoUrls": {
     "type": "array",
     "items": {
      "type": "string"
     }
    },
    "maxResults": {
     "type": "integer",
     "default": 25,
     "maximum": 250,
     "minimum": 1
    },
    "channelUrls": {
     "type": "array",
     "items": {
      "type": "string"
     }
    },
    "maxListings": {
     "type": "integer",
     "default": 25,
     "maximum": 250,
     "minimum": 1
    },
    "searchQuery": {
     "type": "string",
     "description": "Search query or keyword."
    },
    "playlistUrls": {
     "type": "array",
     "items": {
      "type": "string"
     }
    },
    "includeDetails": {
     "type": "boolean",
     "default": false
    },
    "includeComments": {
     "type": "boolean",
     "default": false
    },
    "includeSubtitles": {
     "type": "boolean",
     "default": true
    }
   },
   "description": "YouTube Scraper Intelligence input. Pass the same public URLs, search terms, filters, and limits you would use on the source page. Extra source-specific fields are forwarded to the runner.",
   "additionalProperties": true
  },
  "options": {
   "type": "object",
   "properties": {
    "build": {
     "type": "string",
     "maxLength": 100,
     "minLength": 1
    },
    "memory": {
     "type": "integer",
     "maximum": 8192,
     "minimum": 128
    },
    "waitForFinishSeconds": {
     "type": "integer",
     "default": 10,
     "maximum": 60,
     "minimum": 0
    }
   },
   "description": "Optional CrowdPull job options. CrowdPull caps each paid job so low-cost agen
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "type": "object",
  "required": [
   "token",
   "job"
  ],
  "properties": {
   "job": {
    "type": "object",
    "required": [
     "id",
     "status"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "status": {
      "type": "string"
     },
     "resultSetId": {
      "type": "string"
     }
    },
    "additionalProperties": true
   },
   "token": {
    "type": "string"
   }
  },
  "additionalProperties": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crowdpull-youtube-scraper-intelligence-api-d4fe8690/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from crowdpull.click](https://www.zero.xyz/host/crowdpull.click/llms.txt)