Skip to main content

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:
Never expose your API key in client-side code. Always make API calls from your backend.

Rate Limiting

Rate limits are applied per API key. When you exceed your rate limit, you’ll receive a 429 Too Many Requests response. Response headers include:
  • X-RateLimit-Limit: Your rate limit
  • X-RateLimit-Remaining: Remaining requests
  • X-RateLimit-Reset: Unix timestamp when the limit resets

Error Handling

All errors follow a consistent format:

Common Error Codes

SDKs

TypeScript SDK

Official TypeScript/JavaScript SDK

Python SDK

Official Python SDK