Googleトレンド
Googleトレンドを取得する公開エンドポイントのパラメータとレスポンスを説明します。
API データの例
このエンドポイントのリクエスト本文とレスポンス全体の構造を確認できます。
{
"marketplace": "US"
}{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"marketplace": "US",
"keyword": "iphone stand",
"link": "https://trends.google.com/trends/explore?hl=zh-CN&date=2020-09-14+2025-09-14&geo=US&q=iphone+stand",
"items": [
{
"time": 1599350400000,
"value": 33
}
]
}
}利用可否:利用可能
このエンドポイントはv1 gateway、OpenAPI、サブスクリプションカタログで利用できます。成功した呼び出しは課金単位を1つ消費します。
POST /v1/amazon/google/trends
APIマッピング
| 項目 | 値 |
|---|---|
| MCP Code | google_trend |
| 元のRESTメソッド | GET |
| 元のRESTパス | /v1/google/trends |
| 元のAPIドキュメント | 公式ドキュメントを開く |
旧パス /v1/amazon/keywords/google-trends は互換性のため残されていますが非推奨です。旧パスへのリクエストには Deprecation: true と正規パスを示す Link ヘッダーが返ります。
クイックリクエスト
まずAPIキーを作成し、サーバー側の環境変数に保存します。
export ECOMMERCE_DATA_API_KEY="your_api_key"curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/google/trends \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{"marketplace":"US"}'AI CLIとの連携
Codex、Claude Code、Cursorにこのページを読み、ECOMMERCE_DATA_API_KEYを使って承認済みのリクエストだけを実行するよう指示できます。キーをプロンプトに貼り付けないでください。
統合例
Node.js
const response = await fetch(
'https://ecommercedataapi.com/v1/amazon/google/trends',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
},
body: JSON.stringify({ marketplace: 'US' }),
}
);
const result = await response.json();
if (!response.ok)
throw new Error(`${result.error?.code}: ${result.error?.message}`);
console.log(result.data);Python
import os
import requests
response = requests.post(
"https://ecommercedataapi.com/v1/amazon/google/trends",
headers={"Content-Type": "application/json", "X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"]},
json={"marketplace": "US"},
timeout=30,
)
response.raise_for_status()
print(response.json()["data"])リクエストボディ
requestなどのラッパーを使わず、フィールドをJSONボディへ直接送信します。
| フィールド | 型 | 必須 | 説明 | 例 |
|---|---|---|---|---|
marketplace | String | いいえ | Amazonマーケットプレイスコード。 | US |
marketplaceを省略した場合、エンドポイントの契約に別の指定がない限りUSが使用されます。
レスポンス構造
{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {}
}request_idは呼び出しを識別します。data内の追加フィールドは現在のエンドポイント契約に従い、マーケットプレイスや対象期間によって異なる場合があります。
エラーと制限
2xx以外の応答ではerror.codeとerror.messageを確認してください。サポートへの問い合わせにはrequest_idを添え、プランのレート制限と課金単位を守って利用してください。
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.
Browse the complete AI Hub