{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/ecommercedataapi-com/json-schema/ecommercedataapi-com-amazon-keywords-research-request-schema.json",
  "title": "AmazonKeywordsResearchRequest",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/ecommercedataapi-com-openapi.json#/components/schemas/AmazonKeywordsResearchRequest",
  "type": "object",
  "properties": {
    "departments": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Departments."
      },
      "description": "Departments."
    },
    "excludeKeywords": {
      "type": "string",
      "description": "Exclude keywords."
    },
    "keywords": {
      "type": "string",
      "description": "Keywords used by the query."
    },
    "marketPeriod": {
      "type": "string",
      "description": "Market period. Available values (Table 1.7): N, S1, S2, S3, S4, S5, S6, S7, S8, S9, S10, S11, S12, I, D"
    },
    "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."
    },
    "maxAraClickRate": {
      "type": "number",
      "format": "float",
      "description": "Max ara click rate. Maximum value."
    },
    "maxAvgPrice": {
      "type": "number",
      "format": "float",
      "description": "Max avg price. Maximum value."
    },
    "maxBid": {
      "type": "number",
      "format": "float",
      "description": "Max bid. Maximum value."
    },
    "maxGoodsValue": {
      "type": "number",
      "format": "float",
      "description": "Max goods value. 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."
    },
    "maxRating": {
      "type": "number",
      "format": "float",
      "description": "Max rating. Maximum value."
    },
    "maxRatings": {
      "type": "integer",
      "format": "int32",
      "description": "Max ratings. Maximum value."
    },
    "maxSearchMonthCr": {
      "type": "number",
      "format": "float",
      "description": "Max search month change rate. Maximum value. Percentage or ratio value as documented."
    },
    "maxSearchMonthCv": {
      "type": "integer",
      "format": "int32",
      "description": "Max search month change value. Maximum value."
    },
    "maxSearchNearlyCr": {
      "type": "number",
      "format": "float",
      "description": "Max search nearly change rate. Maximum value. Percentage or ratio value as documented."
    },
    "maxSearchNearlyCv": {
      "type": "integer",
      "format": "int32",
      "description": "Max search nearly change value. Maximum value."
    },
    "maxSearches": {
      "type": "integer",
      "format": "int32",
      "description": "Max searches. Maximum value."
    },
    "maxSearchesCr": {
      "type": "number",
      "format": "float",
      "description": "Max searches change rate. Maximum value. Percentage or ratio value as documented."
    },
    "maxSupplyDemandRatio": {
      "type": "number",
      "format": "float",
      "description": "Max supply demand ratio. Maximum value."
    },
    "maxWordCount": {
      "type": "integer",
      "format": "int32",
      "description": "Max word count. Maximum value."
    },
    "minAraClickRate": {
      "type": "number",
      "format": "float",
      "description": "Min ara click rate. Minimum value."
    },
    "minAvgPrice": {
      "type": "number",
      "format": "float",
      "description": "Min avg price. Minimum value."
    },
    "minBid": {
      "type": "number",
      "format": "float",
      "description": "Min bid. Minimum value."
    },
    "minGoodsValue": {
      "type": "number",
      "format": "float",
      "description": "Min goods value. 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."
    },
    "minRating": {
      "type": "number",
      "format": "float",
      "description": "Min rating. Minimum value."
    },
    "minRatings": {
      "type": "integer",
      "format": "int32",
      "description": "Min ratings. Minimum value."
    },
    "minSearchMonthCr": {
      "type": "number",
      "format": "float",
      "description": "Min search month change rate. Minimum value. Percentage or ratio value as documented."
    },
    "minSearchMonthCv": {
      "type": "integer",
      "format": "int32",
      "description": "Min search month change value. Minimum value."
    },
    "minSearchNearlyCr": {
      "type": "number",
      "format": "float",
      "description": "Min search nearly change rate. Minimum value. Percentage or ratio value as documented."
    },
    "minSearchNearlyCv": {
      "type": "integer",
      "format": "int32",
      "description": "Min search nearly change value. Minimum value."
    },
    "minSearches": {
      "type": "integer",
      "format": "int32",
      "description": "Min searches. Minimum value."
    },
    "minSearchesCr": {
      "type": "number",
      "format": "float",
      "description": "Min searches change rate. Minimum value. Percentage or ratio value as documented."
    },
    "minSupplyDemandRatio": {
      "type": "number",
      "format": "float",
      "description": "Min supply demand ratio. Minimum value."
    },
    "minWordCount": {
      "type": "integer",
      "format": "int32",
      "description": "Min word count. Minimum value."
    },
    "month": {
      "type": "string",
      "description": "Data month. Use the format documented for this endpoint, usually yyyyMM. Available values (Table 1.1): nearly, yyyyMM"
    },
    "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 1.8): searches, keywordsIsHide, searches_growth, yearly_growth_rate, growth_rate_trend_min, monopoly_click_rate, goods_value"
        }
      },
      "additionalProperties": false,
      "description": "Sort definition."
    },
    "page": {
      "type": "integer",
      "format": "int32",
      "minimum": 1,
      "description": "Page number starting at 1."
    },
    "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."
    },
    "withYearlyGrowth": {
      "type": "boolean",
      "description": "With yearly growth."
    }
  },
  "required": [
    "marketplace"
  ],
  "additionalProperties": false
}