Sales Trends API Documentation | Ecommerce Data API

Use the Sales Trends API for Amazon product research. Review request parameters, response fields, and runnable examples.

Availability: Available

This endpoint is active in the v1 gateway, OpenAPI, and subscription catalog. A successful call consumes 1 billing unit.

POST /v1/amazon/products/sales-trends

The request and response fields below match the current public contract.

Quick call

First create an API key, then store it in a server-side environment variable:

export ECOMMERCE_DATA_API_KEY="your_api_key"

curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/products/sales-trends \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{
  "marketplace": "US",
  "asin": "B08CK5Z5Q1"
}'

Integrate with an AI CLI

Copy for your AI CLI

Paste this task into Codex, Claude Code, Gemini CLI, or another coding agent.

Integrate the "Sales Trends" endpoint from Ecommerce Data API into the current repository. Make the changes directly instead of only returning sample code.

API documentation: https://ecommercedataapi.com/en/docs/amazon/products/sales-trends
Endpoint: POST https://ecommercedataapi.com/v1/amazon/products/sales-trends
API key environment variable: ECOMMERCE_DATA_API_KEY

Example request:
{
"marketplace": "US",
"asin": "B08CK5Z5Q1"
}

Requirements:
1. Read the API documentation first, then inspect the repository's language, framework, HTTP client, directory structure, and environment-variable conventions.
2. Reuse the existing API client and error-handling patterns. If none exist, add the smallest reusable Ecommerce Data API client and an endpoint-specific wrapper.
3. Read the key from the server-side ECOMMERCE_DATA_API_KEY environment variable and send Content-Type: application/json plus the X-API-Key header. Never write a real key into source code, browser code, logs, test snapshots, or Git.
4. If the environment variable is missing, tell me to configure ECOMMERCE_DATA_API_KEY myself. Do not request, print, or invent the real key, and continue implementing code and tests that do not require a live request.
5. Implement request and response types from the documentation. Handle non-2xx responses, request_id, error.code, error.message, and 429 rate limits.
6. Add a minimal usage example or test that follows the repository's conventions. Run one minimal live request only when the key is already configured and external requests are allowed; otherwise use mocks or static validation.
7. Run the relevant formatter, type checker, and tests. Report changed files, usage, verification results, and any environment variable I still need to configure.

Need an API key?Create API key

Open this request in Postman

Download the preconfigured collection for this endpoint, then import it into Postman.

Download Postman config

Set the apiKey collection variable after import.Create API key

Node.js example

const response = await fetch(
  'https://ecommercedataapi.com/v1/amazon/products/sales-trends',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
    },
    body: JSON.stringify({
      marketplace: 'US',
      asin: 'B08CK5Z5Q1',
    }),
  }
);

const result = await response.json();

if (!response.ok) {
  throw new Error(`${result.error?.code}: ${result.error?.message}`);
}

console.log(result.data);

Python example

import os
import requests

response = requests.post(
    "https://ecommercedataapi.com/v1/amazon/products/sales-trends",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
    },
    json={
        "marketplace": "US",
        "asin": "B08CK5Z5Q1",
    },
    timeout=30,
)

response.raise_for_status()
print(response.json()["data"])

Request body

Send the fields below directly in the JSON body without an extra wrapper. Undefined fields are rejected.

Field	Type	Required	Description	Example
`marketplace`	String	Yes	Amazon marketplace code. Supported values are listed in the schema.	US
`asin`	String	Yes	Amazon Standard Identification Number.	B08GHW4TBS
`returnFields`	String	No	Optional comma-separated response fields. Omit it to receive the standard payload.	asin,salesTrendPoints

Response structure

Field	Type	Description
`request_id`	String	Unique identifier for this request.
`data`	Object	Endpoint business data.

The fields below are inside data. For array endpoints they describe one array item; for paginated endpoints they describe one record in items[].

Response fields

