Amazon Keywords

Amazon Keyword Expansion

Expand traffic keywords from an ASIN list with market filters.

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

Request body

amazonChoiceboolean

Amazon choice.

asinListstring[] required

List of Amazon Standard Identification Numbers.

excludeKeywordsstring[]

Exclude keywords.

historyDatestring

History date. Date or timestamp value.

includeKeywordsstring[]

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.

maxAdProductsinteger

Max ad products. Maximum value.

maxAvgPricenumber float

Max avg price. Maximum value.

maxBidnumber float

Max bid. Maximum value.

maxCompetitorsinteger

Max competitors. Maximum value.

maxConversionRatenumber float

Max conversion rate. Maximum value. Percentage or ratio value as documented.

maxMonopolyClickRatenumber float

Max monopoly click rate. Maximum value.

maxProductsinteger

Max products. Maximum value.

maxPurchaseRatenumber float

Max purchase rate. Maximum value. Percentage or ratio value as documented.

maxPurchasesinteger

Max purchases. Maximum value.

maxSPRinteger

Max SPR. Maximum value.

maxSearchRankinteger

Max search rank. Maximum value.

maxSearchesinteger

Max searches. Maximum value.

maxSupplyDemandRationumber float

Max supply demand ratio. Maximum value.

maxTitleDensityinteger

Max title density. Maximum value.

maxTrafficPercentagenumber float

Max traffic percentage. Maximum value. Percentage or ratio value as documented.

maxWordCountinteger

Max word count. Maximum value.

minAdProductsinteger

Min ad products. Minimum value.

minAvgPricenumber float

Min avg price. Minimum value.

minBidnumber float

Min bid. Minimum value.

minCompetitorsinteger

Min competitors. Minimum value.

minConversionRatenumber float

Min conversion rate. Minimum value. Percentage or ratio value as documented.

minMonopolyClickRatenumber float

Min monopoly click rate. Minimum value.

minProductsinteger

Min products. Minimum value.

minPurchaseRatenumber float

Min purchase rate. Minimum value. Percentage or ratio value as documented.

minPurchasesinteger

Min purchases. Minimum value.

minSPRinteger

Min SPR. Minimum value.

minSearchRankinteger

Min search rank. Minimum value.

minSearchesinteger

Min searches. Minimum value.

minSupplyDemandRationumber float

Min supply demand ratio. Minimum value.

minTitleDensityinteger

Min title density. Minimum value.

minTrafficPercentagenumber float

Min traffic percentage. Minimum value. Percentage or ratio value as documented.

minWordCountinteger

Min word count. Minimum value.

pageinteger

Page number starting at 1.

queryTypeinteger required

Query type. See the documented default in the example column.

returnFieldsstring

Optional comma-separated response fields. Omit it to receive the standard payload.

sizeinteger

Number of results per page.

Example request

{
  "amazonChoice": true,
  "asinList": [
    "B07Z82895W"
  ],
  "excludeKeywords": [
    "phone stand"
  ],
  "historyDate": "202201",
  "includeKeywords": [
    "phone stand"
  ],
  "marketplace": "US",
  "maxAdProducts": 345,
  "maxAvgPrice": 30.3,
  "maxBid": 23.1,
  "maxCompetitors": 23,
  "maxConversionRate": 1.4,
  "maxMonopolyClickRate": 53.1,
  "maxProducts": 90,
  "maxPurchaseRate": 43,
  "maxPurchases": 34,
  "maxSPR": 16,
  "maxSearchRank": 3223,
  "maxSearches": 300,
  "maxSupplyDemandRatio": 45.2,
  "maxTitleDensity": 23,
  "maxTrafficPercentage": 23,
  "maxWordCount": 4,
  "minAdProducts": 123,
  "minAvgPrice": 20,
  "minBid": 10.2,
  "minCompetitors": 4,
  "minConversionRate": 0.23,
  "minMonopolyClickRate": 23.4,
  "minProducts": 10,
  "minPurchaseRate": 3,
  "minPurchases": 6,
  "minSPR": 2,
  "minSearchRank": 33,
  "minSearches": 100,
  "minSupplyDemandRatio": 11.2,
  "minTitleDensity": 2,
  "minTrafficPercentage": 45,
  "minWordCount": 2,
  "order": {},
  "page": 1,
  "queryType": 2,
  "returnFields": "keyword,keywordCn,searches",
  "size": 50
}

Response

Amazon Keyword Expansion response.

request_idstring uuid required
dataunknown required

Changes

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