Errors

Public API errors use a consistent JSON shape.

{
  "error": {
    "type": "invalid_request",
    "message": "Invalid value",
    "field": "type"
  }
}

Fields

Field	Type	Description
`error.type`	string	Machine-readable error category.
`error.message`	string	Human-readable summary.
`error.field`	string or null	Field related to the error, when available.

Status	Meaning
`400`	Invalid query, parameter, or request shape.
`404`	Public resource was not found.
`500`	Temporary server failure.

Retry temporary failures with backoff. Do not retry invalid requests without changing the request.

For search UX, keep the previous stable result visible while a new request is running when possible.