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

# Amazon Keyword Conversion

`POST /v1/amazon/keyword/conversion`

## Request

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

Retrieve keyword conversion metrics for an Amazon keyword.

## Request body

- AmazonKeywordsConversionRequest
  - `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.
  - `keyword` string, required: Keyword used by the query.
  - `timeType` string: Time type. Date or timestamp value.
  - `minSearches` integer: Min searches. Minimum value.
  - `maxSearches` integer: Max searches. Maximum value.
  - `minClicks` integer: Min clicks. Minimum value.
  - `maxClicks` integer: Max clicks. Maximum value.
  - `minPurchases` integer: Min purchases. Minimum value.
  - `maxPurchases` integer: Max purchases. Maximum value.
  - `minSearchConvRate` number: Min search conv rate. Minimum value. Percentage or ratio value as documented.
  - `maxSearchConvRate` number: Max search conv rate. Maximum value. Percentage or ratio value as documented.
  - `minClickConvRate` number: Min click conv rate. Minimum value. Percentage or ratio value as documented.
  - `maxClickConvRate` number: Max click conv rate. Maximum value. Percentage or ratio value as documented.
  - `minPpc` number: Min PPC. Minimum value.
  - `maxPpc` number: Max PPC. Maximum value.
  - `minCpa` number: Min cpa. Minimum value.
  - `maxCpa` number: Max cpa. Maximum value.
  - `minProductPrice` number: Min product price. Minimum value.
  - `maxProductPrice` number: Max product price. Maximum value.
  - `minAcos` number: Min acos. Minimum value.
  - `maxAcos` number: Max acos. Maximum value.
  - `minClickingRate` number: Min clicking rate. Minimum value. Percentage or ratio value as documented.
  - `maxClickingRate` number: Max clicking rate. Maximum value. Percentage or ratio value as documented.
  - `minConversionRate` number: Min conversion rate. Minimum value. Percentage or ratio value as documented.
  - `maxConversionRate` number: Max conversion rate. Maximum value. Percentage or ratio value as documented.
  - `minPhraseCount` integer: Min phrase count. Minimum value.
  - `maxPhraseCount` integer: Max phrase count. Maximum value.
  - `minBudget` number: Min budget. Minimum value.
  - `maxBudget` number: Max budget. Maximum value.
  - `matchType` integer: Match type.
  - `includeKeywords` string[]: Include keywords.
  - `excludeKeywords` string[]: Exclude keywords.
  - `customAvgProductPrice` number: Custom avg product price.

## Response `200`

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