Field	Type	Description	Example
`asin`	Object	ASIN.	-
`asin.asin`	String	ASIN.	B08GHW4TBS
`asin.asinUrl`	String	ASIN URL.	https://www.amazon.com/dp/B08GHW4TBS
`asin.availableDate`	Integer	Available date. Date or timestamp value.	1.60906E+12
`asin.badge`	Object	Badge.	包括了下面 5 个标识
`asin.badge.bestSeller`	String	Best seller.	Y 或者 N
`asin.badge.amazonChoice`	String	Amazon choice.	Y 或者 N
`asin.badge.newRelease`	String	New release.	Y 或者 N
`asin.badge.ebc`	String	A+ content.	Y 或者 N
`asin.badge.video`	String	Video.	Y 或者 N
`asin.brand`	String	Brand.	mermaker
`asin.brandUrl`	String	Brand URL.	/stores/Mermaker/page/984A6448-1C68-4CCA-AD5A-D574EA2D65D5?ref_=ast_bln
`asin.bsrId`	String	BSR ID.	home-garden
`asin.bsrLabel`	String	BSR label.	Home & Kitchen
`asin.bsrRank`	Integer	BSR rank.	1006
`asin.createdTime`	Integer	Created time. Date or timestamp value.	1.60647E+12
`asin.dimensions`	String	Dimensions.	7 x 6 x 0.6 inches
`asin.firstRatingDate`	Integer	First rating date. Date or timestamp value.	1.60906E+12
`asin.imageUrl`	String	Image URL.	https://images-na.ssl-images-amazon.com/images/I/412616zl5YL .AC_US200.jpg
`asin.lqs`	Integer	Listing quality score.	97
`asin.nodeId`	String	Node ID.	1063280
`asin.nodeIdPath`	String	Node ID path.	1055398:1063252:1063280
`asin.nodeLabelPath`	String	Node label path.	Home & Kitchen:Bedding:Blankets & Throws
`asin.nodeLabelPathLocale`	String	Node label path locale.	家居厨房用品:床上用品:毯子、盖毯
`asin.parent`	String	Parent.	B07V5GB9B5
`asin.price`	Number	Price.	21.99
`asin.questions`	Integer	Questions.	5
`asin.rating`	Number	Rating.	4.8
`asin.ratings`	Integer	Ratings.	29229
`asin.reviews`	Integer	Reviews.	9229
`asin.variantRatings`	Integer	Variant ratings.	12454
`asin.variantReviews`	Integer	Variant reviews.	3211
`asin.sellerId`	String	Seller ID.	A13AJ1GXFINAZ
`asin.sellerName`	String	Seller name.	Mermaker
`asin.fulfillment`	String	Fulfillment.	FBA
`asin.sellers`	Integer	Sellers.	1
`asin.skuList`	Array	Sku list.	["Color: Beige","Size: 47 inches"]
`asin.marketplace`	String	Marketplace.	见表 1.2
`asin.title`	String	Title.	mermaker Burritos Tortilla Blanket 2.0 Double Sided 47 inches for Adult and Kids,Giant Funny Realistic Food Throw Blanket,285 GSM Novelty Soft Flannel Taco Blanket (Yellow Blanket-Double Sided)
`asin.features`	Array	Features.	-
`asin.overviews`	String	Overviews.	-
`asin.updatedTime`	Integer	Updated time. Date or timestamp value.	1.60906E+12
`asin.variationList`	Array	Variation list.	[{"asin":"B07V5GB9B5","attribute":"Beige"},{"asin":"B08H86SSSF","attribute":"Cookie"}]
`asin.variations`	Integer	Variations.	14
`asin.weight`	String	Weight.	15.2 ounces
`asin.zoomImageUrl`	String	Zoom image URL.	https://images-na.ssl-images-amazon.com/images/I/412616zl5YL .AC_US600.jpg
`asin.subcategories`	Object	Subcategories.	-
`asin.subcategories.rank`	Integer	Rank.	1
`asin.subcategories.code`	String	Code.	17874234011
`asin.subcategories.label`	String	Label.	Kids' Throw Blankets
`asin.deliveryPrice`	Number	Delivery price.	4
`asin.primePrice`	Number	Prime price.	42
`asin.coupon`	String	Coupon.	[save $20]
`salesTrendPoints`	Array	Sales trend points.	-
`salesTrendPoints.month`	String	Month.	-
`salesTrendPoints.price`	Number	Price.	-
`salesTrendPoints.averagePrice`	Number	Average price.	-
`salesTrendPoints.parentUnitSales`	Integer	Parent unit sales.	-
`salesTrendPoints.childUnitSales`	Integer	Child unit sales.	-
`salesTrendPoints.parentSalesRevenue`	Number	Parent sales revenue.	-
`salesTrendPoints.childSalesRevenue`	Number	Child sales revenue.	-

Response example

{
  "request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
  "data": {
    "asin": {
      "asin": "B0FGJ8SP7R",
      "asinUrl": "https://www.amazon.com/dp/B0FGJ8SP7R?psc=1",
      "availableDate": 1751385600000,
      "brand": "DLHMBOQ",
      "brandUrl": "/s/ref=bl_dp_s_web_0?ie=UTF8&search-alias=aps&field-keywords=DLHMBOQ",
      "bsrId": "hi",
      "bsrLabel": "Tools & Home Improvement",
      "bsrRank": 6939,
      "subcategories": [
        {
          "rank": 2,
          "code": "2232357011",
          "label": "Dishwasher Replacement Hoses"
        }
      ],
      "createdTime": 1751531618000,
      "dimensions": "8.6\"L x 8.2\"W",
      "firstRatingDate": 1774713600000,
      "imageUrl": "https://m.media-amazon.com/images/I/4193rnBah3L._AC_US200_.jpg",
      "lqs": 100,
      "nodeId": 2232357011,
      "nodeIdPath": "2619525011:3741181:3741201:2232357011",
      "nodeLabelPath": "Appliances:Parts & Accessories:Dishwasher Parts & Accessories:Hoses",
      "nodeLabelPathLocale": null,
      "parent": "B0G62RQZVD",
      "price": 11.99,
      "primePrice": -1,
      "deliveryPrice": -1,
      "coupon": "",
      "questions": null,
      "rating": 4.5,
      "ratings": 556,
      "reviews": 0,
      "variantRatings": null,
      "variantReviews": 41,
      "sellerId": "A3CUUY1JMQCJRJ",
      "sellerName": "DL Boutique",
      "fulfillment": "FBA",
      "sellers": 1,
      "marketplace": "US",
      "title": "10ft Washing Machine Drain Hose Extension Kit - Universal for Washer, Dishwasher & Dehumidifier, 7-Piece Set with U-Bracket, 4 Clamps & Adapter",
      "updatedTime": 1780466868000,
      "variations": 2,
      "weight": "0.39 Pounds",
      "zoomImageUrl": "https://m.media-amazon.com/images/I/4193rnBah3L._AC_US600_.jpg",
      "skuList": ["Size: 10Feet"],
      "variationList": [
        {
          "asin": "B0FGJ8SP7R",
          "attribute": "Size: 10Feet"
        }
      ],
      "features": [
        "【Universal Fit】 Compatible with most front-load/top-load washers, dishwashers & dehumidifiers (LG/Samsung/Whirlpool, etc.). Four inner diameters of 4/5, 9/10, 1-1/5, and 1-1/2 inches can be cut according to actual size,Confirm your original hose size before purchase!"
      ],
      "overviews": "{\"Brand\":\"DLHMBOQ\",\"Material\":\"high-quality Polypropylene (PP)\",\"Color\":\"Gray\",\"Product Dimensions\":\"8.6\\\"L x 8.2\\\"W\",\"Item Weight\":\"0.39 Pounds\",\"Outside Diameter\":\"1.5 Inches\",\"Item Length\":\"122 Inches\",\"Manufacturer\":\"DLHMBOQ\",\"Set Name\":\"Universal Drain Hose Extension Kit ...",
      "badge": {
        "bestSeller": "N",
        "amazonChoice": "Y",
        "newRelease": "N",
        "ebc": "Y",
        "video": "N"
      }
    },
    "salesTrendPoints": [
      {
        "month": "2025-07",
        "price": 15.99,
        "averagePrice": 15.99,
        "parentUnitSales": 0,
        "childUnitSales": null,
        "parentSalesRevenue": 0,
        "childSalesRevenue": null
      }
    ]
  }
}

