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)
- Upload your list using
/v1/imports - Run a search with
imports_include,include_email: true, andhas_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.