ChannelCrawler API
Core Concepts

Enrichment

Enrich a known channel with perfomance data, email contact, video data and timestamped data

Enrichment is used when you already know which YouTube channels you want to look up more information. It lets you retrieve contact information, social links, and performance metrics for any channel — either individually or at scale.

Enrich known YouTube channels

Use this when you already have a list of YouTube channel IDs or URLs. 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 request will:

  • Return channel summaries (subscriber count, category, activity, average views)
  • Add business email and social links when available
  • Skip empty or missing results — you only receive valid data

If an email isn't found, the response still includes the channel's performance data.


Enrich a large batch (imports)

Use this when you've already uploaded a list of channels using the /v1/imports endpoint. You can then enrich that import to return only results with contact emails.

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
  }'

Get recent video data from a YouTube channel

Use this endpoint to fetch the latest videos for a given YouTube channel. It returns key performance details such as publish date, title, view count, and engagement metrics.

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

Get timestamped performance data (subs/views)

Use this endpoint to fetch historical performance metrics for a given YouTube channel. It returns timestamped snapshots of subscriber and view counts over time.

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"

This request will:

  • Return daily snapshots of subscriber and view counts
  • Cover up to 365 days of history (controlled by the days parameter)
  • Use interpolate=true to fill missing days for smoother trend analysis