Amazon キーワード調査

Amazon の検索数、クリック、購入、成長率、競合指標を分析し、キーワードの機会を見つけます。

利用可能

成功した呼び出しは 1 単位を消費します。フィールド名と JSON 構造は API 契約の一部です。

POST /v1/amazon/keyword-research

対応関係

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

旧パス /v1/amazon/keywords/research は移行期間中の互換 alias です。旧パスには Deprecation: true と正規パスへの Link ヘッダーが返ります。

実行例

API キーを作成し、サーバー側だけで使用してください。

export ECOMMERCE_DATA_API_KEY="your_api_key"
curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/keyword-research \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{"keywords":"N95","marketplace":"US","month":"202507","page":1,"size":20,"order":{"field":"searches","desc":true}}'

リクエスト本文

JSON フィールドは request などで包まず直接指定します。marketplace は必須で、その他のフィルターは任意です。page と size で応答量を制御し、標準の結果が不要な場合は returnFields で返すフィールドを絞ります。

フィールド	型	説明	例
`marketplace`	String	Amazon マーケットプレイスのコード。	`US`
`keywords`	String	調査する検索語。	`N95`
`departments`	Array	対象カテゴリーまたは部門。	`["automotive"]`
`excludeKeywords`	String	除外する検索語。	`portable`
`marketPeriod`	String	指定する市場期間。	`monthly`
`month`	String	データの月。通常は `yyyyMM` 形式。	`202507`
`minSearches`, `maxSearches`	Integer	検索数の範囲。	`100`, `300`
`minPurchases`, `maxPurchases`	Integer	購入数の範囲。	`100`, `500`
`minProducts`, `maxProducts`	Integer	商品数の範囲。	`10`, `90`
`minRatings`, `maxRatings`	Integer	評価数の範囲。	`2000`, `3000`
`minRating`, `maxRating`	Number	評価スコアの範囲。	`3.2`, `4.8`
`minAvgPrice`, `maxAvgPrice`	Number	平均価格の範囲。	`20`, `30.3`
`minWordCount`, `maxWordCount`	Integer	検索語の単語数。	`1`, `3`
`minSupplyDemandRatio`, `maxSupplyDemandRatio`	Number	需給比の範囲。	`5.6`, `10.4`
`withYearlyGrowth`	Boolean	前年比成長率を含めるか。	`false`
`order`	Object	結果の並び順。	`{}`
`order.field`	String	並べ替えに使うフィールド。例は `searches`。	`searches`
`order.desc`	Boolean	`true` は降順、`false` は昇順。	`true`
`returnFields`	String	返すフィールドをカンマ区切りで指定。	`marketplace,keywords,searches`
`page`	Integer	1 から始まるページ番号。	`1`
`size`	Integer	1 ページの件数。	`20`

クリック、入札、商品価値、成長率と、それぞれの最小値・最大値のフィルターも OpenAPI スキーマで利用できます。定義されたフィールド名を使用してください。未知のフィールドは拒否されます。

レスポンス

{
  "request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
  "data": {
    "pages": 1,
    "page": 1,
    "size": 20,
    "total": 1,
    "items": [
      {
        "marketplace": "US",
        "keywords": "polaroid cameras",
        "searches": 141356,
        "clicks": 100000,
        "purchases": 4029,
        "growth": -25.48,
        "purchaseRate": 0.0285,
        "products": 173,
        "supplyDemandRatio": 817.09
      }
    ]
  }
}

request_id は問い合わせと調査に使います。各 item には取得できる場合、marketplace、keywords、searches、clicks、impressions、purchases、growth、purchaseRate、products、supplyDemandRatio、検索部門などが含まれます。

Node.js と Python

const response = await fetch(
  'https://ecommercedataapi.com/v1/amazon/keyword-research',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
    },
    body: JSON.stringify({
      keywords: 'N95',
      marketplace: 'US',
      month: '202507',
      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.items);

import os, requests
response = requests.post(
    "https://ecommercedataapi.com/v1/amazon/keyword-research",
    headers={"Content-Type": "application/json", "X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"]},
    json={"keywords": "N95", "marketplace": "US", "month": "202507", "page": 1, "size": 20},
    timeout=30,
)
response.raise_for_status()
print(response.json()["data"]["items"])

解釈と制限

検索数、購入数、成長率、需給比は、指定した時点とマーケットプレイスにおける調査用の指標です。売上を保証するものではなく、競合、コスト、法令遵守、利益率の確認に代わるものでもありません。429、503、504 では Retry-After に従い、検証エラーは本文を修正してから再試行してください。

エラーと利用制限、OpenAPI、API キーを作成を参照してください。

AI skills and agents that use this API

Start from a seller task, see how these capabilities use the current API, and review source and permissions before installation.

Ecommerce Data API スキル

対応するAIコーディングエージェントから、Amazonの最新データAPIを検索・確認・呼び出します。

Amazonキーワード調査

Amazonキーワード調査を使い、データを確認しながら人の承認を経て判断します。

Amazonリスティング最適化

Amazonリスティング最適化を使い、データを確認しながら人の承認を経て判断します。

Amazonプロダクトマネージャー

Amazonプロダクトマネージャーを使い、データを確認しながら人の承認を経て判断します。

Browse the complete AI Hub