Error Messages and Codes for Yahoo! Search

This document describes the various error code responses you might see when making an API call. If there is a problem serving your request, you'll receive a response with an HTTP error code and an XML error response.

The Error Codes

Following is a list of the HTTP error codes you may encounter:

Code Description
400 Bad request. The parameters passed to the service did not match as expected. The Message should tell you what was missing or incorrect.
403 Forbidden. You do not have permission to access this resource, or are over your rate limit.
503 Service unavailable. An internal problem prevented us from returning data to you.

The XML body

For each error, you'll receive an XML response of the following form: