Errors

How the NewsRank API communicates errors.

Error Format

All error responses return a JSON object with error and status fields.

json

{
  "error": "Invalid or missing API key",
  "status": 401
}

Code	Name	Description
`400`	Bad Request	The request was malformed or missing required parameters.
`401`	Unauthorized	Invalid or missing API key.
`403`	Forbidden	Your API key does not have sufficient scope for this operation.
`404`	Not Found	The requested resource does not exist.
`429`	Too Many Requests	You have exceeded the rate limit. See Rate Limits.
`500`	Internal Server Error	An unexpected error occurred on the server.

400 Bad Request

The request was malformed or missing required parameters.

401 Unauthorized

Invalid or missing API key.

403 Forbidden

Your API key does not have sufficient scope for this operation.

404 Not Found

The requested resource does not exist.

429 Too Many Requests

You have exceeded the rate limit. See Rate Limits.

500 Internal Server Error

An unexpected error occurred on the server.