{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/linkbreakers-com/json-schema/linkbreakers-com-get-geo-breakdown-request-schema.json",
  "title": "GetGeoBreakdownRequest retrieves geographic distribution of events",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/linkbreakers-com-analytics-data-api-openapi.yml#/components/schemas/GetGeoBreakdownRequest",
  "properties": {
    "countries": {
      "items": {
        "type": "string"
      },
      "title": "Optional country filter: visits from any of these countries (ISO 3166-1\nalpha-2 codes, e.g. \"FR\"). Combines with the link, directory or tag filter",
      "type": "array"
    },
    "directoryId": {
      "title": "Optional directory filter (UUID): the links of this directory and of every\ndirectory below it. Send link_id or directory_id, not both; when both are\nomitted aggregates workspace-wide",
      "type": "string"
    },
    "endDate": {
      "format": "date-time",
      "title": "Inclusive end timestamp",
      "type": "string"
    },
    "groupBy": {
      "title": "Group by \"country\" or \"city\"",
      "type": "string"
    },
    "limit": {
      "format": "int32",
      "title": "Maximum number of results (default 10)",
      "type": "integer"
    },
    "linkId": {
      "title": "Optional link filter (UUID); when omitted aggregates workspace-wide",
      "type": "string"
    },
    "startDate": {
      "format": "date-time",
      "title": "Inclusive start timestamp",
      "type": "string"
    },
    "tagId": {
      "title": "Optional tag filter (UUID): every link carrying this tag. Send at most one\nof link_id, directory_id and tag_id",
      "type": "string"
    }
  },
  "type": "object"
}