searx/_sources/admin/api.rst.txt

.. _adminapi:

Administration API
------------------

Get configuration data
~~~~~~~~~~~~~~~~~~~~~~

.. code:: sh

    GET /config

Sample response
```````````````

.. code:: sh
    
    {
      "autocomplete": "", 
      "categories": [
        "map", 
        "it", 
        "images", 
      ], 
      "default_locale": "", 
      "default_theme": "oscar", 
      "engines": [
        {
          "categories": [
            "map"
          ], 
          "enabled": true, 
          "name": "openstreetmap", 
          "shortcut": "osm"
        }, 
        {
          "categories": [
            "it"
          ], 
          "enabled": true, 
          "name": "arch linux wiki", 
          "shortcut": "al"
        }, 
        {
          "categories": [
            "images"
          ], 
          "enabled": true, 
          "name": "google images", 
          "shortcut": "goi"
        }, 
        {
          "categories": [
            "it"
          ], 
          "enabled": false, 
          "name": "bitbucket", 
          "shortcut": "bb"
        }, 
      ], 
      "instance_name": "searx", 
      "locales": {
        "de": "Deutsch (German)", 
        "en": "English", 
        "eo": "Esperanto (Esperanto)", 
      }, 
      "plugins": [
        {
          "enabled": true, 
          "name": "HTTPS rewrite"
        }, 
        {
          "enabled": false, 
          "name": "Vim-like hotkeys"
        }
      ], 
      "safe_search": 0
    }

Embed search bar
----------------

The search bar can be embedded into websites. Just paste the example into the HTML of the site.
URL of the searx instance and values are customizable.

.. code:: html
    
    <form method="post" action="https://searx.me/">
        <!-- search query --> <input type="text" name="q" />
        <!-- categories   --> <input type="hidden" name="categories" value="general,social media" />
        <!-- language     --> <input type="hidden" name="lang" value="all" />
        <!-- locale       --> <input type="hidden" name="locale" value="en" />
        <!-- date filter  --> <input type="hidden" name="time_range" value="month" />
    </form>