google-trends.use.x402atlas.com

{
  "properties": {
    "data_source": {
      "description": "primary honors geo and timeframe; fallback can only serve the worldwide 2004_present monthly series — 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"
    },
    "interest_by_region_url": {
      "description": "Ready-to-call /interest-by-region URL for the same keyword",
      "format": "uri",
      "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"
    },
    "related_queries_url": {
      "description": "Ready-to-call /related-queries URL for the same keyword",
      "format": "uri",
      "type": "string"
    },
    "related_topics_url": {
      "description": "Ready-to-call /related-topics URL for the same keyword",
      "format": "uri",
      "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 — 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"
    },
    "trend_url": {
      "description": "Ready-to-call /trend URL for the same keyword",
      "format": "uri",
      "type": "string"
    }
  },
  "required": [
    "keyword",
    "geo",
    "timeframe",
    "granularity",
    "data_source",
    "queried_at",
    "series"
  ],
  "type": "object"
}