{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/agentseo-dev/json-schema/agentseo-dev-keyword-metrics-params-schema.json",
  "title": "KeywordMetricsParams",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/agentseo-dev-keyword-metrics-api-openapi.yml#/components/schemas/KeywordMetricsParams",
  "type": "object",
  "required": [
    "keywords"
  ],
  "properties": {
    "keywords": {
      "type": "array",
      "minItems": 1,
      "maxItems": 100,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      }
    },
    "location": {
      "type": "string",
      "default": "United States",
      "description": "Human-friendly search market. If provided with location_code, location_code wins."
    },
    "location_code": {
      "type": "integer",
      "minimum": 1,
      "description": "Optional provider location code for deterministic geo-targeting."
    },
    "language": {
      "type": "string",
      "default": "en"
    },
    "min_search_volume": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "default": 0
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "priority",
        "search_volume",
        "cpc",
        "difficulty"
      ],
      "default": "priority"
    }
  }
}