{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/agentseo-dev/json-schema/agentseo-dev-domain-competitors-params-schema.json",
  "title": "DomainCompetitorsParams",
  "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/DomainCompetitorsParams",
  "type": "object",
  "required": [
    "target"
  ],
  "properties": {
    "target": {
      "type": "string",
      "minLength": 1,
      "description": "Domain or 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": 5,
      "maximum": 250,
      "default": 25
    },
    "min_intersections": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000000,
      "default": 0
    },
    "max_rank_group": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "overlap",
        "competitor_traffic",
        "traffic_gap",
        "threat"
      ],
      "default": "threat"
    }
  }
}