--- title: "Amazon Market Research" method: POST path: "/v1/amazon/market/research" tags: ["Amazon Markets"] --- # Amazon Market Research `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 Research category markets with demand, competition, seller, and margin filters. ## Request body - AmazonMarketsResearchRequest - `departmentKeyword` string: 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. - `maxAmazonSelfProportion` number, float: Max Amazon self proportion. Maximum value. Percentage or ratio value as documented. - `maxAvgBsr` integer: Max avg BSR. Maximum value. - `maxAvgPrice` number, float: Max avg price. Maximum value. - `maxAvgProfit` number, float: Max avg profit. Maximum value. Percentage or ratio value as documented. - `maxAvgRating` number, float: Max avg rating. Maximum value. - `maxAvgRatings` integer: Max avg ratings. Maximum value. - `maxAvgRevenue` number, float: Max avg revenue. Maximum value. - `maxAvgSellers` number, float: Max avg sellers. Maximum value. - `maxAvgUnits` integer: Max avg units. Maximum value. - `maxBrandCrn` number, float: Max brand crn. Maximum value. - `maxBrands` integer: Max brands. Maximum value. - `maxEbcProportion` number, float: Max A+ content proportion. Maximum value. Percentage or ratio value as documented. - `maxFbaProportion` number, float: Max FBA proportion. Maximum value. Percentage or ratio value as documented. - `maxFbmProportion` number, float: Max FBM proportion. Maximum value. Percentage or ratio value as documented. - `maxGoodsCount` integer: Max goods count. Maximum value. - `maxGoodsCrn` number, float: Max goods crn. Maximum value. - `maxNewAvgPrice` number, float: Max new avg price. Maximum value. - `maxNewAvgRating` number, float: Max new avg rating. Maximum value. - `maxNewAvgRatings` integer: Max new avg ratings. Maximum value. - `maxNewAvgRevenue` number, float: Max new avg revenue. Maximum value. - `maxNewAvgUnits` number, float: Max new avg units. Maximum value. - `maxNewCount` integer: Max new count. Maximum value. - `maxNewProportion` number, float: Max new proportion. Maximum value. Percentage or ratio value as documented. - `maxSellerCrn` number, float: Max seller crn. Maximum value. - `maxSellers` integer: Max sellers. Maximum value. - `maxTopAvgBsr` integer: Max top avg BSR. Maximum value. - `maxTopAvgRevenue` number, float: Max top avg revenue. Maximum value. - `maxTopAvgUnits` integer: Max top avg units. Maximum value. - `maxVolume` number, float: Max volume. Maximum value. - `maxWeight` number, float: Max weight. Maximum value. - `minAmazonSelfProportion` number, float: Min Amazon self proportion. Minimum value. Percentage or ratio value as documented. - `minAvgBsr` integer: Min avg BSR. Minimum value. - `minAvgPrice` number, float: Min avg price. Minimum value. - `minAvgProfit` number, float: Min avg profit. Minimum value. Percentage or ratio value as documented. - `minAvgRating` number, float: Min avg rating. Minimum value. - `minAvgRatings` integer: Min avg ratings. Minimum value. - `minAvgRevenue` number, float: Min avg revenue. Minimum value. - `minAvgSellers` number, float: Min avg sellers. Minimum value. - `minAvgUnits` integer: Min avg units. Minimum value. - `minBrandCrn` number, float: Min brand crn. Minimum value. - `minBrands` integer: Min brands. Minimum value. - `minEbcProportion` number, float: Min A+ content proportion. Minimum value. Percentage or ratio value as documented. - `minFbaProportion` number, float: Min FBA proportion. Minimum value. Percentage or ratio value as documented. - `minFbmProportion` number, float: Min FBM proportion. Minimum value. Percentage or ratio value as documented. - `minGoodsCount` integer: Min goods count. Minimum value. - `minGoodsCrn` number, float: Min goods crn. Minimum value. - `minNewAvgPrice` number, float: Min new avg price. Minimum value. - `minNewAvgRating` number, float: Min new avg rating. Minimum value. - `minNewAvgRatings` integer: Min new avg ratings. Minimum value. - `minNewAvgRevenue` number, float: Min new avg revenue. Minimum value. - `minNewAvgUnits` number, float: Min new avg units. Minimum value. - `minNewCount` integer: Min new count. Minimum value. - `minNewProportion` number, float: Min new proportion. Minimum value. Percentage or ratio value as documented. - `minSellerCrn` number, float: Min seller crn. Minimum value. - `minSellers` integer: Min sellers. Minimum value. - `minTopAvgBsr` integer: Min top avg BSR. Minimum value. - `minTopAvgRevenue` number, float: Min top avg revenue. Minimum value. - `minTopAvgUnits` integer: Min top avg units. Minimum value. - `minVolume` number, float: Min volume. Minimum value. - `minWeight` number, float: 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. - `desc` boolean: Use true for descending order or false for ascending order. - `field` string: Field used to sort the results. - `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. ## Response `200` Amazon Market Research response. - GatewaySuccess - `request_id` string, uuid, required - `data` unknown, required ## Other responses - `400`: The request body or parameters are invalid. - `401`: Authentication failed. - `402`: The account does not have enough Credits for this request. - `403`: The subscription does not include this endpoint. - `404`: The endpoint does not exist. - `413`: The request body is too large. - `429`: The request limit was exceeded. - `500`: An internal error occurred. - `502`: The data service returned an invalid response. - `503`: The data service is temporarily unavailable. - `504`: The data service timed out. --- [API](https://skmtc.dev/ecommercedataapi/apis/ecommerce-data-api.md) · [All operations](https://skmtc.dev/ecommercedataapi/apis/ecommerce-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ecommercedataapi/apis/ecommerce-data-api/revisions/bdae32c46b9e?raw)