{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/agentseo-dev/json-schema/agentseo-dev-page-intersection-params-schema.json",
  "title": "PageIntersectionParams",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/agentseo-dev-openapi.yaml#/components/schemas/PageIntersectionParams",
  "type": "object",
  "required": [
    "pages"
  ],
  "properties": {
    "pages": {
      "type": "array",
      "minItems": 1,
      "maxItems": 5,
      "items": {
        "type": "string",
        "format": "uri"
      },
      "description": "Absolute page URLs or wildcard URL patterns to compare."
    },
    "exclude_pages": {
      "type": "array",
      "maxItems": 5,
      "items": {
        "type": "string",
        "format": "uri"
      },
      "default": [],
      "description": "Absolute page URLs or wildcard URL patterns to exclude, usually your own page group."
    },
    "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"
    },
    "item_types": {
      "type": "array",
      "minItems": 1,
      "maxItems": 4,
      "items": {
        "type": "string",
        "enum": [
          "organic",
          "paid",
          "featured_snippet",
          "local_pack"
        ]
      },
      "default": [
        "organic",
        "featured_snippet"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 5,
      "maximum": 100,
      "default": 25
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 20000,
      "default": 0
    },
    "include_subdomains": {
      "type": "boolean",
      "default": true
    },
    "intersection_mode": {
      "type": "string",
      "enum": [
        "union",
        "intersect"
      ],
      "default": "union"
    },
    "include_serp_info": {
      "type": "boolean",
      "default": false
    },
    "include_clickstream_data": {
      "type": "boolean",
      "default": false,
      "description": "Doubles credit cost when true."
    },
    "ignore_synonyms": {
      "type": "boolean",
      "default": true
    },
    "min_search_volume": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000000,
      "default": 0
    },
    "max_rank": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 30
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "opportunity",
        "search_volume",
        "traffic_gap",
        "rank",
        "cpc"
      ],
      "default": "opportunity"
    }
  }
}