Amazon API

Amazon APIを使用すると、商品を検索し、ASINで詳細な商品情報を取得できます。両方のエンドポイントは、マルチリージョンターゲティング、通貨のローカライゼーション、デバイスエミュレーションをサポートしています。

エンドポイント

エンドポイント	説明
`POST /api/v1/amazon/search`	並べ替え、ページネーション、カテゴリフィルターを使用してAmazon商品を検索します
`POST /api/v1/amazon/product`	ASINで詳細な商品情報を取得します

認証

ヘッダー	値	必須
`Authorization`	`Bearer YOUR_API_KEY`	はい
`Content-Type`	`application/json`	はい

商品検索

Bash

POST https://api.scavio.dev/api/v1/amazon/search

Amazon商品を検索し、価格、評価、商品詳細を含む構造化された結果を取得します。

リクエストボディ

パラメータ	タイプ	デフォルト	説明
`query`	`string`	--	必須。検索クエリ（1〜500文字）
`domain`	`string`	`com`	Amazonドメインのサフィックス（例：`com`、`co.uk`、 `de`、`fr`、`co.jp`）
`sort_by`	`string`	--	並び順。次のいずれか：`most_recent`、 `price_low_to_high`、`price_high_to_low`、 `featured`、`average_review`、 `bestsellers`
`start_page`	`integer`	`1`	開始ページ番号（1から始まる）
`pages`	`integer`	`1`	返すページ数
`category_id`	`string`	--	結果を絞り込むためのAmazonカテゴリ/部門ID
`merchant_id`	`string`	--	特定のAmazon出品者でフィルター
`country`	`string`	--	ローカライズのための国コード
`language`	`string`	--	結果の言語コード
`currency`	`string`	--	ISO 4217通貨コード（例：`USD`、`EUR`、 `GBP`）
`device`	`string`	`desktop`	デバイスタイプ。次のいずれか：`desktop`、`mobile`、 `tablet`
`zip_code`	`string`	--	ローカライズされた価格と在庫状況のための郵便番号
`autoselect_variant`	`boolean`	--	デフォルトの商品バリアントを自動選択

例

curl -X POST 'https://api.scavio.dev/api/v1/amazon/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "average_review",
    "domain": "com",
    "pages": 1
  }'

レスポンス例

JSON

{
  "data": {
    "page": 1,
    "products": [
      {
        "asin": "B09XS7JWHH",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/dp/B09XS7JWHH",
        "url_image": "https://m.media-amazon.com/images/I/...",
        "price": 278.0,
        "price_strikethrough": 399.99,
        "currency": "USD",
        "rating": 4.6,
        "reviews_count": 12450,
        "is_prime": true,
        "best_seller": false,
        "is_sponsored": false,
        "is_amazons_choice": false,
        "organic_position": 1,
        "sponsored_position": null,
        "sales_volume": "1K+ bought in past month",
        "shipping_information": "FREE delivery Mon, Apr 13",
        "manufacturer": "",
        "variations": []
      }
    ],
    "html": ""
  },
  "response_time": 1850,
  "credits_used": 1,
  "credits_remaining": 999
}

商品詳細

Bash

POST https://api.scavio.dev/api/v1/amazon/product

特定のAmazon商品の詳細情報をASINで取得します。価格、説明、仕様、画像、評価、出品者情報を返します。

リクエストボディ

パラメータ	タイプ	デフォルト	説明
`query`	`string`	--	必須。Amazon ASIN（例： `B09XS7JWHH`）
`domain`	`string`	`com`	Amazonドメインのサフィックス（例：`com`、`co.uk`、 `de`）
`country`	`string`	--	ローカライズのための国コード
`language`	`string`	--	結果の言語コード
`currency`	`string`	--	ISO 4217通貨コード（例：`USD`、`EUR`）
`device`	`string`	`desktop`	デバイスタイプ。次のいずれか：`desktop`、`mobile`、 `tablet`
`zip_code`	`string`	--	ローカライズされた価格のための郵便番号
`autoselect_variant`	`boolean`	--	デフォルトの商品バリアントを自動選択

例

curl -X POST 'https://api.scavio.dev/api/v1/amazon/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"query": "B09XS7JWHH"}'

レスポンス例

JSON

