Skip to content
Back to top
View this page
Edit this page

# 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