API Reference
Welcome to the Nefarious Labs API reference. Here you’ll find detailed documentation for all available endpoints.Base URL
Authentication
All API requests require an API key. Include it in the request header:Rate Limiting
Rate limits are applied per API key. When you exceed your rate limit, you’ll receive a429 Too Many Requests response.
Response headers include:
X-RateLimit-Limit: Your rate limitX-RateLimit-Remaining: Remaining requestsX-RateLimit-Reset: Unix timestamp when the limit resets
Error Handling
All errors follow a consistent format:Common Error Codes
| Code | HTTP Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Invalid or missing API key |
RATE_LIMITED | 429 | Rate limit exceeded |
INVALID_PARAMS | 400 | Invalid request parameters |
NOT_FOUND | 404 | Resource not found |
INTERNAL_ERROR | 500 | Internal server error |
SDKs
TypeScript SDK
Official TypeScript/JavaScript SDK
Python SDK
Official Python SDK