{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/ecommercedataapi-com/json-schema/ecommercedataapi-com-amazon-keywords-expand-request-schema.json",
  "title": "AmazonKeywordsExpandRequest",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/ecommercedataapi-com-openapi.json#/components/schemas/AmazonKeywordsExpandRequest",
  "type": "object",
  "properties": {
    "amazonChoice": {
      "type": "boolean",
      "description": "Amazon choice."
    },
    "asinList": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Z0-9]{10}$",
        "description": "List of 1 to 20 ASINs per request."
      },
      "maxItems": 20,
      "minItems": 1,
      "description": "List of 1 to 20 ASINs per request."
    },
    "excludeKeywords": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Exclude keywords."
      },
      "description": "Exclude keywords."
    },
    "historyDate": {
      "type": "string",
      "description": "History date. Date or timestamp value."
    },
    "includeKeywords": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Include keywords."
      },
      "description": "Include keywords."
    },
    "marketplace": {
      "type": "string",
      "enum": [
        "US",
        "UK",
        "DE",
        "FR",
        "IT",
        "ES",
        "MX",
        "CA",
        "AU",
        "JP",
        "IN",
        "AE",
        "BR"
      ],
      "description": "Amazon marketplace code. Supported values are listed in the schema."
    },
    "maxAdProducts": {
      "type": "integer",
      "format": "int32",
      "description": "Max ad products. Maximum value."
    },
    "maxAvgPrice": {
      "type": "number",
      "format": "float",
      "description": "Max avg price. Maximum value."
    },
    "maxBid": {
      "type": "number",
      "format": "float",
      "description": "Max bid. Maximum value."
    },
    "maxCompetitors": {
      "type": "integer",
      "format": "int32",
      "description": "Max competitors. Maximum value."
    },
    "maxConversionRate": {
      "type": "number",
      "format": "float",
      "description": "Max conversion rate. Maximum value. Percentage or ratio value as documented."
    },
    "maxMonopolyClickRate": {
      "type": "number",
      "format": "float",
      "description": "Max monopoly click rate. Maximum value."
    },
    "maxProducts": {
      "type": "integer",
      "format": "int32",
      "description": "Max products. Maximum value."
    },
    "maxPurchaseRate": {
      "type": "number",
      "format": "float",
      "description": "Max purchase rate. Maximum value. Percentage or ratio value as documented."
    },
    "maxPurchases": {
      "type": "integer",
      "format": "int32",
      "description": "Max purchases. Maximum value."
    },
    "maxSPR": {
      "type": "integer",
      "format": "int32",
      "description": "Max SPR. Maximum value."
    },
    "maxSearchRank": {
      "type": "integer",
      "format": "int32",
      "description": "Max search rank. Maximum value."
    },
    "maxSearches": {
      "type": "integer",
      "format": "int32",
      "description": "Max searches. Maximum value."
    },
    "maxSupplyDemandRatio": {
      "type": "number",
      "format": "float",
      "description": "Max supply demand ratio. Maximum value."
    },
    "maxTitleDensity": {
      "type": "integer",
      "format": "int32",
      "description": "Max title density. Maximum value."
    },
    "maxTrafficPercentage": {
      "type": "number",
      "format": "float",
      "description": "Max traffic percentage. Maximum value. Percentage or ratio value as documented."
    },
    "maxWordCount": {
      "type": "integer",
      "format": "int32",
      "description": "Max word count. Maximum value."
    },
    "minAdProducts": {
      "type": "integer",
      "format": "int32",
      "description": "Min ad products. Minimum value."
    },
    "minAvgPrice": {
      "type": "number",
      "format": "float",
      "description": "Min avg price. Minimum value."
    },
    "minBid": {
      "type": "number",
      "format": "float",
      "description": "Min bid. Minimum value."
    },
    "minCompetitors": {
      "type": "integer",
      "format": "int32",
      "description": "Min competitors. Minimum value."
    },
    "minConversionRate": {
      "type": "number",
      "format": "float",
      "description": "Min conversion rate. Minimum value. Percentage or ratio value as documented."
    },
    "minMonopolyClickRate": {
      "type": "number",
      "format": "float",
      "description": "Min monopoly click rate. Minimum value."
    },
    "minProducts": {
      "type": "integer",
      "format": "int32",
      "description": "Min products. Minimum value."
    },
    "minPurchaseRate": {
      "type": "number",
      "format": "float",
      "description": "Min purchase rate. Minimum value. Percentage or ratio value as documented."
    },
    "minPurchases": {
      "type": "integer",
      "format": "int32",
      "description": "Min purchases. Minimum value."
    },
    "minSPR": {
      "type": "integer",
      "format": "int32",
      "description": "Min SPR. Minimum value."
    },
    "minSearchRank": {
      "type": "integer",
      "format": "int32",
      "description": "Min search rank. Minimum value."
    },
    "minSearches": {
      "type": "integer",
      "format": "int32",
      "description": "Min searches. Minimum value."
    },
    "minSupplyDemandRatio": {
      "type": "number",
      "format": "float",
      "description": "Min supply demand ratio. Minimum value."
    },
    "minTitleDensity": {
      "type": "integer",
      "format": "int32",
      "description": "Min title density. Minimum value."
    },
    "minTrafficPercentage": {
      "type": "number",
      "format": "float",
      "description": "Min traffic percentage. Minimum value. Percentage or ratio value as documented."
    },
    "minWordCount": {
      "type": "integer",
      "format": "int32",
      "description": "Min word count. Minimum value."
    },
    "order": {
      "type": "object",
      "properties": {
        "desc": {
          "type": "boolean",
          "description": "Use true for descending order or false for ascending order."
        },
        "field": {
          "type": "string",
          "description": "Field used to sort the results. Available values (Table 2.5): trafficPercentage, relationAsin, searchesRank, searches, purchases, purchaseRate, spr, titleDensity, products, supplyDemandRatio, adProduct, monopolyClickRate, bid"
        }
      },
      "additionalProperties": false,
      "description": "Sort definition."
    },
    "page": {
      "type": "integer",
      "format": "int32",
      "minimum": 1,
      "description": "Page number starting at 1."
    },
    "queryType": {
      "type": "integer",
      "format": "int32",
      "description": "Query type. See the documented default in the example column."
    },
    "returnFields": {
      "type": "string",
      "description": "Optional comma-separated response fields. Omit it to receive the standard payload."
    },
    "size": {
      "type": "integer",
      "format": "int32",
      "minimum": 1,
      "description": "Number of results per page."
    }
  },
  "required": [
    "asinList",
    "marketplace",
    "queryType"
  ],
  "additionalProperties": false
}