{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/agentseo-dev/json-schema/agentseo-dev-domain-ranked-keywords-params-schema.json",
  "title": "DomainRankedKeywordsParams",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/agentseo-dev-domain-api-openapi.yml#/components/schemas/DomainRankedKeywordsParams",
  "type": "object",
  "required": [
    "target"
  ],
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Domain, subdomain, or page URL to inspect."
    },
    "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"
    },
    "limit": {
      "type": "integer",
      "minimum": 10,
      "maximum": 250,
      "default": 50
    },
    "min_search_volume": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000,
      "default": 0
    },
    "max_rank": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 100
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "opportunity",
        "estimated_traffic",
        "rank",
        "search_volume",
        "cpc"
      ],
      "default": "opportunity"
    },
    "include_lost": {
      "type": "boolean",
      "default": false
    }
  }
}