Authentication

All API requests require authentication using an API key. Get your API key from the dashboard after signing up.

API Key Authentication

Include your API key in the X-API-KEY header with every request.

curl -X GET "https://app.scrappa.co/api/google/search?q=coffee" \
  -H "X-API-KEY: YOUR_API_KEY"

Getting Your API Key

  1. Sign up for a free account at app.scrappa.co
  2. Navigate to your Dashboard
  3. Go to the API Keys section
  4. Copy your API key or create a new one

Authentication Errors

If your API key is missing or invalid, you'll receive a 401 Unauthenticated response:

{
  "message": "Unauthenticated"
}

Security Best Practices

  • Never commit your API key to version control
  • Store API keys in environment variables or secure configuration files
  • Rotate your API keys regularly
  • Use different API keys for different environments (development, staging, production)
  • If your API key is compromised, revoke it immediately and generate a new one