ScrapeThis API Docs

Authentication

All API requests require a Bearer token in the Authorization header.

Getting an API Key

  1. Log in to your dashboard
  2. Navigate to Settings → API Keys
  3. Click "Generate New Key"
  4. Copy and store your key securely — it's only shown once

Using Your API Key

Include the key in every request via the Authorization header:

Authorization Header
"text">-green-400">curl https://scrapethis.app/api/v1/spiders \
  "text-cyan-400">-H "Authorization: Bearer st_your_api_key_here"

Error Responses

401 Missing or Invalid Key

The Authorization header is missing, malformed, or the key is invalid.

Security Best Practices

  • Store keys in environment variables, never in code
  • Use different keys for different environments
  • Rotate keys periodically
  • Revoke keys immediately if compromised
  • Never share keys in public repositories