ecommercedataapi-com · Schema

AmazonMarketsResearchRequest

Companyecommercedataapiamazonmarket-research

Properties

Name Type Description
departmentKeyword string Department keyword.
marketplace string Amazon marketplace code. Supported values are listed in the schema.
maxAmazonSelfProportion number Max Amazon self proportion. Maximum value. Percentage or ratio value as documented.
maxAvgBsr integer Max avg BSR. Maximum value.
maxAvgPrice number Max avg price. Maximum value.
maxAvgProfit number Max avg profit. Maximum value. Percentage or ratio value as documented.
maxAvgRating number Max avg rating. Maximum value.
maxAvgRatings integer Max avg ratings. Maximum value.
maxAvgRevenue number Max avg revenue. Maximum value.
maxAvgSellers number Max avg sellers. Maximum value.
maxAvgUnits integer Max avg units. Maximum value.
maxBrandCrn number Max brand crn. Maximum value.
maxBrands integer Max brands. Maximum value.
maxEbcProportion number Max A+ content proportion. Maximum value. Percentage or ratio value as documented.
maxFbaProportion number Max FBA proportion. Maximum value. Percentage or ratio value as documented.
maxFbmProportion number Max FBM proportion. Maximum value. Percentage or ratio value as documented.
maxGoodsCount integer Max goods count. Maximum value.
maxGoodsCrn number Max goods crn. Maximum value.
maxNewAvgPrice number Max new avg price. Maximum value.
maxNewAvgRating number Max new avg rating. Maximum value.
maxNewAvgRatings integer Max new avg ratings. Maximum value.
maxNewAvgRevenue number Max new avg revenue. Maximum value.
maxNewAvgUnits number Max new avg units. Maximum value.
maxNewCount integer Max new count. Maximum value.
maxNewProportion number Max new proportion. Maximum value. Percentage or ratio value as documented.
maxSellerCrn number Max seller crn. Maximum value.
maxSellers integer Max sellers. Maximum value.
maxTopAvgBsr integer Max top avg BSR. Maximum value.
maxTopAvgRevenue number Max top avg revenue. Maximum value.
maxTopAvgUnits integer Max top avg units. Maximum value.
maxVolume number Max volume. Maximum value.
maxWeight number Max weight. Maximum value.
minAmazonSelfProportion number Min Amazon self proportion. Minimum value. Percentage or ratio value as documented.
minAvgBsr integer Min avg BSR. Minimum value.
minAvgPrice number Min avg price. Minimum value.
minAvgProfit number Min avg profit. Minimum value. Percentage or ratio value as documented.
minAvgRating number Min avg rating. Minimum value.
minAvgRatings integer Min avg ratings. Minimum value.
minAvgRevenue number Min avg revenue. Minimum value.
minAvgSellers number Min avg sellers. Minimum value.
minAvgUnits integer Min avg units. Minimum value.
minBrandCrn number Min brand crn. Minimum value.
minBrands integer Min brands. Minimum value.
minEbcProportion number Min A+ content proportion. Minimum value. Percentage or ratio value as documented.
minFbaProportion number Min FBA proportion. Minimum value. Percentage or ratio value as documented.
minFbmProportion number Min FBM proportion. Minimum value. Percentage or ratio value as documented.
minGoodsCount integer Min goods count. Minimum value.
minGoodsCrn number Min goods crn. Minimum value.
minNewAvgPrice number Min new avg price. Minimum value.
minNewAvgRating number Min new avg rating. Minimum value.
minNewAvgRatings integer Min new avg ratings. Minimum value.
minNewAvgRevenue number Min new avg revenue. Minimum value.
minNewAvgUnits number Min new avg units. Minimum value.
minNewCount integer Min new count. Minimum value.
minNewProportion number Min new proportion. Minimum value. Percentage or ratio value as documented.
minSellerCrn number Min seller crn. Minimum value.
minSellers integer Min sellers. Minimum value.
minTopAvgBsr integer Min top avg BSR. Minimum value.
minTopAvgRevenue number Min top avg revenue. Minimum value.
minTopAvgUnits integer Min top avg units. Minimum value.
minVolume number Min volume. Minimum value.
minWeight number Min weight. Minimum value.
month string Data month. Use the format documented for this endpoint, usually yyyyMM. Available values (Table 1.1): nearly, yyyyMM
newProduct integer Accepted for compatibility. The data service currently returns the same distribution for any value, so it can be left out.
nodeIdPath string Amazon category node path.
order object Sort definition.
page integer Page number starting at 1.
returnFields string Optional comma-separated response fields. Omit it to receive the standard payload.
sellerLocation string Seller location.
size integer Number of results per page.
topNum integer Top num.
View JSON Schema on GitHub

JSON Schema

ecommercedataapi-com-amazon-markets-research-request-schema.json Raw ↑ 
{
  "$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
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema 
curl "https://apis.io/api/v1/json-schemas/ecommercedataapi-com-amazon-markets-research-request"
All schemas 
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.