--- title: "Amazon Product Research" method: POST path: "/v1/amazon/product/research" tags: ["Amazon Products"] --- # Amazon Product Research `POST /v1/amazon/product/research` ## Request - Base URL: `https://ecommercedataapi.com` - URL: `https://ecommercedataapi.com/v1/amazon/product/research` - Auth: one of: - API key in header `X-API-Key` - HTTP bearer Research products with category, sales, price, review, and seller filters. ## Request body - AmazonProductsResearchRequest - `availableMonth` integer: Limit products by listing age: 1, 3, 6, 12, or 24 months. Omit the field for no listing-age restriction. - `badgeAC` string: Set to Y to require an Amazon's Choice badge. - `badgeBS` string: Set to Y to require a Best Seller badge. - `badgeNR` string: Set to Y to require a New Release badge. - `dimensionType` string: Comma-separated product size-tier codes. Codes vary by marketplace; for example US values include ST, LS, SO, MO, LO, SP, O, ELO, EL5O, EL7O, and EL15O. Available values (Table 1.4): United States: ST, SS, LS, SO, MO, LO, LB, SP, O, ELO, EL5O, EL7O, EL15O; Japan: SM, ST, OV, SS, O; Canada: EN, ST, SO, MO, LO, SP, O; Europe (UK/DE/FR/IT/ES): SL, NL, LL, ELL, SM, SD, SB, NB, LB, SPO, O - `excludeBrands` string: Exclude products from the specified brand filter. - `excludeKeywords` string: Keywords to exclude from the product results. - `excludeSellers` string: Exclude products matching the specified seller filter. - `filterSub` string: Set to Y to apply the subcategory-rank filters. It only takes effect when a category is specified. - `fulfillment` string: Fulfillment types separated by commas. Supported values are AMZ, FBA, and FBM. - `includeBrands` string: Only include products from the specified brand filter. - `includeSellers` string: Only include products matching the specified seller filter. - `keyword` string: Product keyword used to filter listing titles and related text. - `marketplace` 'US' | 'UK' | 'DE' | 'FR' | 'IT' | 'ES' | 'MX' | 'CA' | 'AU' | 'JP' | 'IN' | 'AE' | 'BR', required: Amazon marketplace code. Supported values: US, UK, DE, FR, IT, ES, MX, CA, AU, JP, IN, AE, and BR. - `matchType` integer: Keyword match mode: 1 for phrase match, 2 for broad match, or 3 for exact match. Defaults to 2. - `maxAmzUnit` integer: Maximum recent sales estimate for the current ASIN. This filter is available for latest-30-day queries. - `maxBsr` integer: Worst boundary for the top-level Best Sellers Rank. Smaller BSR values indicate a better rank. - `maxBsrCr` number, float: Maximum BSR change rate as a percentage value. - `maxBsrCv` integer: Maximum numeric BSR change for the selected month. - `maxFba` number, float: Maximum estimated FBA fee in the marketplace currency. - `maxLqs` number, float: Maximum listing quality score. - `maxPrice` number, float: Maximum product price in the marketplace currency. - `maxProfit` number, float: Maximum estimated gross margin percentage. - `maxRating` number, float: Maximum average star rating. - `maxRatings` integer: Maximum total rating count. - `maxRatingsCv` integer: Maximum number of newly added ratings in the selected month. - `maxRevenue` number, float: Maximum estimated monthly revenue in the marketplace currency. - `maxRevenueCr` number, float: Maximum monthly revenue growth rate as a percentage value. - `maxSellers` integer: Maximum number of sellers on the listing. - `maxSubBsrRank` integer: Maximum subcategory rank. Requires filterSub=Y. - `maxUnits` integer: Maximum estimated monthly sales for the parent listing. - `maxUnitsCr` number, float: Maximum monthly sales growth rate as a percentage value. - `maxVariations` integer: Maximum variation count. - `maxWeights` number, float: Maximum product weight expressed in weightUnit. - `minAmzUnit` integer: Minimum recent sales estimate for the current ASIN. This filter is available for latest-30-day queries. - `minBsr` integer: Best boundary for the top-level Best Sellers Rank. Smaller BSR values indicate a better rank. - `minBsrCr` number, float: Minimum BSR change rate as a percentage value. - `minBsrCv` integer: Minimum numeric BSR change for the selected month. - `minFba` number, float: Minimum estimated FBA fee in the marketplace currency. - `minLqs` number, float: Minimum listing quality score. - `minPrice` number, float: Minimum product price in the marketplace currency. - `minProfit` number, float: Minimum estimated gross margin percentage. - `minRating` number, float: Minimum average star rating. - `minRatings` integer: Minimum total rating count. - `minRatingsCv` integer: Minimum number of newly added ratings in the selected month. - `minRevenue` number, float: Minimum estimated monthly revenue in the marketplace currency. - `minRevenueCr` number, float: Minimum monthly revenue growth rate as a percentage value. - `minSellers` integer: Minimum number of sellers on the listing. - `minSubBsrRank` integer: Minimum subcategory rank. Requires filterSub=Y. - `minUnits` integer: Minimum estimated monthly sales for the parent listing. - `minUnitsCr` number, float: Minimum monthly sales growth rate as a percentage value. - `minVariations` integer: Minimum variation count. - `minWeights` number, float: Minimum product weight expressed in weightUnit. - `month` string: Data month. Use "nearly" for the latest 30 days or yyyyMM for a specific month within the previous 24 months. Available values (Table 1.1): nearly, yyyyMM - `nodeIdPath` string: Single Amazon category node path. Use the category endpoint to obtain a node path. - `nodeIdPathEqual` boolean: When true, match only the exact category path. When false, include its descendant categories. Defaults to false. - `nodeIdPaths` string[]: Amazon category node paths. Use the category endpoint to obtain node paths. - `order` object: Sort definition. - `desc` boolean: Use true for descending order or false for ascending order. Defaults to true. - `field` string: Sort field: total_units, total_amount, bsr_rank, price, rating, reviews, profit, reviews_rate, available_date, or questions. Defaults to total_units. Available values (Table 1.6): total_units, total_amount, bsr_rank, price, rating, reviews, profit, reviews_rate, available_date, questions, total_units_growth, total_amount_growth, reviews_increasement, bsr_rank_cv, bsr_rank_cr, amz_unit - `page` integer: Page number starting at 1. Defaults to 1. A query can return at most 2,000 records; narrow the filters to retrieve additional segments. - `returnFields` string: Optional response-field selection string. Omit it to receive the standard response payload. - `sellerNation` string: Seller country or region codes. Multiple values can be separated by commas; common values include CN, HK, US, JP, DE, and FR. Available values (Table 1.5): CN, HK, US, JP, DE, FR - `size` integer: Results per page. Defaults to 50 and supports up to 100. - `variation` string: Variation handling: N includes variation ASINs; Y excludes variation ASINs. - `weightUnit` 'g' | 'kg' | 'oz' | 'lb': Unit used by minWeights and maxWeights: g, kg, oz, or lb. Defaults to g. ## Response `200` Amazon Product 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)