API Reference
Complete API reference for zerocut.gg
API Reference
Complete API reference for zerocut.gg user-facing API.
Authentication
All API requests require an API key passed in the x-api-key header:
curl -H "x-api-key: zerocut.your_api_key_here" \
https://zerocut.gg/api/v1/profile/getYou can create and manage API keys in your dashboard settings.
Rate Limiting
The API enforces a sliding window rate limit of 60 requests per minute per user account. All API keys belonging to the same account share this limit.
Response Headers
Every API response includes rate limit headers:
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests allowed per window (60) |
X-RateLimit-Remaining | Requests remaining in the current window |
X-RateLimit-Reset | Unix timestamp (seconds) when the window resets |
Rate Limit Exceeded
When the limit is exceeded, the API returns a 429 Too Many Requests response with an additional Retry-After header indicating how many seconds to wait:
{
"error": "Rate limit exceeded. Please try again later.",
"code": "TOO_MANY_REQUESTS"
}Best Practices
- Monitor the
X-RateLimit-Remainingheader and back off before hitting 0 - Cache responses client-side when possible
- Use the
Retry-Afterheader to schedule retries after a 429 response