See Errors and rate limits for error payloads, request tracing, and rate-limit headers.

Availability: Available

This endpoint is active in the v1 gateway, OpenAPI, and subscription catalog. A successful call consumes 1 billing unit.

POST /v1/amazon/products/sales-trends

The request and response fields below match the current public contract.

Quick call

First create an API key, then store it in a server-side environment variable:

export ECOMMERCE_DATA_API_KEY="your_api_key"

curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/products/sales-trends \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{
  "marketplace": "US",
  "asin": "B08CK5Z5Q1"
}'

Integrate with an AI CLI

Copy for your AI CLI

Paste this task into Codex, Claude Code, Gemini CLI, or another coding agent.

Integrate the "Sales Trends" endpoint from Ecommerce Data API into the current repository. Make the changes directly instead of only returning sample code.

Example request:
{
"marketplace": "US",
"asin": "B08CK5Z5Q1"
}

Need an API key?Create API key

Open this request in Postman

Download the preconfigured collection for this endpoint, then import it into Postman.

Download Postman config

Set the apiKey collection variable after import.Create API key

Node.js example

const response = await fetch(
  'https://ecommercedataapi.com/v1/amazon/products/sales-trends',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
    },
    body: JSON.stringify({
      marketplace: 'US',
      asin: 'B08CK5Z5Q1',
    }),
  }
);

const result = await response.json();

if (!response.ok) {
  throw new Error(`${result.error?.code}: ${result.error?.message}`);
}

console.log(result.data);

Python example

import os
import requests

response = requests.post(
    "https://ecommercedataapi.com/v1/amazon/products/sales-trends",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
    },
    json={
        "marketplace": "US",
        "asin": "B08CK5Z5Q1",
    },
    timeout=30,
)

response.raise_for_status()
print(response.json()["data"])

Request body

Send the fields below directly in the JSON body without an extra wrapper. Undefined fields are rejected.

Field	Type	Required	Description	Example
`marketplace`	String	Yes	Amazon marketplace code. Supported values are listed in the schema.	US
`asin`	String	Yes	Amazon Standard Identification Number.	B08GHW4TBS
`returnFields`	String	No	Optional comma-separated response fields. Omit it to receive the standard payload.	asin,salesTrendPoints

Response structure

Field	Type	Description
`request_id`	String	Unique identifier for this request.
`data`	Object	Endpoint business data.

The fields below are inside data. For array endpoints they describe one array item; for paginated endpoints they describe one record in items[].

Response fields