{
  "data": {
    "asin": "B09XS7JWHH",
    "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
    "brand": "Sony",
    "url": "https://www.amazon.com/dp/B09XS7JWHH",
    "price": 278.0,
    "price_strikethrough": 399.99,
    "highest_price": 399.99,
    "currency": "USD",
    "rating": 4.6,
    "reviews_count": 12450,
    "description": "Industry-leading noise cancellation with Auto NC Optimizer...",
    "bullet_points": "NOISE CANCELLATION: ...
LONG BATTERY LIFE: Up to 30 hours...",
    "images": [
      "https://m.media-amazon.com/images/I/..."
    ],
    "category": "Electronics",
    "stock": "In Stock",
    "is_prime": true,
    "buybox": [
      {
        "condition": "Buy new:",
        "price": 278.0,
        "seller_name": "Amazon.com",
        "stock": "In Stock"
      }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2140,
  "credits_used": 1,
  "credits_remaining": 998
}

対応ドメイン

domainパラメータを使用して、特定のAmazonマーケットプレイスをターゲットにします：

ドメイン	マーケットプレイス
`com`	アメリカ合衆国
`co.uk`	イギリス
`de`	ドイツ
`fr`	フランス
`co.jp`	日本
`ca`	カナダ
`it`	イタリア
`es`	スペイン
`in`	インド
`com.au`	オーストラリア
`com.br`	ブラジル
`com.mx`	メキシコ

レスポンス形式

両方のエンドポイントは一貫したレスポンスラッパーを返します：

フィールド	タイプ	説明
`data`	`object \| null`	レスポンスのペイロード。リクエストが上流で失敗した場合は`null`。検索は`{page, products, html}`を返し、商品は直接商品オブジェクトを返します。
`response_time`	`number`	サーバー側の応答時間（ミリ秒）
`credits_used`	`number`	消費されたクレジット数
`credits_remaining`	`number`	現在の請求期間に残っているクレジット

エラーレスポンス

ステータス	説明
`401`	認証されていません -- APIキーがないか無効です
`429`	プランのレートまたは使用制限を超えました
`502`	上流エラー -- 少し待ってから再試行してください
`503`	上流が利用不可 -- 後で再試行してください

完全なエラーリファレンスと再試行のベストプラクティスについては、エラーを参照してください。

Amazon API

エンドポイント

エンドポイント	説明
`POST /api/v1/amazon/search`	並べ替え、ページネーション、カテゴリフィルターを使用してAmazon商品を検索します
`POST /api/v1/amazon/product`	ASINで詳細な商品情報を取得します

認証

ヘッダー	値	必須
`Authorization`	`Bearer YOUR_API_KEY`	はい
`Content-Type`	`application/json`	はい

商品検索

Bash

POST https://api.scavio.dev/api/v1/amazon/search

Amazon商品を検索し、価格、評価、商品詳細を含む構造化された結果を取得します。

リクエストボディ

パラメータ	タイプ	デフォルト	説明
`query`	`string`	--	必須。検索クエリ（1〜500文字）
`domain`	`string`	`com`	Amazonドメインのサフィックス（例：`com`、`co.uk`、 `de`、`fr`、`co.jp`）
`sort_by`	`string`	--	並び順。次のいずれか：`most_recent`、 `price_low_to_high`、`price_high_to_low`、 `featured`、`average_review`、 `bestsellers`
`start_page`	`integer`	`1`	開始ページ番号（1から始まる）
`pages`	`integer`	`1`	返すページ数
`category_id`	`string`	--	結果を絞り込むためのAmazonカテゴリ/部門ID
`merchant_id`	`string`	--	特定のAmazon出品者でフィルター
`country`	`string`	--	ローカライズのための国コード
`language`	`string`	--	結果の言語コード
`currency`	`string`	--	ISO 4217通貨コード（例：`USD`、`EUR`、 `GBP`）
`device`	`string`	`desktop`	デバイスタイプ。次のいずれか：`desktop`、`mobile`、 `tablet`
`zip_code`	`string`	--	ローカライズされた価格と在庫状況のための郵便番号
`autoselect_variant`	`boolean`	--	デフォルトの商品バリアントを自動選択

例

curl -X POST 'https://api.scavio.dev/api/v1/amazon/search' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "wireless headphones",
    "sort_by": "average_review",
    "domain": "com",
    "pages": 1
  }'

レスポンス例

JSON

{
  "data": {
    "page": 1,
    "products": [
      {
        "asin": "B09XS7JWHH",
        "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
        "url": "/dp/B09XS7JWHH",
        "url_image": "https://m.media-amazon.com/images/I/...",
        "price": 278.0,
        "price_strikethrough": 399.99,
        "currency": "USD",
        "rating": 4.6,
        "reviews_count": 12450,
        "is_prime": true,
        "best_seller": false,
        "is_sponsored": false,
        "is_amazons_choice": false,
        "organic_position": 1,
        "sponsored_position": null,
        "sales_volume": "1K+ bought in past month",
        "shipping_information": "FREE delivery Mon, Apr 13",
        "manufacturer": "",
        "variations": []
      }
    ],
    "html": ""
  },
  "response_time": 1850,
  "credits_used": 1,
  "credits_remaining": 999
}

商品詳細

Bash

POST https://api.scavio.dev/api/v1/amazon/product

特定のAmazon商品の詳細情報をASINで取得します。価格、説明、仕様、画像、評価、出品者情報を返します。

リクエストボディ

パラメータ	タイプ	デフォルト	説明
`query`	`string`	--	必須。Amazon ASIN（例： `B09XS7JWHH`）
`domain`	`string`	`com`	Amazonドメインのサフィックス（例：`com`、`co.uk`、 `de`）
`country`	`string`	--	ローカライズのための国コード
`language`	`string`	--	結果の言語コード
`currency`	`string`	--	ISO 4217通貨コード（例：`USD`、`EUR`）
`device`	`string`	`desktop`	デバイスタイプ。次のいずれか：`desktop`、`mobile`、 `tablet`
`zip_code`	`string`	--	ローカライズされた価格のための郵便番号
`autoselect_variant`	`boolean`	--	デフォルトの商品バリアントを自動選択

例

curl -X POST 'https://api.scavio.dev/api/v1/amazon/product' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"query": "B09XS7JWHH"}'

