Skip to content
Language — current: English
Theme — current: Match system
Tool
{
  "name": "searchapi_google_trends",
  "description": "Google Trends results from SearchApi, as structured JSON.",
  "input_schema": {
    "type": "object",
    "properties": {
      "q": {
        "type": "string",
        "description": "Query or up to 5 comma-separated queries to compare."
      },
      "data_type": {
        "type": "string",
        "description": "Kind of trends data: interest over time, interest by region, related topics/queries.",
        "enum": [
          "TIMESERIES",
          "GEO_MAP",
          "GEO_MAP_0",
          "RELATED_TOPICS",
          "RELATED_QUERIES"
        ],
        "default": "TIMESERIES"
      },
      "time": {
        "type": "string",
        "description": "Time range, e.g. now 1-H, now 7-d, today 12-m, all, or custom '2024-01-01 2024-12-31'.",
        "default": "today 12-m"
      },
      "geo": {
        "type": "string",
        "description": "Location of interest, e.g. US or US-NY; worldwide when empty."
      },
      "region": {
        "type": "string",
        "description": "Resolution of GEO_MAP data.",
        "enum": [
          "COUNTRY",
          "REGION",
          "DMA",
          "CITY"
        ]
      },
      "cat": {
        "type": "string",
        "description": "Category filter; values listed at docs/parameters/google-trends/categories."
      },
      "gprop": {
        "type": "string",
        "description": "Google property to filter by (web search when empty).",
        "enum": [
          "images",
          "news",
          "froogle",
          "youtube"
        ]
      },
      "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"
      }
    },
    "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_.