Errors

The API uses standard HTTP status codes. Failures return a JSON body with an error string and a human-readable message.

Status codes

400

Bad Request

Missing or invalid parameters.

401

Unauthorized

Invalid or missing API key.

403

Forbidden

Feature requires a higher plan tier.

404

Not Found

The resource does not exist.

429

Rate Limited

Daily or monthly credit limit exceeded.

500

Server Error

Internal error. Retry after a short pause.

json

{
  "error": "Rate limit exceeded",
  "message": "Daily credit limit reached for this endpoint",
  "status": 429
}