Field	Type	Description	Example
`asin`	Object	ASIN.	-
`asin.asin`	String	ASIN.	B08GHW4TBS
`asin.asinUrl`	String	ASIN URL.	https://www.amazon.com/dp/B08GHW4TBS
`asin.availableDate`	Integer	Available date. Date or timestamp value.	1.60906E+12
`asin.badge`	Object	Badge.	包括了下面 5 个标识
`asin.badge.bestSeller`	String	Best seller.	Y 或者 N
`asin.badge.amazonChoice`	String	Amazon choice.	Y 或者 N
`asin.badge.newRelease`	String	New release.	Y 或者 N
`asin.badge.ebc`	String	A+ content.	Y 或者 N
`asin.badge.video`	String	Video.	Y 或者 N
`asin.brand`	String	Brand.	mermaker
`asin.brandUrl`	String	Brand URL.	/stores/Mermaker/page/984A6448-1C68-4CCA-AD5A-D574EA2D65D5?ref_=ast_bln
`asin.bsrId`	String	BSR ID.	home-garden
`asin.bsrLabel`	String	BSR label.	Home & Kitchen
`asin.bsrRank`	Integer	BSR rank.	1006
`asin.createdTime`	Integer	Created time. Date or timestamp value.	1.60647E+12
`asin.dimensions`	String	Dimensions.	7 x 6 x 0.6 inches
`asin.firstRatingDate`	Integer	First rating date. Date or timestamp value.	1.60906E+12
`asin.imageUrl`	String	Image URL.	https://images-na.ssl-images-amazon.com/images/I/412616zl5YL .AC_US200.jpg
`asin.lqs`	Integer	Listing quality score.	97
`asin.nodeId`	String	Node ID.	1063280
`asin.nodeIdPath`	String	Node ID path.	1055398:1063252:1063280
`asin.nodeLabelPath`	String	Node label path.	Home & Kitchen:Bedding:Blankets & Throws
`asin.nodeLabelPathLocale`	String	Node label path locale.	家居厨房用品:床上用品:毯子、盖毯
`asin.parent`	String	Parent.	B07V5GB9B5
`asin.price`	Number	Price.	21.99
`asin.questions`	Integer	Questions.	5
`asin.rating`	Number	Rating.	4.8
`asin.ratings`	Integer	Ratings.	29229
`asin.reviews`	Integer	Reviews.	9229
`asin.variantRatings`	Integer	Variant ratings.	12454
`asin.variantReviews`	Integer	Variant reviews.	3211
`asin.sellerId`	String	Seller ID.	A13AJ1GXFINAZ
`asin.sellerName`	String	Seller name.	Mermaker
`asin.fulfillment`	String	Fulfillment.	FBA
`asin.sellers`	Integer	Sellers.	1
`asin.skuList`	Array	Sku list.	["Color: Beige","Size: 47 inches"]
`asin.marketplace`	String	Marketplace.	见表 1.2
`asin.title`	String	Title.	mermaker Burritos Tortilla Blanket 2.0 Double Sided 47 inches for Adult and Kids,Giant Funny Realistic Food Throw Blanket,285 GSM Novelty Soft Flannel Taco Blanket (Yellow Blanket-Double Sided)
`asin.features`	Array	Features.	-
`asin.overviews`	String	Overviews.	-
`asin.updatedTime`	Integer	Updated time. Date or timestamp value.	1.60906E+12
`asin.variationList`	Array	Variation list.	[{"asin":"B07V5GB9B5","attribute":"Beige"},{"asin":"B08H86SSSF","attribute":"Cookie"}]
`asin.variations`	Integer	Variations.	14
`asin.weight`	String	Weight.	15.2 ounces
`asin.zoomImageUrl`	String	Zoom image URL.	https://images-na.ssl-images-amazon.com/images/I/412616zl5YL .AC_US600.jpg
`asin.subcategories`	Object	Subcategories.	-
`asin.subcategories.rank`	Integer	Rank.	1
`asin.subcategories.code`	String	Code.	17874234011
`asin.subcategories.label`	String	Label.	Kids' Throw Blankets
`asin.deliveryPrice`	Number	Delivery price.	4
`asin.primePrice`	Number	Prime price.	42
`asin.coupon`	String	Coupon.	[save $20]
`salesTrendPoints`	Array	Sales trend points.	-
`salesTrendPoints.month`	String	Month.	-
`salesTrendPoints.price`	Number	Price.	-
`salesTrendPoints.averagePrice`	Number	Average price.	-
`salesTrendPoints.parentUnitSales`	Integer	Parent unit sales.	-
`salesTrendPoints.childUnitSales`	Integer	Child unit sales.	-
`salesTrendPoints.parentSalesRevenue`	Number	Parent sales revenue.	-
`salesTrendPoints.childSalesRevenue`	Number	Child sales revenue.	-

Response example

