Skip to content
Language — current: English
Theme — current: Match system
Tool
{
  "name": "searchapi_google",
  "description": "Google Search results from SearchApi, as structured JSON.",
  "input_schema": {
    "type": "object",
    "properties": {
      "q": {
        "type": "string",
        "description": "Search query; most engines accept native operators and advanced filters."
      },
      "device": {
        "type": "string",
        "description": "Device to emulate for the search.",
        "enum": [
          "desktop",
          "mobile",
          "tablet"
        ],
        "default": "desktop"
      },
      "google_domain": {
        "type": "string",
        "description": "Google domain to query, e.g. google.com, google.de.",
        "default": "google.com"
      },
      "gl": {
        "type": "string",
        "description": "Country of the search (two-letter country code).",
        "enum": [
          "af",
          "al",
          "dz",
          "as",
          "ad",
          "ao",
          "ai",
          "aq",
          "ag",
          "ar",
          "am",
          "aw",
          "au",
          "at",
          "az",
          "bs",
          "bh",
          "bd",
          "bb",
          "by",
          "be",
          "bz",
          "bj",
          "bm",
          "bt",
          "bo",
          "ba",
          "bw",
          "bv",
          "br",
          "io",
          "bn",
          "bg",
          "bf",
          "bi",
          "kh",
          "cm",
          "ca",
          "cv",
          "ky",
          "cf",
          "td",
          "cl",
          "cn",
          "cx",
          "cc",
          "co",
          "km",
          "cg",
          "cd",
          "ck",
          "cr",
          "ci",
          "hr",
          "cu",
          "cy",
          "cz",
          "dk",
          "dj",
          "dm",
          "do",
          "ec",
          "eg",
          "sv",
          "gq",
          "er",
          "ee",
          "et",
          "fk",
          "fo",
          "fj",
          "fi",
          "fr",
          "gf",
          "pf",
          "tf",
          "ga",
          "gm",
          "ge",
          "de",
          "gh",
          "gi",
          "gr",
          "gl",
          "gd",
          "gp",
          "gu",
          "gt",
          "gn",
          "gw",
          "gy",
          "ht",
          "hm",
          "va",
          "hn",
          "hk",
          "hu",
          "is",
          "in",
          "id",
          "ir",
          "iq",
          "ie",
          "il",
          "it",
          "jm",
          "jp",
          "jo",
          "kz",
          "ke",
          "ki",
          "kp",
          "kr",
          "kw",
          "kg",
          "la",
          "lv",
          "lb",
          "ls",
          "lr",
          "ly",
          "li",
          "lt",
          "lu",
          "mo",
          "mk",
          "mg",
          "mw",
          "my",
          "mv",
          "ml",
          "mt",
          "mh",
          "mq",
          "mr",
          "mu",
          "yt",
          "mx",
          "fm",
          "md",
          "mc",
          "mn",
          "ms",
          "ma",
          "mz",
          "mm",
          "na",
          "nr",
          "np",
          "nl",
          "an",
          "nc",
          "nz",
          "ni",
          "ne",
          "ng",
          "nu",
          "nf",
          "mp",
          "no",
          "om",
          "pk",
          "pw",
          "ps",
          "pa",
          "pg",
          "py",
          "pe",
          "ph",
          "pn",
          "pl",
          "pt",
          "pr",
          "qa",
          "re",
          "ro",
          "ru",
          "rw",
          "sh",
          "kn",
          "lc",
          "pm",
          "vc",
          "ws",
          "sm",
          "st",
          "sa",
          "sn",
          "rs",
          "sc",
          "sl",
          "sg",
          "sk",
          "si",
          "sb",
          "so",
          "za",
          "gs",
          "es",
          "lk",
          "sd",
          "sr",
          "sj",
          "sz",
          "se",
          "ch",
          "sy",
          "tw",
          "tj",
          "tz",
          "th",
          "tg",
          "tk",
          "to",
          "tt",
          "tn",
          "tr",
          "tm",
          "tc",
          "tv",
          "ug",
          "ua",
          "ae",
          "uk",
          "gb",
          "us",
          "um",
          "uy",
          "uz",
          "vu",
          "ve",
          "vn",
          "vg",
          "vi",
          "wf",
          "eh",
          "ye",
          "zm",
          "zw"
        ],
        "default": "us"
      },
      "hl": {
        "type": "string",
        "description": "Interface language of the search (two-letter language code).",
        "enum": [
          "af",
          "ak",
          "sq",
          "am",
          "ar",
          "hy",
          "az",
          "eu",
          "be",
          "bem",
          "bn",
          "bh",
          "bs",
          "br",
          "bg",
          "km",
          "ca",
          "chr",
          "ny",
          "zh-CN",
          "zh-TW",
          "co",
          "hr",
          "cs",
          "da",
          "nl",
          "en",
          "eo",
          "et",
          "ee",
          "fo",
          "tl",
          "fi",
          "fr",
          "fy",
          "gaa",
          "gl",
          "ka",
          "de",
          "el",
          "gn",
          "gu",
          "ht",
          "ha",
          "haw",
          "iw",
          "hi",
          "hu",
          "is",
          "ig",
          "id",
          "ia",
          "ga",
          "it",
          "ja",
          "jw",
          "kn",
          "kk",
          "rw",
          "rn",
          "kg",
          "ko",
          "kri",
          "ku",
          "ckb",
          "ky",
          "lo",
          "la",
          "lv",
          "ln",
          "lt",
          "loz",
          "lg",
          "ach",
          "mk",
          "mg",
          "ms",
          "ml",
          "mt",
          "mi",
          "mr",
          "mfe",
          "mo",
          "mn",
          "sr-ME",
          "my",
          "ne",
          "pcm",
          "nso",
          "no",
          "nn",
          "oc",
          "or",
          "om",
          "ps",
          "fa",
          "pl",
          "pt",
          "pt-BR",
          "pt-PT",
          "pa",
          "qu",
          "ro",
          "rm",
          "nyn",
          "ru",
          "gd",
          "sr",
          "sh",
          "st",
          "tn",
          "crs",
          "sn",
          "sd",
          "si",
          "sk",
          "sl",
          "so",
          "es",
          "es-419",
          "su",
          "sw",
          "sv",
          "tg",
          "ta",
          "tt",
          "te",
          "th",
          "ti",
          "to",
          "lua",
          "tum",
          "tr",
          "tk",
          "tw",
          "ug",
          "uk",
          "ur",
          "uz",
          "vi",
          "cy",
          "wo",
          "xh",
          "yi",
          "yo",
          "zu"
        ],
        "default": "en"
      },
      "location": {
        "type": "string",
        "description": "Geographic origin of the search; canonical names come from the Locations API."
      },
      "uule": {
        "type": "string",
        "description": "Encoded location cookie; alternative to `location` (do not use both)."
      },
      "cr": {
        "type": "string",
        "description": "Restricts results to documents from listed countries, e.g. countryUS."
      },
      "lr": {
        "type": "string",
        "description": "Restricts results to documents in a language, e.g. lang_en."
      },
      "safe": {
        "type": "string",
        "description": "Adult content filtering level.",
        "enum": [
          "active",
          "off"
        ]
      },
      "filter": {
        "type": "string",
        "description": "Duplicate/omitted results filter (1 = on, 0 = off).",
        "enum": [
          "0",
          "1"
        ],
        "default": "1"
      },
      "nfpr": {
        "type": "string",
        "description": "Exclude auto-corrected query results (1 = no fixed spelling).",
        "enum": [
          "0",
          "1"
        ],
        "default": "0"
      },
      "time_period": {
        "type": "string",
        "description": "Restricts results by recency; custom uses time_period_min/max.",
        "enum": [
          "last_hour",
          "last_day",
          "last_week",
          "last_month",
          "last_year",
          "custom"
        ]
      },
      "time_period_min": {
        "type": "string",
        "description": "Start date for time_period=custom (MM/DD/YYYY)."
      },
      "time_period_max": {
        "type": "string",
        "description": "End date for time_period=custom (MM/DD/YYYY)."
      },
      "page": {
        "type": "integer",
        "description": "Page number of the results.",
        "default": 1
      },
      "num": {
        "type": "integer",
        "description": "Number of results per page."
      }
    },
    "required": [
      "q"
    ],
    "examples": [
      {
        "q": "coffee"
      }
    ]
  }
}

Paste the definition into your own agent's tools array. The schema is generated from this engine's catalog entry, and the reader's configured values ride in the schema's examples. The name is ours rather than the MCP server's — it is what your agent will call — and every engine's is prefixed searchapi_.