Error codes

Written by

Updated at June 20, 2025

If search queries are handled incorrectly, the server response contains the error tag.

It has the following format:

<error code="error code">
Text description of the error</error>

The table below contains codes and descriptions of the most common errors that may occur when handling search queries.

Error code	Description
1	Query text (`query` field value) contains a syntax error. For example, two consecutive slash characters (`//`) are provided as a query.
2	The search query is empty (the `query` field has an empty value).
15	No search results are available for the search query.
18	Unable to validate the transmitted XML file, or query parameters are incorrect. Possible causes: Incorrect tags or tag values are provided. The query body contains unescaped special characters, e.g., the ampersand (`&`), etc. A page with search results whose positions exceed 1,000 is requested. For example, if each page contains 10 search results, an error is returned at an attempt to request 101st and further pages with results.
19	The search query contains incompatible parameters (e.g., incompatible `groupings` values).
20	Unknown error cause. If you encounter this error again, contact support.
31	The query includes an ID of a folder (`folderid`) whose user has not registered in Yandex Search API.
32	Limit on the allowed number of queries per day was exceeded. Learn about the limits and request a quota increase.
33	The IP address the search query was sent from does not match the one(s) specified during registration.
37	Error in query parameters. Some required parameters may be missing or mutually exclusive parameters defined.
42	The provided API key failed authentication or authorization. Check that your API key is valid and the service account used to send queries has the `search-api.executor` role.
44	The IP address you are trying to access is no longer supported. Fix the value to match the address specified during registration.
48	The search type specified during registration is different from the type used to request data. Correct the search type in your query or the management console.
55	The maximum allowed number of queries per second was exceeded.
100	It is highly likely that the query is bot-generated. If this error occurs, the user should get a CAPTCHA again.
10002	The maximum number of words per search query was exceeded.

Error codes

Was the article helpful?