レスポンス例

JSON

{
  "data": {
    "asin": "B09XS7JWHH",
    "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
    "brand": "Sony",
    "url": "https://www.amazon.com/dp/B09XS7JWHH",
    "price": 278.0,
    "price_strikethrough": 399.99,
    "highest_price": 399.99,
    "currency": "USD",
    "rating": 4.6,
    "reviews_count": 12450,
    "description": "Industry-leading noise cancellation with Auto NC Optimizer...",
    "bullet_points": "NOISE CANCELLATION: ...
LONG BATTERY LIFE: Up to 30 hours...",
    "images": [
      "https://m.media-amazon.com/images/I/..."
    ],
    "category": "Electronics",
    "stock": "In Stock",
    "is_prime": true,
    "buybox": [
      {
        "condition": "Buy new:",
        "price": 278.0,
        "seller_name": "Amazon.com",
        "stock": "In Stock"
      }
    ],
    "html": "",
    "screenshot": ""
  },
  "response_time": 2140,
  "credits_used": 1,
  "credits_remaining": 998
}

対応ドメイン

domainパラメータを使用して、特定のAmazonマーケットプレイスをターゲットにします：

ドメイン	マーケットプレイス
`com`	アメリカ合衆国
`co.uk`	イギリス
`de`	ドイツ
`fr`	フランス
`co.jp`	日本
`ca`	カナダ
`it`	イタリア
`es`	スペイン
`in`	インド
`com.au`	オーストラリア
`com.br`	ブラジル
`com.mx`	メキシコ

レスポンス形式

両方のエンドポイントは一貫したレスポンスラッパーを返します：

フィールド	タイプ	説明
`data`	`object \| null`	レスポンスのペイロード。リクエストが上流で失敗した場合は`null`。検索は`{page, products, html}`を返し、商品は直接商品オブジェクトを返します。
`response_time`	`number`	サーバー側の応答時間（ミリ秒）
`credits_used`	`number`	消費されたクレジット数
`credits_remaining`	`number`	現在の請求期間に残っているクレジット

エラーレスポンス

ステータス	説明
`401`	認証されていません -- APIキーがないか無効です
`429`	プランのレートまたは使用制限を超えました
`502`	上流エラー -- 少し待ってから再試行してください
`503`	上流が利用不可 -- 後で再試行してください

完全なエラーリファレンスと再試行のベストプラクティスについては、エラーを参照してください。

Amazon API

エンドポイント

認証

商品検索

リクエストボディ

例

レスポンス例

商品詳細

リクエストボディ

例

レスポンス例

対応ドメイン

レスポンス形式

エラーレスポンス

関連情報

Amazon API

エンドポイント

認証

商品検索

リクエストボディ

例

レスポンス例

商品詳細

リクエストボディ

例

レスポンス例

対応ドメイン

レスポンス形式

エラーレスポンス

関連情報