zaclys
/
searxng
mirror of https://github.com/searxng/searxng.git
1
0
Fork 1
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #1548 from return42/fix-1541 

[fix] update documentation of the Search-API (/dev)
This commit is contained in:
Markus Heiser 2022-07-24 20:21:18 +02:00 committed by GitHub
parent 6a479f41c5 eb85474920
commit 55d1936bdc
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 18 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
docs/dev/search_api.rst
View File

@ -32,12 +32,14 @@ Parameters
See more at :ref:`search-syntax` See more at :ref:`search-syntax`
``categories`` : optional ``categories`` : optional
Comma separated list, specifies the active search categories Comma separated list, specifies the active search categories (see
:ref:`configured engines`)
``engines`` : optional ``engines`` : optional
Comma separated list, specifies the active search engines. Comma separated list, specifies the active search engines (see
:ref:`configured engines`).
``lang`` : default ``all`` ``language`` : default from :ref:`settings search`
Code of the language. Code of the language.
``pageno`` : default ``1`` ``pageno`` : default ``1``
@ -52,25 +54,27 @@ Parameters
``format`` : optional ``format`` : optional
[ ``json``, ``csv``, ``rss`` ] [ ``json``, ``csv``, ``rss`` ]
Output format of results. Output format of results. Format needs to be activated in :ref:`settings
search`.
``results_on_new_tab`` : default ``0`` ``results_on_new_tab`` : default ``0``
[ ``0``, ``1`` ] [ ``0``, ``1`` ]
Open search results on new tab. Open search results on new tab.
``image_proxy`` : default ``False`` ``image_proxy`` : default from :ref:`settings server`
[ ``True``, ``False`` ] [ ``True``, ``False`` ]
Proxy image results through SearXNG. Proxy image results through SearXNG.
``autocomplete`` : default *empty* ``autocomplete`` : default from :ref:`settings search`
[ ``google``, ``dbpedia``, ``duckduckgo``, ``startpage``, ``wikipedia`` ] [ ``google``, ``dbpedia``, ``duckduckgo``, ``startpage``, ``wikipedia``,
``swisscows``, ``qwant`` ]
Service which completes words as you type. Service which completes words as you type.
``safesearch`` : default ``None`` ``safesearch`` : default from :ref:`settings search`
[ ``0``, ``1``, ``None`` ] [ ``0``, ``1``, ``2`` ]
Filter search results of engines which support safe search. See if an engine Filter search results of engines which support safe search. See if an engine
supports safe search in the preferences page of an instance. supports safe search in the preferences page of an instance.
@ -92,15 +96,17 @@ Parameters
:values: ``DOAI_rewrite``, ``HTTPS_rewrite``, ``Infinite_scroll``, :values: ``DOAI_rewrite``, ``HTTPS_rewrite``, ``Infinite_scroll``,
``Vim-like_hotkeys``, ``Self_Informations``, ``Tracker_URL_remover``, ``Vim-like_hotkeys``, ``Self_Informations``, ``Tracker_URL_remover``,
``Search_on_category_select``, ``Hostname_replace`` ``Search_on_category_select``, ``Hostname_replace``, ``Tor_check_plugin``
``disabled_plugins``: optional ``disabled_plugins``: optional
List of disabled plugins. List of disabled plugins.
:default: ``DOAI_rewrite``, ``Infinite_scroll``, ``Vim-like_hotkeys``, ``Hostname_replace`` :default: ``DOAI_rewrite``, ``Infinite_scroll``, ``Vim-like_hotkeys``,
``Hostname_replace``, ``Tor_check_plugin``
:values: ``DOAI_rewrite``, ``HTTPS_rewrite``, ``Infinite_scroll``, :values: ``DOAI_rewrite``, ``HTTPS_rewrite``, ``Infinite_scroll``,
``Vim-like_hotkeys``, ``Self_Informations``, ``Tracker_URL_remover``, ``Vim-like_hotkeys``, ``Self_Informations``, ``Tracker_URL_remover``,
``Search_on_category_select``, ``Hostname_replace`` ``Search_on_category_select``, ``Hostname_replace``, ``Tor_check_plugin``
``enabled_engines`` : optional : *all* :origin:`engines <searx/engines>` ``enabled_engines`` : optional : *all* :origin:`engines <searx/engines>`
List of enabled engines. List of enabled engines.