{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/ecommercedataapi-com/json-schema/ecommercedataapi-com-amazon-markets-research-request-schema.json",
  "title": "AmazonMarketsResearchRequest",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/ecommercedataapi-com-openapi.json#/components/schemas/AmazonMarketsResearchRequest",
  "type": "object",
  "properties": {
    "departmentKeyword": {
      "type": "string",
      "description": "Department keyword."
    },
    "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."
    },
    "maxAmazonSelfProportion": {
      "type": "number",
      "format": "float",
      "description": "Max Amazon self proportion. Maximum value. Percentage or ratio value as documented."
    },
    "maxAvgBsr": {
      "type": "integer",
      "format": "int32",
      "description": "Max avg BSR. Maximum value."
    },
    "maxAvgPrice": {
      "type": "number",
      "format": "float",
      "description": "Max avg price. Maximum value."
    },
    "maxAvgProfit": {
      "type": "number",
      "format": "float",
      "description": "Max avg profit. Maximum value. Percentage or ratio value as documented."
    },
    "maxAvgRating": {
      "type": "number",
      "format": "float",
      "description": "Max avg rating. Maximum value."
    },
    "maxAvgRatings": {
      "type": "integer",
      "format": "int32",
      "description": "Max avg ratings. Maximum value."
    },
    "maxAvgRevenue": {
      "type": "number",
      "format": "float",
      "description": "Max avg revenue. Maximum value."
    },
    "maxAvgSellers": {
      "type": "number",
      "format": "float",
      "description": "Max avg sellers. Maximum value."
    },
    "maxAvgUnits": {
      "type": "integer",
      "format": "int32",
      "description": "Max avg units. Maximum value."
    },
    "maxBrandCrn": {
      "type": "number",
      "format": "float",
      "description": "Max brand crn. Maximum value."
    },
    "maxBrands": {
      "type": "integer",
      "format": "int32",
      "description": "Max brands. Maximum value."
    },
    "maxEbcProportion": {
      "type": "number",
      "format": "float",
      "description": "Max A+ content proportion. Maximum value. Percentage or ratio value as documented."
    },
    "maxFbaProportion": {
      "type": "number",
      "format": "float",
      "description": "Max FBA proportion. Maximum value. Percentage or ratio value as documented."
    },
    "maxFbmProportion": {
      "type": "number",
      "format": "float",
      "description": "Max FBM proportion. Maximum value. Percentage or ratio value as documented."
    },
    "maxGoodsCount": {
      "type": "integer",
      "format": "int32",
      "description": "Max goods count. Maximum value."
    },
    "maxGoodsCrn": {
      "type": "number",
      "format": "float",
      "description": "Max goods crn. Maximum value."
    },
    "maxNewAvgPrice": {
      "type": "number",
      "format": "float",
      "description": "Max new avg price. Maximum value."
    },
    "maxNewAvgRating": {
      "type": "number",
      "format": "float",
      "description": "Max new avg rating. Maximum value."
    },
    "maxNewAvgRatings": {
      "type": "integer",
      "format": "int32",
      "description": "Max new avg ratings. Maximum value."
    },
    "maxNewAvgRevenue": {
      "type": "number",
      "format": "float",
      "description": "Max new avg revenue. Maximum value."
    },
    "maxNewAvgUnits": {
      "type": "number",
      "format": "float",
      "description": "Max new avg units. Maximum value."
    },
    "maxNewCount": {
      "type": "integer",
      "format": "int32",
      "description": "Max new count. Maximum value."
    },
    "maxNewProportion": {
      "type": "number",
      "format": "float",
      "description": "Max new proportion. Maximum value. Percentage or ratio value as documented."
    },
    "maxSellerCrn": {
      "type": "number",
      "format": "float",
      "description": "Max seller crn. Maximum value."
    },
    "maxSellers": {
      "type": "integer",
      "format": "int32",
      "description": "Max sellers. Maximum value."
    },
    "maxTopAvgBsr": {
      "type": "integer",
      "format": "int32",
      "description": "Max top avg BSR. Maximum value."
    },
    "maxTopAvgRevenue": {
      "type": "number",
      "format": "float",
      "description": "Max top avg revenue. Maximum value."
    },
    "maxTopAvgUnits": {
      "type": "integer",
      "format": "int32",
      "description": "Max top avg units. Maximum value."
    },
    "maxVolume": {
      "type": "number",
      "format": "float",
      "description": "Max volume. Maximum value."
    },
    "maxWeight": {
      "type": "number",
      "format": "float",
      "description": "Max weight. Maximum value."
    },
    "minAmazonSelfProportion": {
      "type": "number",
      "format": "float",
      "description": "Min Amazon self proportion. Minimum value. Percentage or ratio value as documented."
    },
    "minAvgBsr": {
      "type": "integer",
      "format": "int32",
      "description": "Min avg BSR. Minimum value."
    },
    "minAvgPrice": {
      "type": "number",
      "format": "float",
      "description": "Min avg price. Minimum value."
    },
    "minAvgProfit": {
      "type": "number",
      "format": "float",
      "description": "Min avg profit. Minimum value. Percentage or ratio value as documented."
    },
    "minAvgRating": {
      "type": "number",
      "format": "float",
      "description": "Min avg rating. Minimum value."
    },
    "minAvgRatings": {
      "type": "integer",
      "format": "int32",
      "description": "Min avg ratings. Minimum value."
    },
    "minAvgRevenue": {
      "type": "number",
      "format": "float",
      "description": "Min avg revenue. Minimum value."
    },
    "minAvgSellers": {
      "type": "number",
      "format": "float",
      "description": "Min avg sellers. Minimum value."
    },
    "minAvgUnits": {
      "type": "integer",
      "format": "int32",
      "description": "Min avg units. Minimum value."
    },
    "minBrandCrn": {
      "type": "number",
      "format": "float",
      "description": "Min brand crn. Minimum value."
    },
    "minBrands": {
      "type": "integer",
      "format": "int32",
      "description": "Min brands. Minimum value."
    },
    "minEbcProportion": {
      "type": "number",
      "format": "float",
      "description": "Min A+ content proportion. Minimum value. Percentage or ratio value as documented."
    },
    "minFbaProportion": {
      "type": "number",
      "format": "float",
      "description": "Min FBA proportion. Minimum value. Percentage or ratio value as documented."
    },
    "minFbmProportion": {
      "type": "number",
      "format": "float",
      "description": "Min FBM proportion. Minimum value. Percentage or ratio value as documented."
    },
    "minGoodsCount": {
      "type": "integer",
      "format": "int32",
      "description": "Min goods count. Minimum value."
    },
    "minGoodsCrn": {
      "type": "number",
      "format": "float",
      "description": "Min goods crn. Minimum value."
    },
    "minNewAvgPrice": {
      "type": "number",
      "format": "float",
      "description": "Min new avg price. Minimum value."
    },
    "minNewAvgRating": {
      "type": "number",
      "format": "float",
      "description": "Min new avg rating. Minimum value."
    },
    "minNewAvgRatings": {
      "type": "integer",
      "format": "int32",
      "description": "Min new avg ratings. Minimum value."
    },
    "minNewAvgRevenue": {
      "type": "number",
      "format": "float",
      "description": "Min new avg revenue. Minimum value."
    },
    "minNewAvgUnits": {
      "type": "number",
      "format": "float",
      "description": "Min new avg units. Minimum value."
    },
    "minNewCount": {
      "type": "integer",
      "format": "int32",
      "description": "Min new count. Minimum value."
    },
    "minNewProportion": {
      "type": "number",
      "format": "float",
      "description": "Min new proportion. Minimum value. Percentage or ratio value as documented."
    },
    "minSellerCrn": {
      "type": "number",
      "format": "float",
      "description": "Min seller crn. Minimum value."
    },
    "minSellers": {
      "type": "integer",
      "format": "int32",
      "description": "Min sellers. Minimum value."
    },
    "minTopAvgBsr": {
      "type": "integer",
      "format": "int32",
      "description": "Min top avg BSR. Minimum value."
    },
    "minTopAvgRevenue": {
      "type": "number",
      "format": "float",
      "description": "Min top avg revenue. Minimum value."
    },
    "minTopAvgUnits": {
      "type": "integer",
      "format": "int32",
      "description": "Min top avg units. Minimum value."
    },
    "minVolume": {
      "type": "number",
      "format": "float",
      "description": "Min volume. Minimum value."
    },
    "minWeight": {
      "type": "number",
      "format": "float",
      "description": "Min weight. Minimum value."
    },
    "month": {
      "type": "string",
      "description": "Data month. Use the format documented for this endpoint, usually yyyyMM. Available values (Table 1.1): nearly, yyyyMM"
    },
    "newProduct": {
      "type": "integer",
      "format": "int32",
      "description": "Accepted for compatibility. The data service currently returns the same distribution for any value, so it can be left out."
    },
    "nodeIdPath": {
      "type": "string",
      "description": "Amazon category node path."
    },
    "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."
        }
      },
      "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."
    },
    "sellerLocation": {
      "type": "string",
      "description": "Seller location."
    },
    "size": {
      "type": "integer",
      "format": "int32",
      "minimum": 1,
      "description": "Number of results per page."
    },
    "topNum": {
      "type": "integer",
      "format": "int32",
      "description": "Top num."
    }
  },
  "required": [
    "marketplace"
  ],
  "additionalProperties": false
}