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.
| Task | Use this path | Endpoint |
|---|---|---|
| Discover new channels | Search | /v1/channels/search |
| Discovery – include email contact | Search (include_email) | /v1/channels/search with include_email: true |
| Enrich your data | Import → Search | /v1/imports → /v1/channels/search |
| Exclude channels | Imports (used as exclude) | /v1/imports + use in /v1/channels/search |
| Preview number of results | Preview | /v1/channels/search:preview |
| Real-time end user request | Priority Lookup | /v1/priority/channel |
| Fetch video data | Videos | /v1/channels/$CHANNEL_ID/videos?limit=1 |
| Fetch historical performance data | Timestamps | /v1/channels/$CHANNEL_ID/timestamps |
1. Preview a YouTube channel search
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: trueto 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=1for 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=365for 1 year of daily data. - Add
&interpolate=trueto 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