{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/compsniper-com/json-schema/compsniper-com-bulk-search-request-schema.json",
  "title": "BulkSearchRequest",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/compsniper-com-bulk-search-api-openapi.yml#/components/schemas/BulkSearchRequest",
  "type": "object",
  "required": [
    "keywords"
  ],
  "properties": {
    "keywords": {
      "type": "array",
      "minItems": 1,
      "maxItems": 20,
      "description": "Case-insensitively deduplicated product keywords. Each keyword may contain at most 300 characters.",
      "items": {
        "type": "string",
        "maxLength": 300
      }
    },
    "options": {
      "$ref": "#/$defs/BulkSearchOptions"
    }
  },
  "$defs": {
    "BulkSearchOptions": {
      "type": "object",
      "description": "Shared page-one options applied independently to every keyword.",
      "properties": {
        "count": {
          "type": "integer",
          "minimum": 1,
          "maximum": 240,
          "default": 240
        },
        "ebaySite": {
          "type": "string",
          "enum": [
            "ebay.com",
            "ebay.co.uk",
            "ebay.de",
            "ebay.fr",
            "ebay.it",
            "ebay.es",
            "ebay.ca",
            "ebay.com.au"
          ]
        },
        "categoryId": {
          "type": "string"
        },
        "sortOrder": {
          "type": "string",
          "enum": [
            "endedRecently",
            "timeNewlyListed",
            "pricePlusPostageLowest",
            "pricePlusPostageHighest",
            "distanceNearest"
          ]
        },
        "minPrice": {
          "type": "number"
        },
        "maxPrice": {
          "type": "number"
        },
        "itemLocation": {
          "type": "string",
          "enum": [
            "default",
            "domestic",
            "worldwide"
          ]
        },
        "itemCondition": {
          "type": "string",
          "enum": [
            "any",
            "new",
            "used"
          ]
        },
        "conditionId": {
          "type": "integer",
          "minimum": 0
        },
        "buyingFormat": {
          "type": "string",
          "enum": [
            "all",
            "auction",
            "buyItNow",
            "acceptsOffers"
          ]
        },
        "sellerType": {
          "type": "string",
          "enum": [
            "private",
            "business"
          ]
        },
        "includeCompleteListing": {
          "type": "boolean"
        },
        "sold": {
          "type": "boolean",
          "default": true
        },
        "soldAfter": {
          "type": "string",
          "format": "date"
        },
        "soldBefore": {
          "type": "string",
          "format": "date"
        },
        "exactMatch": {
          "type": "boolean",
          "default": false
        },
        "aspectFilter": {
          "type": "object",
          "additionalProperties": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            ]
          }
        },
        "relevance": {
          "type": "boolean",
          "default": true
        }
      },
      "additionalProperties": false
    }
  }
}