ChannelCrawler API
Getting Started

Quickstart

Here are a few examples to get you started using the ChannelCrawler API.

1. Search for YouTube channels

curl -X POST \
  -H "Authorization: Bearer $CC_API_KEY" \
  -H "Content-Type: application/json" \
  https://api.channelcrawler.com/v1/channels/search \
  -d '{
    "ai_category": ["Gaming"]
  }'

2. Add email contacts to your results

curl -X POST \
  -H "Authorization: Bearer $CC_API_KEY" \
  -H "Content-Type: application/json" \
  https://api.channelcrawler.com/v1/channels/search \
  -d '{
    "ai_category": ["Gaming"],
    "include_email": true
  }'

3. Enrich a known YouTube channel with contact & performance data

You can send up to 10,000 channel IDs in a single request.

curl -X POST \
  -H "Authorization: Bearer $CC_API_KEY" \
  -H "Content-Type: application/json" \
  https://api.channelcrawler.com/v1/channels/search \
  -d '{
    "channel_ids": [
      "UC_x5XG1OV2P6uZZ5FSM9Ttw",
      "UC0vBXGSyV14uvJ4hECDOl0Q"
    ],
    "include_email": true
  }'

This will return only those channels where data is available, no empty results. If no email is available, only channel data will be provided.


Option B: Enrich a large batch (only return results with emails)

  1. Upload your list using /v1/imports
  2. Run a search with imports_include, include_email: true, and has_email: true
curl -X POST \
  -H "Authorization: Bearer $CC_API_KEY" \
  -H "Content-Type: application/json" \
  https://api.channelcrawler.com/v1/channels/search \
  -d '{
    "imports_include": ["import_12345"],
    "has_email": true,
    "include_email": true
  }'

This will return only the channels from your import that have emails available, and skip those without one.

For example, if you upload 10,000 channels and 8,000 have email data, you will only receive those 8,000 — and only pay for the results returned.


4. Remove known YouTube channels using an import

curl -X POST \
  -H "Authorization: Bearer $CC_API_KEY" \
  -H "Content-Type: application/json" \
  https://api.channelcrawler.com/v1/channels/search \
  -d '{
    "ai_category": ["Gaming"],
    "imports_exclude": ["import_12345"]
  }'

You can create an import via /v1/imports using either a CSV upload or a direct list of channel IDs.


5. Fetch data for a single channel using priority lookup

curl -X POST \
  -H "Authorization: Bearer $CC_API_KEY" \
  -H "Content-Type: application/json" \
  https://api.channelcrawler.com/v1/priority/channel \
  -d '{
    "channel_id": "UCxxxxxxxxxxxxxxx"
  }'

6. Get recent video data from a YouTube channel

curl -sS \
  -H "Authorization: Bearer $CC_API_KEY" \
  -H "Accept: application/json" \
  "https://api.channelcrawler.com/v1/channels/$CHANNEL_ID/videos?limit=50"

This will return the latest 50 videos, including publish date, title, views, and more. The limit can be altered to change the number of videos shown in the results.


7. Get timestamped performance data (subs/views)

curl -sS \
  -H "Authorization: Bearer $CC_API_KEY" \
  -H "Accept: application/json" \
  "https://api.channelcrawler.com/v1/channels/$CHANNEL_ID/timestamps?days=365&interpolate=true"

Returns historical subscriber and view growth data for up to 365 days.