Google Trends interest over time for a keyword — search interest as a dated 0-10

Google Trends interest over time for a keyword — search interest as a dated 0-100 series with country targeting (geo) and timeframe windows from the past hour back to 2004: daily points for 30/90-day windows, weekly for 12 months/5 years. For keyword trend analysis, search demand seasonality and SEO keyword research.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

GET https://google-trends.use.x402atlas.com/trend-over-time

Our checks, last 30 days

Example input (from the provider)

{
  "method": "GET",
  "queryParams": {
    "geo": "US",
    "keyword": "bitcoin",
    "timeframe": "past_12_months"
  },
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "geo": {
              "default": "worldwide",
              "description": "ISO-3166 alpha-2 country code, e.g. US, GB, DE, JP (213 countries supported); case-insensitive; also accepted as country; omit for worldwide",
              "maxLength": 8,
              "type": "string"
            },
            "keyword": {
              "description": "Concise Google Trends seed term with meaningful search interest; not a question, instruction, or web-search request",
              "maxLength": 100,
              "type": "string"
            },
            "timeframe": {
              "default": "past_12_months",
              "description": "Time window. Bucket size follows the window and is reported in granularity: past_30_days/past_90_days daily, past_12_months/past_5_years weekly, 2004_present monthly, shorter windows hourly or finer",
              "enum": [
                "2004_present",
                "past_12_months",
                "past_30_days",
                "past_4_hours",
                "past_5_years",
                "past_7_days",
                "past_90_days",
                "past_day",
                "past_hour"
              ],
              "type": "string"
            }
          },
          "required": [
            "keyword"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "data_source": {
              "description": "primary honors geo and timeframe; fallback can only serve the worldwide 2004_present monthly series \u2014 compare geo/timeframe with what you asked for",
              "enum": [
                "primary",
                "fallback"
              ],
              "type": "string"
            },
            "geo": {
              "description": "Location actually served: upper-cased country code, or worldwide",
              "type": "string"
            },
            "granularity": {
              "description": "Bucket size of the series; empty when the series has fewer than two points",
              "enum": [
                "minute",
                "hour",
                "day",
                "week",
                "month",
                ""
              ],
              "type": "string"
            },
            "keyword": {
              "description": "Echoed search keyword",
              "type": "string"
            },
            "notice": {
              "description": "Present only on a degraded fallback response; explains what was served instead",
              "type": "string"
            },
            "queried_at": {
              "description": "UTC timestamp the upstream was queried",
              "format": "date-time",
              "type": "string"
            },
            "series": {
              "description": "Interest-over-time points in ascending time order",
              "items": {
                "properties": {
                  "date": {
                    "description": "UTC calendar date of the bucket (YYYY-MM-DD)",
                    "format": "date",
                    "type": "string"
                  },
                  "timestamp": {
                    "description": "Bucket start as RFC3339 UTC \u2014 use this for sub-day windows",
                    "format": "date-time",
                    "type": "string"
                  },
                  "value": {
                    "description": "Relative search-interest index, 100 = peak within the window",
                    "maximum": 100,
                    "minimum": 0,
                    "type": "integer"
                  }
                },
                "required": [
                  "date",
                  "value"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "timeframe": {
              "description": "Window actually served",
              "enum": [
                "2004_present",
                "past_12_months",
                "past_30_days",
                "past_4_hours",
                "past_5_years",
                "past_7_days",
                "past_90_days",
                "past_day",
                "past_hour"
              ],
              "type": "string"
            }
          },
          "required": [
            "keyword",
            "geo",
            "timeframe",
            "granularity",
            "data_source",
            "queried_at",
            "series"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON