SearXNG Exceptions

Exception types raised by SearXNG modules.

exception searx.exceptions.SearxException

Base SearXNG exception.

exception searx.exceptions.SearxParameterException(name: str, value: Any)

Raised when query miss a required parameter

final exception searx.exceptions.SearxSettingsException(message: str | Exception, filename: str | None)

Error while loading the settings

exception searx.exceptions.SearxEngineException

Error inside an engine

exception searx.exceptions.SearxXPathSyntaxException(xpath_spec: str | XPath, message: str)

Syntax error in a XPATH

exception searx.exceptions.SearxEngineResponseException

Impossible to parse the result of an engine

exception searx.exceptions.SearxEngineAPIException

The website has returned an application error

exception searx.exceptions.SearxEngineAccessDeniedException(suspended_time: int | None = None, message: str = 'Access denied')

The website is blocking the access

SUSPEND_TIME_SETTING: str = 'search.suspended_times.SearxEngineAccessDenied'

This settings contains the default suspended time (default 86400 sec / 1 day).

exception searx.exceptions.SearxEngineCaptchaException(suspended_time: int | None = None, message: str = 'CAPTCHA')

The website has returned a CAPTCHA.

SUSPEND_TIME_SETTING: str = 'search.suspended_times.SearxEngineCaptcha'

This settings contains the default suspended time (default 86400 sec / 1 day).

exception searx.exceptions.SearxEngineTooManyRequestsException(suspended_time: int | None = None, message: str = 'Too many request')

The website has returned a Too Many Request status code

By default, SearXNG stops sending requests to this engine for 1 hour.

SUSPEND_TIME_SETTING: str = 'search.suspended_times.SearxEngineTooManyRequests'

This settings contains the default suspended time (default 3660 sec / 1 hour).

exception searx.exceptions.SearxEngineXPathException(xpath_spec: str | XPath, message: str)

Error while getting the result of an XPath expression