---
title: "Amazon Keyword Expansion"
method: POST
path: "/v1/amazon/traffic/extend"
tags: ["Amazon Keywords"]
---

# Amazon Keyword Expansion

`POST /v1/amazon/traffic/extend`

## Request

- Base URL: `https://ecommercedataapi.com`
- URL: `https://ecommercedataapi.com/v1/amazon/traffic/extend`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Expand traffic keywords from an ASIN list with market filters.

## Request body

- AmazonKeywordsExpandRequest
  - `amazonChoice` boolean: Amazon choice.
  - `asinList` string[], required: List of Amazon Standard Identification Numbers.
  - `excludeKeywords` string[]: Exclude keywords.
  - `historyDate` string: History date. Date or timestamp value.
  - `includeKeywords` string[]: Include keywords.
  - `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.
  - `maxAdProducts` integer: Max ad products. Maximum value.
  - `maxAvgPrice` number, float: Max avg price. Maximum value.
  - `maxBid` number, float: Max bid. Maximum value.
  - `maxCompetitors` integer: Max competitors. Maximum value.
  - `maxConversionRate` number, float: Max conversion rate. Maximum value. Percentage or ratio value as documented.
  - `maxMonopolyClickRate` number, float: Max monopoly click rate. Maximum value.
  - `maxProducts` integer: Max products. Maximum value.
  - `maxPurchaseRate` number, float: Max purchase rate. Maximum value. Percentage or ratio value as documented.
  - `maxPurchases` integer: Max purchases. Maximum value.
  - `maxSPR` integer: Max SPR. Maximum value.
  - `maxSearchRank` integer: Max search rank. Maximum value.
  - `maxSearches` integer: Max searches. Maximum value.
  - `maxSupplyDemandRatio` number, float: Max supply demand ratio. Maximum value.
  - `maxTitleDensity` integer: Max title density. Maximum value.
  - `maxTrafficPercentage` number, float: Max traffic percentage. Maximum value. Percentage or ratio value as documented.
  - `maxWordCount` integer: Max word count. Maximum value.
  - `minAdProducts` integer: Min ad products. Minimum value.
  - `minAvgPrice` number, float: Min avg price. Minimum value.
  - `minBid` number, float: Min bid. Minimum value.
  - `minCompetitors` integer: Min competitors. Minimum value.
  - `minConversionRate` number, float: Min conversion rate. Minimum value. Percentage or ratio value as documented.
  - `minMonopolyClickRate` number, float: Min monopoly click rate. Minimum value.
  - `minProducts` integer: Min products. Minimum value.
  - `minPurchaseRate` number, float: Min purchase rate. Minimum value. Percentage or ratio value as documented.
  - `minPurchases` integer: Min purchases. Minimum value.
  - `minSPR` integer: Min SPR. Minimum value.
  - `minSearchRank` integer: Min search rank. Minimum value.
  - `minSearches` integer: Min searches. Minimum value.
  - `minSupplyDemandRatio` number, float: Min supply demand ratio. Minimum value.
  - `minTitleDensity` integer: Min title density. Minimum value.
  - `minTrafficPercentage` number, float: Min traffic percentage. Minimum value. Percentage or ratio value as documented.
  - `minWordCount` integer: Min word count. Minimum value.
  - `order` object: Sort definition.
    - `desc` boolean: Use true for descending order or false for ascending order.
    - `field` string: Field used to sort the results. Available values (Table 2.5): trafficPercentage, relationAsin, searchesRank, searches, purchases, purchaseRate, spr, titleDensity, products, supplyDemandRatio, adProduct, monopolyClickRate, bid
  - `page` integer: Page number starting at 1.
  - `queryType` integer, required: Query type. See the documented default in the example column.
  - `returnFields` string: Optional comma-separated response fields. Omit it to receive the standard payload.
  - `size` integer: Number of results per page.

## Response `200`

Amazon Keyword Expansion 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)