Amazon Markets

Amazon Market Research

Research category markets with demand, competition, seller, and margin filters.

post/v1/amazon/market/research

Request

  • Base URL: https://ecommercedataapi.com
  • URL: https://ecommercedataapi.com/v1/amazon/market/research
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Request body

departmentKeywordstring

Department keyword.

marketplace'US' | 'UK' | 'DE' | 'FR' | 'IT' | 'ES' | 'MX' | 'CA' | 'AU' | 'JP' | 'IN' | 'AE' | 'BR' required

Amazon marketplace code. Supported values are listed in the schema.

maxAmazonSelfProportionnumber float

Max Amazon self proportion. Maximum value. Percentage or ratio value as documented.

maxAvgBsrinteger

Max avg BSR. Maximum value.

maxAvgPricenumber float

Max avg price. Maximum value.

maxAvgProfitnumber float

Max avg profit. Maximum value. Percentage or ratio value as documented.

maxAvgRatingnumber float

Max avg rating. Maximum value.

maxAvgRatingsinteger

Max avg ratings. Maximum value.

maxAvgRevenuenumber float

Max avg revenue. Maximum value.

maxAvgSellersnumber float

Max avg sellers. Maximum value.

maxAvgUnitsinteger

Max avg units. Maximum value.

maxBrandCrnnumber float

Max brand crn. Maximum value.

maxBrandsinteger

Max brands. Maximum value.

maxEbcProportionnumber float

Max A+ content proportion. Maximum value. Percentage or ratio value as documented.

maxFbaProportionnumber float

Max FBA proportion. Maximum value. Percentage or ratio value as documented.

maxFbmProportionnumber float

Max FBM proportion. Maximum value. Percentage or ratio value as documented.

maxGoodsCountinteger

Max goods count. Maximum value.

maxGoodsCrnnumber float

Max goods crn. Maximum value.

maxNewAvgPricenumber float

Max new avg price. Maximum value.

maxNewAvgRatingnumber float

Max new avg rating. Maximum value.

maxNewAvgRatingsinteger

Max new avg ratings. Maximum value.

maxNewAvgRevenuenumber float

Max new avg revenue. Maximum value.

maxNewAvgUnitsnumber float

Max new avg units. Maximum value.

maxNewCountinteger

Max new count. Maximum value.

maxNewProportionnumber float

Max new proportion. Maximum value. Percentage or ratio value as documented.

maxSellerCrnnumber float

Max seller crn. Maximum value.

maxSellersinteger

Max sellers. Maximum value.

maxTopAvgBsrinteger

Max top avg BSR. Maximum value.

maxTopAvgRevenuenumber float

Max top avg revenue. Maximum value.

maxTopAvgUnitsinteger

Max top avg units. Maximum value.

maxVolumenumber float

Max volume. Maximum value.

maxWeightnumber float

Max weight. Maximum value.

minAmazonSelfProportionnumber float

Min Amazon self proportion. Minimum value. Percentage or ratio value as documented.

minAvgBsrinteger

Min avg BSR. Minimum value.

minAvgPricenumber float

Min avg price. Minimum value.

minAvgProfitnumber float

Min avg profit. Minimum value. Percentage or ratio value as documented.

minAvgRatingnumber float

Min avg rating. Minimum value.

minAvgRatingsinteger

Min avg ratings. Minimum value.

minAvgRevenuenumber float

Min avg revenue. Minimum value.

minAvgSellersnumber float

Min avg sellers. Minimum value.

minAvgUnitsinteger

Min avg units. Minimum value.

minBrandCrnnumber float

Min brand crn. Minimum value.

minBrandsinteger

Min brands. Minimum value.

minEbcProportionnumber float

Min A+ content proportion. Minimum value. Percentage or ratio value as documented.

minFbaProportionnumber float

Min FBA proportion. Minimum value. Percentage or ratio value as documented.

minFbmProportionnumber float

Min FBM proportion. Minimum value. Percentage or ratio value as documented.

minGoodsCountinteger

Min goods count. Minimum value.

minGoodsCrnnumber float

Min goods crn. Minimum value.

minNewAvgPricenumber float

Min new avg price. Minimum value.

