クイックスタート
APIキーを作成し、Ecommerce Data APIへ最初のリクエストを送信します。
クイックスタート
Codex、Claude Code、Cursorをご利用の場合は、CLIとスキルのインストールガイドをご覧ください。サーバーやスクリプトから連携する場合は、以下の手順で開始できます。
1. アカウントを作成する
Ecommerce Data APIに登録またはログインし、設定 > APIキーを開きます。APIキー作成画面に直接アクセスすることもできます。
2. APIキーを設定する
アプリケーション用のキーを作成し、サーバー側の環境変数に保存してください。ブラウザで実行するコードや公開リポジトリには含めないでください。
export ECOMMERCE_DATA_API_KEY='ecom_live_your_key'ecom_live_your_keyは説明用の値です。実際に作成したキーに置き換えてください。
3. リクエストを送信する
curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/asin/detail \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"asin": "B08CK5Z5Q1"
}'成功したレスポンスには、サービスが生成するrequest_idとエンドポイント固有のデータが含まれます。以下は構造を説明するための例であり、現在の商品データではありません。実際のレスポンスフィールドはASIN詳細のリファレンスで確認してください。
{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"asin": "B08CK5Z5Q1",
"marketplace": "US",
"title": "Example product",
"price": 19.99,
"rating": 4.6,
"ratings": 1284
}
}request_idを保存しておくと、使用状況画面での調査やサポートへの問い合わせに利用できます。
4. サービスの状態を確認する
ヘルスチェックのエンドポイントには認証が不要です。
curl https://ecommercedataapi.com/v1/health対応マーケットプレイス
US, UK, DE, FR, IT, ES, MX, CA, AU, JP, IN, AE, BR
マーケットプレイスとASINは大文字に正規化されます。各エンドポイントの説明に別の指定がない場合、marketplaceを省略するとUSが使用されます。