GetTimeSeriesRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/hyperaware-live/json-schema/hyperaware-live-get-time-series-request-schema.json",
  "title": "GetTimeSeriesRequest",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/hyperaware-live-openapi.json#/components/schemas/GetTimeSeriesRequest",
  "properties": {
    "country": {
      "description": "ISO 3166-1 alpha-2 country code (US, GB, JP). Boards, TikTok and review stores default to US; Google time series and growth default to worldwide. Only for: Google Search, Google Images, Google News, Google Shopping, YouTube, TikTok, Pinterest.",
      "type": "string"
    },
    "keyword": {
      "description": "What to look up. The string format is required by source. Google Search, Google Images, Google News, Google Shopping, YouTube, Wikipedia, TikTok, Amazon, Pinterest: any name or phrase, e.g. 'nike'. npm: Exact npmjs.com package name, case-sensitive. Right: 'react', '@babel/core'. Wrong: 'React', 'React.js'. Python: Exact PyPI project name. Right: 'pandas', 'requests'. Wrong: 'Pandas'. Steam: Game display name in plain English, not a Steam App ID. Right: 'Elden Ring', 'CS2'. First Steam store search result wins, so use an unambiguous name. App Downloads: Android bundle ID only (the id= value on Google Play). Right: 'com.openai.chatgpt', 'com.whatsapp'. Wrong: 'ChatGPT', 'WhatsApp', an iOS App Store ID, or a bundle ID that is not Android. Find it at play.google.com/store/apps/details?id=THIS_PART. App Rankings: Android bundle ID only (the id= value on Google Play). Right: 'com.openai.chatgpt', 'com.whatsapp'. Wrong: 'ChatGPT', 'WhatsApp', an iOS App Store ID, or a bundle ID that is not Android. Find it at play.google.com/store/apps/details?id=THIS_PART.",
      "type": "string"
    },
    "language": {
      "default": "en",
      "description": "Wikipedia language edition (en, de, ja, pt); defaults to en. Only for: Wikipedia.",
      "type": "string"
    },
    "mode": {
      "const": "get_time_series",
      "description": "Canonical name (matches the MCP tool). Aliases: 'get_trends', 'trends', 'time_series', 'lookup'.",
      "type": "string"
    },
    "resolution": {
      "default": "weekly",
      "description": "'weekly' (about 5 years, default) or 'daily' (last 90 days, fetched live). Only for: Google Search, Google Images, Google News, Google Shopping, YouTube.",
      "enum": [
        "weekly",
        "daily"
      ],
      "type": "string"
    },
    "source": {
      "description": "Exactly one source per request.",
      "enum": [
        "Google Search",
        "Google Images",
        "Google News",
        "Google Shopping",
        "YouTube",
        "Wikipedia",
        "TikTok",
        "Amazon",
        "Pinterest",
        "npm",
        "Python",
        "Steam",
        "App Downloads",
        "App Rankings"
      ],
      "type": "string"
    }
  },
  "required": [
    "mode",
    "source",
    "keyword"
  ],
  "type": "object"
}