Status Codes

The Seekr API follows standard HTTP status codes with each response.

HTTP Status Code	Status	Description
200	Success	Successful request! Check the body for appropriate response.
204	Success (No content)	The request was successful and completed, but there is no content to return. Commonly used for successful DELETE operations.
400	Bad Request	Something was incorrect in the request being made. Examples: missing required parameters for a method, malformed request data or bad format. See the message field for specific reason
401	Unauthorized	The request either had no Authorization header included, was wrongly formatted or the Seekr API key passed is not valid. Please contact us.
403	Forbidden	The Seekr API key passed as valid but does not have permission to access the method it was calling.
404	Not Found	Incorrect URL that does not exist. Check the URL for the individual method you are trying to access.
422	Unprocessable Entity	The request was valid but contains semantic errors. This occurs when request validation fails—for example, missing required parameters, incorrect data types, or values that don't meet validation requirements. The response includes detailed validation error messages.
500	Internal Server Error	Oops, that wasn't supposed to happen. Something unexpected went wrong on the Seekr API end. This automatically triggers alerts that engineers respond to.
503	Service Unavailable	Service is temporarily unavailable. This is highly uncommon and would be preceded by a notice of scheduled maintenance.

Additional error information

Along with the specific the status code, the response will contain additional information about the error with the request. A sample error response will look like this:

{
  "error": "Bad Request",
  "feedVersion": "1.0.0",
  "message": "The URL is malformed",
  "requestUrl": "https://services-api.seekr.com/api/v1/news/?url=https%3A%2F%2Fnews.com%2Farticle",
  "status": 400
}

The message field will contain useful and specific information about the error to aid the developer in resolving the problem.