| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120 |
- .. _search API:
- ==========
- Search API
- ==========
- The search supports both ``GET`` and ``POST``.
- Furthermore, two endpoints ``/`` and ``/search`` are available for querying.
- ``GET /``
- ``GET /search``
- Parameters
- ==========
- .. sidebar:: Further reading ..
- - :ref:`engines-dev`
- - :ref:`settings.yml`
- - :ref:`engines generic`
- ``q`` : required
- The search query. This string is passed to external search services. Thus,
- searx 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 :ref:`search-syntax`
- ``categories`` : optional
- Comma separated list, specifies the active search categories
- ``engines`` : optional
- Comma separated list, specifies the active search engines.
- ``lang`` : default ``all``
- Code of the language.
- ``pageno`` : default ``1``
- Search page number.
- ``time_range`` : optional
- [ ``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.
- ``format`` : optional
- [ ``json``, ``csv``, ``rss`` ]
- Output format of results.
- ``results_on_new_tab`` : default ``0``
- [ ``0``, ``1`` ]
- Open search results on new tab.
- ``image_proxy`` : default ``False``
- [ ``True``, ``False`` ]
- Proxy image results through searx.
- ``autocomplete`` : default *empty*
- [ ``google``, ``dbpedia``, ``duckduckgo``, ``startpage``, ``wikipedia`` ]
- Service which completes words as you type.
- ``safesearch`` : default ``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.
- ``theme`` : default ``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-style`` : default ``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_plugins`` : optional
- 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`` ]
- ``disabled_plugins``: optional
- List of disabled plugins.
- :default: ``DOAI_rewrite``, ``Infinite_scroll``, ``Vim-like_hotkeys``
- :values: ``DOAI_rewrite``, ``HTTPS_rewrite``, ``Infinite_scroll``,
- ``Vim-like_hotkeys``, ``Self_Informations``, ``Tracker_URL_remover``,
- ``Search_on_category_select``
- ``enabled_engines`` : optional : *all* :origin:`engines <searx/engines>`
- List of enabled engines.
- ``disabled_engines`` : optional : *all* :origin:`engines <searx/engines>`
- List of disabled engines.
|
