Marginalia Search¶

Marginalia Search is an independent open source Internet search engine operating out of Sweden. It is principally developed and operated by Viktor Lofgren .

Marginalia Filters¶

Custom filters enable server-side customization of Marginalia search results. Filter definitions are written in XML and scoped to an API key. Filters can not be used with the public API key public. The Marginalia Filter Editor can be used to create custom filters with a GUI. Alternatively, filters can be written manually in XML. To associate a filter definition with an API key, upload the XML data to the /filter/<NAME> API endpoint, where <NAME> is the name for the newly created filter. For more information, see the Marginalia filters announcement blogpost and the official Marginalia API documentation.

Configuration¶

The engine has the following required settings:

api_key

The engine has the following optional settings:

filter_name

You can configure a Marginalia engine by:

- name: marginalia
  engine: marginalia
  shortcut: mar
  api_key: ...
  filter_name: ...

Implementations¶

searx.engines.marginalia.api_key = None¶: To get an API key, please follow the instructions from Key and license

searx.engines.marginalia.filter_name: str | None = None¶: The name of the custom filter to apply to each search.

class searx.engines.marginalia.ApiSearchResult[source]¶: Marginalia’s ApiSearchResult class definition.

class searx.engines.marginalia.ApiSearchResults[source]¶: Marginalia’s ApiSearchResults class definition.