{
  "request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
  "data": {
    "asin": {
      "asin": "B0FGJ8SP7R",
      "asinUrl": "https://www.amazon.com/dp/B0FGJ8SP7R?psc=1",
      "availableDate": 1751385600000,
      "brand": "DLHMBOQ",
      "brandUrl": "/s/ref=bl_dp_s_web_0?ie=UTF8&search-alias=aps&field-keywords=DLHMBOQ",
      "bsrId": "hi",
      "bsrLabel": "Tools & Home Improvement",
      "bsrRank": 6939,
      "subcategories": [
        {
          "rank": 2,
          "code": "2232357011",
          "label": "Dishwasher Replacement Hoses"
        }
      ],
      "createdTime": 1751531618000,
      "dimensions": "8.6\"L x 8.2\"W",
      "firstRatingDate": 1774713600000,
      "imageUrl": "https://m.media-amazon.com/images/I/4193rnBah3L._AC_US200_.jpg",
      "lqs": 100,
      "nodeId": 2232357011,
      "nodeIdPath": "2619525011:3741181:3741201:2232357011",
      "nodeLabelPath": "Appliances:Parts & Accessories:Dishwasher Parts & Accessories:Hoses",
      "nodeLabelPathLocale": null,
      "parent": "B0G62RQZVD",
      "price": 11.99,
      "primePrice": -1,
      "deliveryPrice": -1,
      "coupon": "",
      "questions": null,
      "rating": 4.5,
      "ratings": 556,
      "reviews": 0,
      "variantRatings": null,
      "variantReviews": 41,
      "sellerId": "A3CUUY1JMQCJRJ",
      "sellerName": "DL Boutique",
      "fulfillment": "FBA",
      "sellers": 1,
      "marketplace": "US",
      "title": "10ft Washing Machine Drain Hose Extension Kit - Universal for Washer, Dishwasher & Dehumidifier, 7-Piece Set with U-Bracket, 4 Clamps & Adapter",
      "updatedTime": 1780466868000,
      "variations": 2,
      "weight": "0.39 Pounds",
      "zoomImageUrl": "https://m.media-amazon.com/images/I/4193rnBah3L._AC_US600_.jpg",
      "skuList": ["Size: 10Feet"],
      "variationList": [
        {
          "asin": "B0FGJ8SP7R",
          "attribute": "Size: 10Feet"
        }
      ],
      "features": [
        "【Universal Fit】 Compatible with most front-load/top-load washers, dishwashers & dehumidifiers (LG/Samsung/Whirlpool, etc.). Four inner diameters of 4/5, 9/10, 1-1/5, and 1-1/2 inches can be cut according to actual size,Confirm your original hose size before purchase!"
      ],
      "overviews": "{\"Brand\":\"DLHMBOQ\",\"Material\":\"high-quality Polypropylene (PP)\",\"Color\":\"Gray\",\"Product Dimensions\":\"8.6\\\"L x 8.2\\\"W\",\"Item Weight\":\"0.39 Pounds\",\"Outside Diameter\":\"1.5 Inches\",\"Item Length\":\"122 Inches\",\"Manufacturer\":\"DLHMBOQ\",\"Set Name\":\"Universal Drain Hose Extension Kit ...",
      "badge": {
        "bestSeller": "N",
        "amazonChoice": "Y",
        "newRelease": "N",
        "ebc": "Y",
        "video": "N"
      }
    },
    "salesTrendPoints": [
      {
        "month": "2025-07",
        "price": 15.99,
        "averagePrice": 15.99,
        "parentUnitSales": 0,
        "childUnitSales": null,
        "parentSalesRevenue": 0,
        "childSalesRevenue": null
      }
    ]
  }
}

See Errors and rate limits for error payloads, request tracing, and rate-limit headers.

Sales Trends

API data samples

Quick call

Integrate with an AI CLI

Copy for your AI CLI

Open this request in Postman

Node.js example

Python example

Request body

Response structure

Response fields

Response example

On this page

Sales Trends

API data samples

Quick call

Integrate with an AI CLI

Copy for your AI CLI

Open this request in Postman

Node.js example

Python example

Request body

Response structure

Response fields

Response example

On this page