API Authentication

Competitor Watch provides a RESTful API for programmatic access to your data.

Base URL

• Production: https://app.competitor.watch/api
• Staging: https://staging.competitor.watch/api

Authentication Methods

The API supports two authentication methods:

Session-Based Authentication

For web requests, use session cookies from your logged-in browser session.

API Key Authentication

For programmatic access, use API keys. See API Keys for details.

Authorization Header

When using API keys, include the key in the Authorization header:

Authorization: Bearer your_api_key

Rate Limits

• Web requests: 100 requests per minute per user
• API key requests: 1000 requests per minute per key

Rate limit information is included in response headers:

• X-RateLimit-Limit: Maximum requests allowed
• X-RateLimit-Remaining: Remaining requests in current window
• X-RateLimit-Reset: Time when the rate limit resets