---
title: "Amazon Keyword Research"
method: POST
path: "/v1/amazon/keyword-research"
tags: ["Amazon Keywords"]
---

# Amazon Keyword Research

`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

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

## Request body

- AmazonKeywordsResearchRequest
  - `departments` string[]: Departments.
  - `excludeKeywords` string: Exclude keywords.
  - `keywords` string: Keywords used by the query.
  - `marketPeriod` string: 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.
  - `maxAraClickRate` number, float: Max ara click rate. Maximum value.
  - `maxAvgPrice` number, float: Max avg price. Maximum value.
  - `maxBid` number, float: Max bid. Maximum value.
  - `maxGoodsValue` number, float: Max goods value. 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.
  - `maxRating` number, float: Max rating. Maximum value.
  - `maxRatings` integer: Max ratings. Maximum value.
  - `maxSearchMonthCr` number, float: Max search month change rate. Maximum value. Percentage or ratio value as documented.
  - `maxSearchMonthCv` integer: Max search month change value. Maximum value.
  - `maxSearchNearlyCr` number, float: Max search nearly change rate. Maximum value. Percentage or ratio value as documented.
  - `maxSearchNearlyCv` integer: Max search nearly change value. Maximum value.
  - `maxSearches` integer: Max searches. Maximum value.
  - `maxSearchesCr` number, float: Max searches change rate. Maximum value. Percentage or ratio value as documented.
  - `maxSupplyDemandRatio` number, float: Max supply demand ratio. Maximum value.
  - `maxWordCount` integer: Max word count. Maximum value.
  - `minAraClickRate` number, float: Min ara click rate. Minimum value.
  - `minAvgPrice` number, float: Min avg price. Minimum value.
  - `minBid` number, float: Min bid. Minimum value.
  - `minGoodsValue` number, float: Min goods value. 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.
  - `minRating` number, float: Min rating. Minimum value.
  - `minRatings` integer: Min ratings. Minimum value.
  - `minSearchMonthCr` number, float: Min search month change rate. Minimum value. Percentage or ratio value as documented.
  - `minSearchMonthCv` integer: Min search month change value. Minimum value.
  - `minSearchNearlyCr` number, float: Min search nearly change rate. Minimum value. Percentage or ratio value as documented.
  - `minSearchNearlyCv` integer: Min search nearly change value. Minimum value.
  - `minSearches` integer: Min searches. Minimum value.
  - `minSearchesCr` number, float: Min searches change rate. Minimum value. Percentage or ratio value as documented.
  - `minSupplyDemandRatio` number, float: Min supply demand ratio. Minimum value.
  - `minWordCount` integer: Min word count. Minimum value.
  - `month` string: Data month. Use the format documented for this endpoint, usually yyyyMM. Available values (Table 1.1): nearly, yyyyMM
  - `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 1.8): searches, keywordsIsHide, searches_growth, yearly_growth_rate, growth_rate_trend_min, monopoly_click_rate, goods_value
  - `page` integer: Page number starting at 1.
  - `returnFields` string: Optional comma-separated response fields. Omit it to receive the standard payload.
  - `size` integer: Number of results per page.
  - `withYearlyGrowth` boolean: With yearly growth.

## Response `200`

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