---
title: "Amazon Order Keyword Lookup"
method: POST
path: "/v1/amazon/keyword-order"
tags: ["Amazon Keywords"]
---

# Amazon Order Keyword Lookup

`POST /v1/amazon/keyword-order`

## Request

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

Retrieve the keywords that generate orders for ASINs.

## Request body

- AmazonKeywordsOrderRequest
  - `asins` string[], required: List of Amazon Standard Identification Numbers.
  - `conversionType` string: Conversion type.
  - `date` string, required: Reporting period. With reverseType W, pass the Saturday that ends the week as yyyyMMdd. With reverseType M, pass the month as yyyyMM.
  - `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.
  - `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.6): searchRank, searchRankGrowthValue, searchRankGrowthRate, sumClickRate
  - `page` integer: Page number starting at 1. Only page 1 is available at present: a request for a later page is refused with PAGE_NOT_AVAILABLE and is not billed.
  - `returnFields` string: Optional comma-separated response fields. Omit it to receive the standard payload.
  - `reverseType` string, required: Reverse type.
  - `size` integer: Number of results per page. The endpoint currently returns up to 50 results whatever value is passed.
  - `variation` string: Variation.

## Response `200`

Amazon Order Keyword Lookup 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)