summaryrefslogtreecommitdiff
path: root/docs/dev/search_api.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/dev/search_api.rst')
-rw-r--r--docs/dev/search_api.rst24
1 files changed, 24 insertions, 0 deletions
diff --git a/docs/dev/search_api.rst b/docs/dev/search_api.rst
new file mode 100644
index 000000000..cd86fd71c
--- /dev/null
+++ b/docs/dev/search_api.rst
@@ -0,0 +1,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.