Amazon 商品検索

キーワードまたは ASIN の一覧から Amazon 商品を検索し、商品機会の検証に使えるデータを取得します。

利用可能

この API は v1 gateway、OpenAPI、プランのカタログで利用できます。成功した呼び出しは 1 単位を消費します。

POST /v1/amazon/product/competitor-lookup

API の対応関係

項目	値
MCP Code	`competitor_lookup`
元の REST メソッド	`POST`
元の REST パス	`/v1/product/competitor-lookup`
元のドキュメント	公式ドキュメントを開く

旧パス /v1/amazon/products/search は互換 alias として残っています。旧パスへのリクエストには Deprecation: true と、正規パスを示す Link ヘッダーが返ります。

クイックスタート

API キーを作成し、サーバー側のシークレットとして保存します。

export ECOMMERCE_DATA_API_KEY="your_api_key"
curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/product/competitor-lookup \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{"marketplace":"US","keyword":"wireless charger","match_type":"broad","include_variations":false,"page":1,"size":20}'

JSON 本文は request などで包まず、フィールドを直接指定します。keyword と asins のどちらか一方だけを指定してください。仕様にないフィールドは拒否されます。

リクエストフィールド

フィールド	型	必須	説明	例
`marketplace`	String	いいえ	Amazon マーケットプレイスのコード。	`US`
`keyword`	String	いいえ	検索するキーワード。`asins` とは同時に使いません。	`wireless charger`
`asins`	Array	いいえ	ASIN の一覧。`keyword` とは同時に使いません。	`["B08CK5Z5Q1"]`
`match_type`	String	いいえ	`broad`、`phrase`、`exact` の一致方式。	`broad`
`include_variations`	Boolean	いいえ	商品バリエーションを含めます。	`false`
`page`	Integer	いいえ	1 から始まるページ番号。	`1`
`size`	Integer	いいえ	1 ページの件数。	`20`

レスポンス

{
  "request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
  "data": {
    "pages": 1,
    "page": 1,
    "size": 20,
    "total": 1,
    "items": [
      { "asin": "B08CK5Z5Q1", "title": "Example product", "price": 19.99 }
    ]
  }
}

request_id はリクエストの識別子です。data.items には、取得できる場合、asin、brand、title、imageUrl、price、rating、ratings、bsr、units、revenue、fulfillment、カテゴリーなどが含まれます。全フィールドと型は OpenAPI スキーマで確認してください。任意フィールドが常に存在すると仮定しないでください。

Node.js と Python

const response = await fetch(
  'https://ecommercedataapi.com/v1/amazon/product/competitor-lookup',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
    },
    body: JSON.stringify({
      marketplace: 'US',
      keyword: 'wireless charger',
      match_type: 'broad',
      page: 1,
      size: 20,
    }),
  }
);
const result = await response.json();
if (!response.ok)
  throw new Error(`${result.error?.code}: ${result.error?.message}`);
console.log(result.data);

import os, requests
response = requests.post(
    "https://ecommercedataapi.com/v1/amazon/product/competitor-lookup",
    headers={"X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"]},
    json={"marketplace": "US", "keyword": "wireless charger", "match_type": "broad", "page": 1, "size": 20},
    timeout=30,
)
response.raise_for_status()
print(response.json()["data"])

制限と確認事項

エラー時は error.code と request_id を確認します。429、503、504 では Retry-After に従い、検証・認証エラーはリクエストを修正してから再試行してください。価格、販売数の推定、競合シグナルは調査用データです。在庫、法令遵守、採算に関する判断は別の情報でも検証してください。

エラーと利用制限またはAPI キーを作成。

利用可能

この API は v1 gateway、OpenAPI、プランのカタログで利用できます。成功した呼び出しは 1 単位を消費します。

POST /v1/amazon/product/competitor-lookup

API の対応関係

項目	値
MCP Code	`competitor_lookup`
元の REST メソッド	`POST`
元の REST パス	`/v1/product/competitor-lookup`
元のドキュメント	公式ドキュメントを開く

クイックスタート

API キーを作成し、サーバー側のシークレットとして保存します。

export ECOMMERCE_DATA_API_KEY="your_api_key"
curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/product/competitor-lookup \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{"marketplace":"US","keyword":"wireless charger","match_type":"broad","include_variations":false,"page":1,"size":20}'

リクエストフィールド

フィールド	型	必須	説明	例
`marketplace`	String	いいえ	Amazon マーケットプレイスのコード。	`US`
`keyword`	String	いいえ	検索するキーワード。`asins` とは同時に使いません。	`wireless charger`
`asins`	Array	いいえ	ASIN の一覧。`keyword` とは同時に使いません。	`["B08CK5Z5Q1"]`
`match_type`	String	いいえ	`broad`、`phrase`、`exact` の一致方式。	`broad`
`include_variations`	Boolean	いいえ	商品バリエーションを含めます。	`false`
`page`	Integer	いいえ	1 から始まるページ番号。	`1`
`size`	Integer	いいえ	1 ページの件数。	`20`

レスポンス

{
  "request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
  "data": {
    "pages": 1,
    "page": 1,
    "size": 20,
    "total": 1,
    "items": [
      { "asin": "B08CK5Z5Q1", "title": "Example product", "price": 19.99 }
    ]
  }
}

Node.js と Python

const response = await fetch(
  'https://ecommercedataapi.com/v1/amazon/product/competitor-lookup',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
    },
    body: JSON.stringify({
      marketplace: 'US',
      keyword: 'wireless charger',
      match_type: 'broad',
      page: 1,
      size: 20,
    }),
  }
);
const result = await response.json();
if (!response.ok)
  throw new Error(`${result.error?.code}: ${result.error?.message}`);
console.log(result.data);

import os, requests
response = requests.post(
    "https://ecommercedataapi.com/v1/amazon/product/competitor-lookup",
    headers={"X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"]},
    json={"marketplace": "US", "keyword": "wireless charger", "match_type": "broad", "page": 1, "size": 20},
    timeout=30,
)
response.raise_for_status()
print(response.json()["data"])

制限と確認事項

エラーと利用制限またはAPI キーを作成。

API データの例

API の対応関係

クイックスタート

リクエストフィールド

レスポンス

Node.js と Python

制限と確認事項

このページの内容

Amazon 商品検索

API データの例

API の対応関係

クイックスタート

リクエストフィールド

レスポンス

Node.js と Python

制限と確認事項

このページの内容