Guides
Credits and Billing
How credits are estimated and billed in searches and email lookups.
ChannelCrawler uses a credit-based model.
- Channel search result without an email: 0.1 credits for the channel summary
- Channel search result with
include_email: true: 1.0 credit when an email exists; otherwise 0.1 credits for the channel summary - Standalone email lookup: 1.0 credit only if an email exists; 0 otherwise
- Video retrieval: 0.2 credits per 10 videos (0.02 credits per video), minimum 0.02 credits when results are returned, maximum 2.0 credits for up to 100 videos per request
- Channel timestamps (historical statistics): 0.5 credits for up to 90 days of returned data, 1.0 for up to 180 days, 1.5 for up to 270 days and 2.0 for up to 365 days; 0 if no data is returned. See Channel Timestamps.
Buying credits
- Buy credits from Billing in the API dashboard. The minimum purchase is $24.
- No subscription is needed. API credits are bought on their own, separately from ChannelCrawler web app plans.
- Purchased credits do not expire.
- There are no free testing credits. Search preview is free, so use it to check result volume and cost before your first paid search.
Estimating cost
Search endpoints include:
{
"estimated_cost": { "page_estimated_cost": 0.1 }
}This is an estimate for the current page based on the mix of channels likely to have viewable emails.
Enrichment responses such as videos and timestamps include the final charge as cost.total. REST responses also expose the same value in the x-cost-credits header.
Best practices
- Use search preview to check volume and cost before running full search.
- Paginate thoughtfully; each page returns up to your
limit. - Keep queries narrow when using large
limitvalues.