minNewAvgRatingnumber float

Min new avg rating. Minimum value.

minNewAvgRatingsinteger

Min new avg ratings. Minimum value.

minNewAvgRevenuenumber float

Min new avg revenue. Minimum value.

minNewAvgUnitsnumber float

Min new avg units. Minimum value.

minNewCountinteger

Min new count. Minimum value.

minNewProportionnumber float

Min new proportion. Minimum value. Percentage or ratio value as documented.

minSellerCrnnumber float

Min seller crn. Minimum value.

minSellersinteger

Min sellers. Minimum value.

minTopAvgBsrinteger

Min top avg BSR. Minimum value.

minTopAvgRevenuenumber float

Min top avg revenue. Minimum value.

minTopAvgUnitsinteger

Min top avg units. Minimum value.

minVolumenumber float

Min volume. Minimum value.

minWeightnumber float

Min weight. Minimum value.

monthstring

Data month. Use the format documented for this endpoint, usually yyyyMM. Available values (Table 1.1): nearly, yyyyMM

newProductinteger

Accepted for compatibility. The data service currently returns the same distribution for any value, so it can be left out.

nodeIdPathstring

Amazon category node path.

pageinteger

Page number starting at 1.

returnFieldsstring

Optional comma-separated response fields. Omit it to receive the standard payload.

sellerLocationstring

Seller location.

sizeinteger

Number of results per page.

topNuminteger

Top num.

Example request

{
  "departmentKeyword": "Electronics:Accessories & Supplies",
  "marketplace": "US",
  "maxAmazonSelfProportion": 56,
  "maxAvgBsr": 100,
  "maxAvgPrice": 50,
  "maxAvgProfit": 70,
  "maxAvgRating": 3,
  "maxAvgRatings": 500,
  "maxAvgRevenue": 900,
  "maxAvgSellers": 10.4,
  "maxAvgUnits": 10000,
  "maxBrandCrn": 55,
  "maxBrands": 20,
  "maxEbcProportion": 54,
  "maxFbaProportion": 54,
  "maxFbmProportion": 54,
  "maxGoodsCount": 90,
  "maxGoodsCrn": 55,
  "maxNewAvgPrice": 45,
  "maxNewAvgRating": 4.5,
  "maxNewAvgRatings": 554,
  "maxNewAvgRevenue": 2000,
  "maxNewAvgUnits": 800,
  "maxNewCount": 20,
  "maxNewProportion": 56,
  "maxSellerCrn": 45,
  "maxSellers": 10,
  "maxTopAvgBsr": 998,
  "maxTopAvgRevenue": 3000,
  "maxTopAvgUnits": 300,
  "maxVolume": 50,
  "maxWeight": 60,
  "minAmazonSelfProportion": 34,
  "minAvgBsr": 50,
  "minAvgPrice": 30,
  "minAvgProfit": 20,
  "minAvgRating": 2.5,
  "minAvgRatings": 100,
  "minAvgRevenue": 100,
  "minAvgSellers": 4.4,
  "minAvgUnits": 100,
  "minBrandCrn": 45,
  "minBrands": 10,
  "minEbcProportion": 34,
  "minFbaProportion": 34,
  "minFbmProportion": 34,
  "minGoodsCount": 40,
  "minGoodsCrn": 45,
  "minNewAvgPrice": 34,
  "minNewAvgRating": 4,
  "minNewAvgRatings": 23,
  "minNewAvgRevenue": 900,
  "minNewAvgUnits": 400,
  "minNewCount": 4,
  "minNewProportion": 34,
  "minSellerCrn": 55,
  "minSellers": 6,
  "minTopAvgBsr": 68,
  "minTopAvgRevenue": 2000,
  "minTopAvgUnits": 200,
  "minVolume": 20,
  "minWeight": 30,
  "month": "202507",
  "newProduct": 3,
  "nodeIdPath": "172282:281407",
  "order": {},
  "page": 1,
  "returnFields": "marketplace,currency,nodeId",
  "sellerLocation": "US,GB",
  "size": 50,
  "topNum": 10
}

Response

Amazon Market Research response.

request_idstring uuid required
dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.