get_geographic_breakdown

Analyze viewer locations to understand global reach, regional performance, and market penetration. Returns data on views/viewers by country, region, or city for strategy planning, CDN optimization, and compliance checks.

Instructions

Analyze viewer LOCATIONS and regional performance. USE WHEN: Understanding global reach, planning regional strategies, checking market penetration, optimizing CDN, compliance checks. RETURNS: Views/viewers by country/region/city with percentages. EXAMPLES: 'Which countries watch our content?', 'Show US state breakdown', 'Find top 10 cities for viewership'. Includes map-ready data.

Input Schema

Name	Required	Description
`from_date`	Yes	Start date in YYYY-MM-DD format (e.g., '2024-01-01')
`granularity`	No	Location detail level (default: 'country'): 'world' = continents, 'country' = nations, 'region' = states/provinces, 'city' = cities. Higher detail requires region_filter.
`metrics`	No	Metrics to include
`region_filter`	No	Zoom into specific area: For region view use country code (e.g., 'US' for US states), for city view use 'US-CA' for California cities. Required for region/city granularity.
`to_date`	Yes	End date in YYYY-MM-DD format (e.g., '2024-01-31')

Input Schema (JSON Schema)

{
  "properties": {
    "from_date": {
      "description": "Start date in YYYY-MM-DD format (e.g., '2024-01-01')",
      "type": "string"
    },
    "granularity": {
      "description": "Location detail level (default: 'country'): 'world' = continents, 'country' = nations, 'region' = states/provinces, 'city' = cities. Higher detail requires region_filter.",
      "enum": [
        "world",
        "country",
        "region",
        "city"
      ],
      "type": "string"
    },
    "metrics": {
      "description": "Metrics to include",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "region_filter": {
      "description": "Zoom into specific area: For region view use country code (e.g., 'US' for US states), for city view use 'US-CA' for California cities. Required for region/city granularity.",
      "type": "string"
    },
    "to_date": {
      "description": "End date in YYYY-MM-DD format (e.g., '2024-01-31')",
      "type": "string"
    }
  },
  "required": [
    "from_date",
    "to_date"
  ],
  "type": "object"
}

Kaltura MCP Server