summaryrefslogtreecommitdiff
path: root/docs/dev/search_api.rst
blob: cd86fd71cd2137d6f6a1e1dd389274318f2d766c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
Search API
==========

Search API endpoints: ``/``, ``/search``
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Endpoints have equivalent functionality.

Parameters
^^^^^^^^^^

+------------------+----------------------------------------------------------------------------------------------------+-----------------------------+
| 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                    |
+------------------+----------------------------------------------------------------------------------------------------+-----------------------------+
| ``pageno``       | Search page number                                                                                 | optional (default: ``1``)   |
+------------------+----------------------------------------------------------------------------------------------------+-----------------------------+

Both ``GET`` and ``POST`` methods are supported.