---
title: "Amazon Product Search"
method: POST
path: "/v1/amazon/product/competitor-lookup"
tags: ["Amazon Products"]
---

# Amazon Product Search

`POST /v1/amazon/product/competitor-lookup`

## Request

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

Search products by keyword or exact ASIN list.

## Request body

- union
  - object
    - `marketplace` 'US' | 'UK' | 'DE' | 'FR' | 'IT' | 'ES' | 'MX' | 'CA' | 'AU' | 'JP' | 'IN' | 'AE' | 'BR': Amazon marketplace code. Supported values are listed in the schema.
    - `keyword` string, required: Keyword used by the query.
    - `asins` string[]: List of Amazon Standard Identification Numbers.
    - `match_type` 'broad' | 'phrase' | 'exact': Keyword match mode: phrase matches the whole phrase, broad matches any of its words, exact matches the title. Defaults to phrase.
    - `include_variations` boolean: Include variations. See the documented default in the example column.
    - `page` integer: Page number starting at 1.
    - `size` integer: Number of results per page.
  - object
    - `marketplace` 'US' | 'UK' | 'DE' | 'FR' | 'IT' | 'ES' | 'MX' | 'CA' | 'AU' | 'JP' | 'IN' | 'AE' | 'BR': Amazon marketplace code. Supported values are listed in the schema.
    - `keyword` string: Keyword used by the query.
    - `asins` string[], required: List of Amazon Standard Identification Numbers.
    - `match_type` 'broad' | 'phrase' | 'exact': Keyword match mode: phrase matches the whole phrase, broad matches any of its words, exact matches the title. Defaults to phrase.
    - `include_variations` boolean: Include variations. See the documented default in the example column.
    - `page` integer: Page number starting at 1.
    - `size` integer: Number of results per page.

## Response `200`

Amazon Product Search 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)