Rate Limits

Every API key has a daily request quota that resets at midnight UTC. Limits are enforced per API key, not per IP address.

Limits by Plan

Plan	Requests / day	Price
Developer (free)	1,000	Free
Starter	50,000	$29 / mo
Growth	500,000	$99 / mo
Business	Unlimited	$299 / mo

Rate Limit Headers

Every authenticated response includes these headers:

Header	Value	Description
`X-RateLimit-Limit`	`1000`	Your daily request quota
`X-RateLimit-Remaining`	`995`	Requests remaining today
`X-Plan`	`developer`	Your current plan name

Note: X-RateLimit-Reset is not currently returned. Quotas reset at midnight UTC daily.

Checking Your Usage

curl -v "https://api.c0r.ai/v1/search?q=apple" \
  -H "X-API-Key: fdb_your_key" 2>&1 | grep -i "x-ratelimit\|x-plan"

# Output:
# x-ratelimit-limit: 1000
# x-ratelimit-remaining: 995
# x-plan: developer

Handling 429 Errors

When you exceed your daily quota, the API returns HTTP 429:

HTTP/1.1 429 Too Many Requests

{
  "detail": "Daily rate limit exceeded."
}

Retry strategy: Wait until midnight UTC (when the quota resets) or upgrade your plan.

Per-Second Burst Limit

To prevent abuse, there is also a per-second limit. If you send too many requests within a single second, you may receive a 429 before your daily quota is exhausted. Space requests at least 100ms apart to avoid triggering this limit.