Amazon Products

Amazon Product Research

Research products with category, sales, price, review, and seller filters.

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

Request body

availableMonthinteger

Limit products by listing age: 1, 3, 6, 12, or 24 months. Omit the field for no listing-age restriction.

badgeACstring

Set to Y to require an Amazon's Choice badge.

badgeBSstring

Set to Y to require a Best Seller badge.

badgeNRstring

Set to Y to require a New Release badge.

dimensionTypestring

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

excludeBrandsstring

Exclude products from the specified brand filter.

excludeKeywordsstring

Keywords to exclude from the product results.

excludeSellersstring

Exclude products matching the specified seller filter.

filterSubstring

Set to Y to apply the subcategory-rank filters. It only takes effect when a category is specified.

fulfillmentstring

Fulfillment types separated by commas. Supported values are AMZ, FBA, and FBM.

includeBrandsstring

Only include products from the specified brand filter.

includeSellersstring

Only include products matching the specified seller filter.

keywordstring

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.

matchTypeinteger

Keyword match mode: 1 for phrase match, 2 for broad match, or 3 for exact match. Defaults to 2.

maxAmzUnitinteger

Maximum recent sales estimate for the current ASIN. This filter is available for latest-30-day queries.

maxBsrinteger

Worst boundary for the top-level Best Sellers Rank. Smaller BSR values indicate a better rank.

maxBsrCrnumber float

Maximum BSR change rate as a percentage value.

maxBsrCvinteger

Maximum numeric BSR change for the selected month.

maxFbanumber float

Maximum estimated FBA fee in the marketplace currency.

maxLqsnumber float

Maximum listing quality score.

maxPricenumber float

Maximum product price in the marketplace currency.

maxProfitnumber float

Maximum estimated gross margin percentage.

maxRatingnumber float

Maximum average star rating.

maxRatingsinteger

Maximum total rating count.

maxRatingsCvinteger

Maximum number of newly added ratings in the selected month.

maxRevenuenumber float

Maximum estimated monthly revenue in the marketplace currency.

maxRevenueCrnumber float

Maximum monthly revenue growth rate as a percentage value.

maxSellersinteger

Maximum number of sellers on the listing.

maxSubBsrRankinteger

Maximum subcategory rank. Requires filterSub=Y.

maxUnitsinteger

Maximum estimated monthly sales for the parent listing.

maxUnitsCrnumber float

Maximum monthly sales growth rate as a percentage value.

maxVariationsinteger

Maximum variation count.

maxWeightsnumber float

Maximum product weight expressed in weightUnit.

minAmzUnitinteger

Minimum recent sales estimate for the current ASIN. This filter is available for latest-30-day queries.

minBsrinteger

Best boundary for the top-level Best Sellers Rank. Smaller BSR values indicate a better rank.

minBsrCrnumber float

Minimum BSR change rate as a percentage value.

minBsrCvinteger

Minimum numeric BSR change for the selected month.

minFbanumber float

Minimum estimated FBA fee in the marketplace currency.

minLqsnumber float

Minimum listing quality score.

minPricenumber float

Minimum product price in the marketplace currency.

minProfitnumber float

Minimum estimated gross margin percentage.

minRatingnumber float

Minimum average star rating.

minRatingsinteger

Minimum total rating count.

minRatingsCvinteger

Minimum number of newly added ratings in the selected month.

minRevenuenumber float

Minimum estimated monthly revenue in the marketplace currency.

minRevenueCrnumber float

Minimum monthly revenue growth rate as a percentage value.

minSellersinteger

Minimum number of sellers on the listing.

minSubBsrRankinteger

Minimum subcategory rank. Requires filterSub=Y.

minUnitsinteger

Minimum estimated monthly sales for the parent listing.

minUnitsCrnumber float

Minimum monthly sales growth rate as a percentage value.

minVariationsinteger

Minimum variation count.

minWeightsnumber float

Minimum product weight expressed in weightUnit.

monthstring

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

nodeIdPathstring

Single Amazon category node path. Use the category endpoint to obtain a node path.

nodeIdPathEqualboolean

When true, match only the exact category path. When false, include its descendant categories. Defaults to false.

nodeIdPathsstring[]

Amazon category node paths. Use the category endpoint to obtain node paths.

pageinteger

Page number starting at 1. Defaults to 1. A query can return at most 2,000 records; narrow the filters to retrieve additional segments.

returnFieldsstring

Optional response-field selection string. Omit it to receive the standard response payload.

sellerNationstring

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

sizeinteger

Results per page. Defaults to 50 and supports up to 100.

variationstring

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.

Example request

{
  "availableMonth": 3,
  "badgeAC": "Y",
  "badgeBS": "Y",
  "badgeNR": "Y",
  "dimensionType": "ST,LS",
  "excludeBrands": "Generic",
  "excludeKeywords": "portable",
  "excludeSellers": "A1MCYUGJD2ILFU",
  "filterSub": "Y",
  "fulfillment": "FBA,FBM",
  "includeBrands": "OLANLY",
  "includeSellers": "A1MCYUGJD2ILFU",
  "keyword": "bath rug",
  "marketplace": "US",
  "matchType": 2,
  "maxAmzUnit": 10000,
  "maxBsr": 50000,
  "maxBsrCr": 30,
  "maxBsrCv": 5000,
  "maxFba": 20,
  "maxLqs": 100,
  "maxPrice": 80,
  "maxProfit": 80,
  "maxRating": 5,
  "maxRatings": 3000,
  "maxRatingsCv": 500,
  "maxRevenue": 1000000,
  "maxRevenueCr": 100,
  "maxSellers": 10,
  "maxSubBsrRank": 100,
  "maxUnits": 50000,
  "maxUnitsCr": 100,
  "maxVariations": 20,
  "maxWeights": 5,
  "minAmzUnit": 100,
  "minBsr": 1,
  "minBsrCr": -30,
  "minBsrCv": -5000,
  "minFba": 2,
  "minLqs": 60,
  "minPrice": 20,
  "minProfit": 20,
  "minRating": 4,
  "minRatings": 10,
  "minRatingsCv": 10,
  "minRevenue": 10000,
  "minSellers": 1,
  "minSubBsrRank": 1,
  "minUnits": 500,
  "minVariations": 1,
  "minWeights": 0.1,
  "month": "nearly",
  "nodeIdPath": "1055398:1063236:1063242",
  "nodeIdPaths": [
    "1055398:1063236:1063242"
  ],
  "order": {
    "field": "total_units",
    "desc": true
  },
  "page": 1,
  "returnFields": "asin,title,price,units,revenue",
  "sellerNation": "CN,US",
  "size": 20,
  "variation": "Y",
  "weightUnit": "lb"
}

Response

Amazon Product Research response.

request_idstring uuid required

dataunknown required

Changes

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