searx/_sources/dev/search_api.txt

34 lines
2.4 KiB
Plaintext
Raw Normal View History

2015-11-17 23:38:25 +01:00
Search API
==========
2016-09-06 18:14:11 +02:00
The search supports both ``GET`` and ``POST``.
2015-11-17 23:38:25 +01:00
2016-07-09 22:32:57 +02:00
Furthermore, two enpoints ``/`` and ``/search`` are available for querying.
.. code:: sh
GET /
.. code:: sh
GET /search
2015-11-17 23:38:25 +01:00
Parameters
2016-07-09 22:32:57 +02:00
``````````
2015-11-17 23:38:25 +01:00
+------------------+----------------------------------------------------------------------------------------------------+-----------------------------+
| Name | Description | |
+==================+====================================================================================================+=============================+
| ``q`` | The search query, see :doc:`/user/search_syntax` | required |
+------------------+----------------------------------------------------------------------------------------------------+-----------------------------+
| ``categories`` | Comma separated list, specifies the active search categories | optional |
+------------------+----------------------------------------------------------------------------------------------------+-----------------------------+
| ``engines`` | Comma separated list, specifies the active search engines | optional |
+------------------+----------------------------------------------------------------------------------------------------+-----------------------------+
2016-07-09 22:32:57 +02:00
| ``lang`` | Code of the language | optional (default: ``all``) |
+------------------+----------------------------------------------------------------------------------------------------+-----------------------------+
2015-11-17 23:38:25 +01:00
| ``pageno`` | Search page number | optional (default: ``1``) |
+------------------+----------------------------------------------------------------------------------------------------+-----------------------------+
2016-09-06 18:14:11 +02:00
| ``time_range`` | Time range of search | optional |
+------------------+----------------------------------------------------------------------------------------------------+-----------------------------+