2015-11-17 22:13:30 +00:00
|
|
|
Search API
|
|
|
|
==========
|
|
|
|
|
2016-09-06 16:13:20 +00:00
|
|
|
The search supports both ``GET`` and ``POST``.
|
2015-11-17 22:13:30 +00:00
|
|
|
|
2016-07-09 20:31:21 +00:00
|
|
|
Furthermore, two enpoints ``/`` and ``/search`` are available for querying.
|
|
|
|
|
|
|
|
.. code:: sh
|
|
|
|
|
|
|
|
GET /
|
|
|
|
|
|
|
|
.. code:: sh
|
|
|
|
|
|
|
|
GET /search
|
2015-11-17 22:13:30 +00:00
|
|
|
|
|
|
|
Parameters
|
2016-07-09 20:31:21 +00:00
|
|
|
``````````
|
2015-11-17 22:13:30 +00:00
|
|
|
|
2016-09-10 13:12:11 +00: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 |
|
|
|
|
+------------------+----------------------------------------------------------------------------------------------------+--------------------------------------------------+
|
|
|
|
| ``lang`` | Code of the language | optional (default: ``all``) |
|
|
|
|
+------------------+----------------------------------------------------------------------------------------------------+--------------------------------------------------+
|
|
|
|
| ``pageno`` | Search page number | optional (default: ``1``) |
|
|
|
|
+------------------+----------------------------------------------------------------------------------------------------+--------------------------------------------------+
|
|
|
|
| ``time_range`` | Time range of search | optional (possible: ``day``, ``month``, ``year``)|
|
|
|
|
+------------------+----------------------------------------------------------------------------------------------------+--------------------------------------------------+
|
2017-07-09 20:02:29 +00:00
|
|
|
| ``format`` | Output format of results | optional (possible: ``json``, ``csv``, ``rss``) |
|
|
|
|
+------------------+----------------------------------------------------------------------------------------------------+--------------------------------------------------+
|