Search API

The search supports both GET and POST.

Furthermore, two endpoints / and /search are available for querying.

GET /

GET /search

Parameters

qrequired

The search query. This string is passed to external search services. Thus, SearXNG supports syntax of each search service. For example, site:github.com searx is a valid query for Google. However, if simply the query above is passed to any search engine which does not filter its results based on this syntax, you might not get the results you wanted.

See more at Search syntax

categoriesoptional

Comma separated list, specifies the active search categories

enginesoptional

Comma separated list, specifies the active search engines.

langdefault all

Code of the language.

pagenodefault 1

Search page number.

time_rangeoptional

[ day, month, year ]

Time range of search for engines which support it. See if an engine supports time range search in the preferences page of an instance.

formatoptional

[ json, csv, rss ]

Output format of results.

results_on_new_tabdefault 0

[ 0, 1 ]

Open search results on new tab.

image_proxydefault False

[ True, False ]

Proxy image results through searx.

autocompletedefault empty

[ google, dbpedia, duckduckgo, startpage, wikipedia ]

Service which completes words as you type.

safesearchdefault None

[ 0, 1, None ]

Filter search results of engines which support safe search. See if an engine supports safe search in the preferences page of an instance.

themedefault oscar

[ oscar, simple ]

Theme of instance.

Please note, available themes depend on an instance. It is possible that an instance administrator deleted, created or renamed themes on their instance. See the available options in the preferences page of the instance.

oscar-styledefault logicodev

[ pointhi, logicodev ]

Style of Oscar theme. It is only parsed if the theme of an instance is oscar.

Please note, available styles depend on an instance. It is possible that an instance administrator deleted, created or renamed styles on their instance. See the available options in the preferences page of the instance.

enabled_pluginsoptional

List of enabled plugins.

default

HTTPS_rewrite, Self_Informations, Search_on_category_select, Tracker_URL_remover

values

DOAI_rewrite, HTTPS_rewrite, Infinite_scroll, Vim-like_hotkeys, Self_Informations, Tracker_URL_remover, Search_on_category_select, Hostname_replace

disabled_plugins: optional

List of disabled plugins.

default

DOAI_rewrite, Infinite_scroll, Vim-like_hotkeys, Hostname_replace

values

DOAI_rewrite, HTTPS_rewrite, Infinite_scroll, Vim-like_hotkeys, Self_Informations, Tracker_URL_remover, Search_on_category_select, Hostname_replace

enabled_enginesoptionalall engines

List of enabled engines.

disabled_enginesoptionalall engines

List of disabled engines.