SearXNG Exceptions

Exception types raised by SearXNG modules.

exception searx.exceptions.SearxEngineAPIException

The website has returned an application error

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

The website is blocking the access

SUSPEND_TIME_SETTING = 'search.suspended_times.SearxEngineAccessDenied'

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

exception searx.exceptions.SearxEngineCaptchaException(suspended_time=None, message='CAPTCHA')

The website has returned a CAPTCHA.

SUSPEND_TIME_SETTING = 'search.suspended_times.SearxEngineCaptcha'

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

exception searx.exceptions.SearxEngineException

Error inside an engine

exception searx.exceptions.SearxEngineResponseException

Impossible to parse the result of an engine

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

The website has returned a Too Many Request status code

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

SUSPEND_TIME_SETTING = 'search.suspended_times.SearxEngineTooManyRequests'

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

exception searx.exceptions.SearxEngineXPathException(xpath_spec, message)

Error while getting the result of an XPath expression

exception searx.exceptions.SearxException

Base SearXNG exception.

exception searx.exceptions.SearxParameterException(name, value)

Raised when query miss a required parameter

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

Error while loading the settings

exception searx.exceptions.SearxXPathSyntaxException(xpath_spec, message)

Syntax error in a XPATH