summaryrefslogtreecommitdiff
path: root/docs/dev/search_api.rst
diff options
context:
space:
mode:
authorAdam Tauber <asciimoo@gmail.com>2015-11-17 23:13:30 +0100
committerAdam Tauber <asciimoo@gmail.com>2015-11-17 23:38:22 +0100
commit1d6597b40773b688ca317e1ab1ffe133b370afb1 (patch)
tree433c03ffffd6dc53a70d059028b449a2be0fecd6 /docs/dev/search_api.rst
downloadsearxng-1d6597b40773b688ca317e1ab1ffe133b370afb1.tar.gz
searxng-1d6597b40773b688ca317e1ab1ffe133b370afb1.zip
[enh] initial structure
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.