serp.trends

Get Google Trends interest: pay per use, no API key

Use SerpApi from Claude, Claude Code, Cursor, ChatGPT, and other agents through one Cralo balance.

Return Google Trends interest over time, interest by region, and related queries through SerpApi.

Price and execution

Price: $0.03
Pricing model: Fixed price per successful call
Execution class: fast

Limits

No additional limits are published for this tool.

Parameters

Fields serp.trends accepts as JSON input.

geostringOptional
A Google Trends location such as `US` or `US-CA`.
datestringOptional
A Google Trends date range such as `today 12-m`, `now 7-d`, or `2024-01-01 2024-12-31`.
querystringRequired
One term, or up to five comma-separated terms.
languagestringOptional
Two-letter language code for Google Trends data.
data_type"TIMESERIES" | "GEO_MAP_0" | "RELATED_QUERIES" | "RELATED_TOPICS"Optional
The Google Trends report to return.

Raw input JSON Schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "geo": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}(-[A-Za-z0-9]{1,3})?quot;,
      "description": "A Google Trends location such as `US` or `US-CA`."
    },
    "date": {
      "type": "string",
      "maxLength": 50,
      "minLength": 3,
      "description": "A Google Trends date range such as `today 12-m`, `now 7-d`, or `2024-01-01 2024-12-31`."
    },
    "query": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "One term, or up to five comma-separated terms."
    },
    "language": {
      "type": "string",
      "default": "en",
      "pattern": "^[A-Za-z]{2}quot;,
      "description": "Two-letter language code for Google Trends data."
    },
    "data_type": {
      "enum": [
        "TIMESERIES",
        "GEO_MAP_0",
        "RELATED_QUERIES",
        "RELATED_TOPICS"
      ],
      "type": "string",
      "default": "TIMESERIES",
      "description": "The Google Trends report to return."
    }
  },
  "additionalProperties": false
}

Returns

Fields a successful serp.trends call returns.

querystringRequired
regionsarray of objectRequired
- valuenumber | nullRequired
- locationstringRequired
relatedarray of objectRequired
- titlestringRequired
- valuenumber | nullRequired
- risingbooleanRequired
timelinearray of objectRequired
- datestringRequired
- valuesarray of objectRequired
data_typestringRequired
search_idstringRequired
retrieved_atstring (date-time)Required

Raw output JSON Schema

{
  "type": "object",
  "required": [
    "query",
    "data_type",
    "timeline",
    "regions",
    "related",
    "search_id",
    "retrieved_at"
  ],
  "properties": {
    "query": {
      "type": "string"
    },
    "regions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "location",
          "value"
        ],
        "properties": {
          "value": {
            "type": [
              "number",
              "null"
            ]
          },
          "location": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50
    },
    "related": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "value",
          "rising"
        ],
        "properties": {
          "title": {
            "type": "string"
          },
          "value": {
            "type": [
              "number",
              "null"
            ]
          },
          "rising": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50
    },
    "timeline": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "date",
          "values"
        ],
        "properties": {
          "date": {
            "type": "string"
          },
          "values": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "query",
                "value"
              ],
              "properties": {
                "query": {
                  "type": "string"
                },
                "value": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "additionalProperties": false
            }
          }
        },
        "additionalProperties": false
      },
      "maxItems": 200
    },
    "data_type": {
      "type": "string"
    },
    "search_id": {
      "type": "string"
    },
    "retrieved_at": {
      "type": "string",
      "format": "date-time"
    }
  },
  "additionalProperties": false
}

Run this tool

Copy this instruction to your agent to set up Cralo and call this tool with the example input.

Set up Cralo by following https://cralo.ai/SKILL.md, then call the serp.trends tool with this input: {"query":"artificial intelligence","data_type":"TIMESERIES","date":"today 12-m","geo":"US"}

Start with $1 free See pricing

Safety notes

Side Effect: read_only
Public Sources Only: Yes

How this compares to using SerpApi directly

You do not need a separate SerpApi account or subscription for this call. Cralo uses one prepaid balance across all tools and shows the per-call price before you run the command.

Related tools

[Browse all tools]