searxng/docs/admin/api.rst
2016-09-06 18:16:29 +02:00

2.1 KiB

Administration API

Get configuration data

GET /config

Sample response

{
  "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.

<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>