Errors

Handling errors in the API


Unsuccessful requests to the Noble SERP API will have a non-200 error code and return a JSON object describing the error. Errors in the 4xx range represent an error with your request and should not be retried. Errors in the 5xx range represent a server error and may be retried.


Error Schema

{    ok: bool, // will be false    type: string, // the error type    message: string, // a human readable error message    param: string, // the parameter that caused the error    status_code: int, // the http status code of the error}

Common Error Codes

Status CodeNameDescription
401missing_tokenThe API key was missing as part of the request.
422invalid_request_errorThe request was malformed - either a parameter was missing or is invalid
402credits_exhaustedThe account has run out of search credits.