ChannelCrawler API
Getting Started

Authentication

How to authenticate your request to ChannelCrawlers API.

Required headers

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

All API requests require a valid API key in the Authorization header.

Paste these headers into any request:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Example request (curl)

curl -X POST https://api.channelcrawler.com/v1/channels/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "country": { "United States" },
    "limit": 25
  }'

How to generate an API key

  1. Go to https://platform.channelcrawler.com
  2. Click API Keys in the left-hand menu
  3. Click Create Key
  4. Copy it — it will only be shown once

Your API key becomes active immediately. Your account must be approved before you will be able to create an API key.

Best practices

  • Keep keys secret — never commit them to public code
  • Use environment variables to store your API key securely
  • Rotate or revoke keys regularly
  • Create separate keys per environment (e.g. staging, production)

Common errors

Status CodeMeaningHow to fix
400Bad RequestCheck your request format — missing required fields, invalid JSON, or malformed parameters
401UnauthorisedKey is missing or incorrectly formatted
403ForbiddenKey has been revoked, expired, or is inactive
404Not FoundThe requested resource doesn't exist — check your endpoint URL or resource ID
422Unprocessable EntityThe request was well-formed but contained semantic errors, such as validation failures
429Too many requestsYou've hit a rate limit — slow down or contact support
500Internal Server ErrorSomething went wrong on our end — if this persists, contact support
503Service UnavailableThe service is temporarily unavailable — try again in a few moments