Amazon Keywords

Amazon Keyword Research

Research keyword demand, growth, competition, conversion, and PPC metrics.

post/v1/amazon/keyword-research

Request

  • Base URL: https://ecommercedataapi.com
  • URL: https://ecommercedataapi.com/v1/amazon/keyword-research
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Request body

departmentsstring[]

Departments.

excludeKeywordsstring

Exclude keywords.

keywordsstring

Keywords used by the query.

marketPeriodstring

Market period. Available values (Table 1.7): N, S1, S2, S3, S4, S5, S6, S7, S8, S9, S10, S11, S12, I, D

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.

maxAraClickRatenumber float

Max ara click rate. Maximum value.

maxAvgPricenumber float

Max avg price. Maximum value.

maxBidnumber float

Max bid. Maximum value.

maxGoodsValuenumber float

Max goods value. 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.

maxRatingnumber float

Max rating. Maximum value.

maxRatingsinteger

Max ratings. Maximum value.

maxSearchMonthCrnumber float

Max search month change rate. Maximum value. Percentage or ratio value as documented.

maxSearchMonthCvinteger

Max search month change value. Maximum value.

maxSearchNearlyCrnumber float

Max search nearly change rate. Maximum value. Percentage or ratio value as documented.

maxSearchNearlyCvinteger

Max search nearly change value. Maximum value.

maxSearchesinteger

Max searches. Maximum value.

maxSearchesCrnumber float

Max searches change rate. Maximum value. Percentage or ratio value as documented.

maxSupplyDemandRationumber float

Max supply demand ratio. Maximum value.

maxWordCountinteger

Max word count. Maximum value.

minAraClickRatenumber float

Min ara click rate. Minimum value.

minAvgPricenumber float

Min avg price. Minimum value.

minBidnumber float

Min bid. Minimum value.

minGoodsValuenumber float

Min goods value. 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.

minRatingnumber float

Min rating. Minimum value.

minRatingsinteger

Min ratings. Minimum value.

minSearchMonthCrnumber float

Min search month change rate. Minimum value. Percentage or ratio value as documented.

minSearchMonthCvinteger

Min search month change value. Minimum value.

minSearchNearlyCrnumber float

Min search nearly change rate. Minimum value. Percentage or ratio value as documented.

minSearchNearlyCvinteger

Min search nearly change value. Minimum value.

minSearchesinteger

Min searches. Minimum value.

minSearchesCrnumber float

Min searches change rate. Minimum value. Percentage or ratio value as documented.

minSupplyDemandRationumber float

Min supply demand ratio. Minimum value.

minWordCountinteger

Min word count. Minimum value.

monthstring

Data month. Use the format documented for this endpoint, usually yyyyMM. Available values (Table 1.1): nearly, yyyyMM

pageinteger

Page number starting at 1.

returnFieldsstring

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

sizeinteger

Number of results per page.

withYearlyGrowthboolean

With yearly growth.

Example request

{
  "departments": [
    "automotive",
    "baby-products"
  ],
  "excludeKeywords": "portable",
  "keywords": "N95",
  "marketPeriod": "Market period",
  "marketplace": "US",
  "maxAraClickRate": 56.4,
  "maxAvgPrice": 30.3,
  "maxBid": 10.6,
  "maxGoodsValue": 41.1,
  "maxProducts": 90,
  "maxPurchaseRate": 10.5,
  "maxPurchases": 500,
  "maxRating": 4.1,
  "maxRatings": 3000,
  "maxSearchMonthCr": 30.1,
  "maxSearchMonthCv": 3000,
  "maxSearchNearlyCr": 20.4,
  "maxSearchNearlyCv": 20000,
  "maxSearches": 300,
  "maxSearchesCr": 50.8,
  "maxSupplyDemandRatio": 10.4,
  "maxWordCount": 3,
  "minAraClickRate": 20.1,
  "minAvgPrice": 20,
  "minBid": 6.2,
  "minGoodsValue": 10.1,
  "minProducts": 10,
  "minPurchaseRate": 3.2,
  "minPurchases": 100,
  "minRating": 3.2,
  "minRatings": 2000,
  "minSearchMonthCr": 5.3,
  "minSearchMonthCv": 1000,
  "minSearchNearlyCr": 10.3,
  "minSearchNearlyCv": 6000,
  "minSearches": 100,
  "minSearchesCr": 10,
  "minSupplyDemandRatio": 5.6,
  "minWordCount": 1,
  "month": "202203",
  "order": {},
  "page": 1,
  "returnFields": "marketplace,keywords,searches",
  "size": 20
}

Response

Amazon Keyword Research response.

request_idstring uuid required
dataunknown required

Changes

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