ChannelCrawler API
Getting Started

API pathways

This section explains the key API workflows for ChannelCrawlers API

This section explains the key API workflows for working with YouTube channels, from discovering new ones to enriching known lists or pulling performance insights.

All requests to the ChannelCrawler API share the same root pathway: https://api.channelcrawler.com

Every endpoint builds from this base URL. ChannelCrawler has also created different pathways to guardrail users from accidentally using too many credits, in addition to making the API easier to use.

TaskUse this pathEndpoint
Discover new channelsSearch/v1/channels/search
Discovery – include email contactSearch (include_email)/v1/channels/search with include_email: true
Enrich your dataImport → Search/v1/imports → /v1/channels/search
Exclude channelsImports (used as exclude)/v1/imports + use in /v1/channels/search
Preview number of resultsPreview/v1/channels/search:preview
Real-time end user requestPriority Lookup/v1/priority/channel
Fetch video dataVideos/v1/channels/$CHANNEL_ID/videos?limit=1
Fetch historical performance dataTimestamps/v1/channels/$CHANNEL_ID/timestamps

Use /v1/channels/search:preview to estimate how many YouTube channels match your filters — without using credits.

  • Useful for testing filters before running a full search.
  • Returns a small sample (1–10 channels), and an estimate of results.
  • No credits charged.

2. Search for YouTube channels

Use /v1/channels/search to run a full discovery query and return matching YouTube channels.

  • Filter by category, location, language, keywords, views per month & more
  • Add include_email: true to enrich with emails
  • Up to 100 results per request, use pagination to access more.
  • Also supports:
    • channel_ids: filter by specific YouTube channels (max 10,000)
    • exclude_channel_ids: exclude known YouTube channels from the results

3. Priority lookup (real-time)

Use /v1/priority/channel to get near-instant data on a single YouTube channel.

  • Ideal for sign-up flows, pricing tools, or real-time UX.
  • Returns data in ~6 seconds (faster if channel is known to us).
  • One channel per request.
  • Charged at a premium credit rate.

4. Import YouTube channels

Use /v1/imports to upload large lists of YouTube channel URLs or IDs.

  • Designed for bulk enrichment or deduplication workflows.
  • Use the import ID to exclude those channels from searches.
  • Use the import to obtain contact information
  • Returns an import ID you can reuse.

Example use cases:

  • Enrich YouTube channels with contact and performance data.
  • Suppress a CRM list from future discovery searches.

5. Fetch recent videos

Use /v1/channels/videos to return the most recent videos for a YouTube channel.

  • Add limit=1 for just the latest, or change for more videos data.
  • Returns title, publish date, views, description, and more.
  • Great for checking relevance or verifying recent uploads.

Example:

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

6. Get timestamped performance data

Use /v1/channels/$CHANNEL_ID/timestamps to return historical view and subscriber growth.

  • Add ?days=365 for 1 year of daily data.
  • Add &interpolate=true to fill in any missing data points.
  • Useful for long-term trend analysis or growth scoring.

Example:

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