Amazon検索API
POST
APIの稼働状況
- 24時間の稼働状況
- 正常
- 24時間の平均応答時間
- —
- 良好／正常
- 利用可能
- 制限あり
- ほぼ停止
正常
過去24時間
過去30日間
選択したAmazonマーケットプレイスをキーワードで検索します。各商品のASIN、ブランド、価格と参考価格、評価数、在庫状況、販売者を取得できます。ストアはdomain（amazon.co.ukなど）で指定し、価格はそのストアでの価格として扱ってください。langだけでは国は変わりません。
Amazon検索はkeywordで商品を検索し、各商品のASIN、タイトル、ブランド、価格と参考価格、評価と評価数、在庫状況、カテゴリ、画像、出品者、Amazon's Choiceバッジの有無を返します。あるキーワードでどんな商品が、どの価格・どの評価で表示されるかを把握でき、越境ECの商品リサーチ、競合価格の調査、キーワードの背後にある市場の分析に使えます。
国別ストアはdomain（例：amazon.co.uk）、ページの言語はlangで指定します。簡体字中国語はzhcn、繁体字中国語はzhtwです。言語を選んでもストアは切り替わりません。asinから商品リンクを組み立てて「Amazon詳細」または「Amazonレビュー」機能に渡せば、さらに詳しく調べられます。なお、rating_countが少ない評価はあまり参考になりません。
料金は1,000リクエストあたり$2.24（1回あたり$0.002236）です。失敗した呼び出しと空の結果には課金されません。 同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。
AIプロンプト
EveryInfraのAmazon 検索エンドポイント（amazon/search）を使ったデータ収集スクリプトの作成を手伝ってください。
エンドポイントの仕組み：
- リクエスト：ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにamazon、actionにsearchを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ：
- keyword: リクエストするAmazonアクションに応じたメインの検索文字列を指定します。searchでは商品の検索語句を渡します。bestsellersでは、Amazonのベストセラーカテゴリの完全なURL、またはパスの生成に使うカテゴリの短縮名を渡します。sellersでは商品ページまたは出品者ページのURLを渡します。検索語句をそのまま渡すと、出品者IDを直接検索するのではなく商品検索ページが生成されます。
- 任意パラメータ：
- domain: Amazonの国別ドメインを、スキームやパスなしで指定します（例：amazon.com、amazon.co.uk、amazon.co.jp）。デフォルトはamazon.comで、searchアクションはこれを使ってそのストアの検索URLを生成します。
- lang: 対応するAmazonエンドポイントのページ言語を、enやjaなどの有効なコードで指定します。簡体字中国語にはzhcn、繁体字中国語にはzhtwを使用し、汎用のzhコードは使用しないでください。リクエストではアクションごとに記載された言語コードのみ使用できます。言語を選択すると表示されるコンテンツが変わりますが、対象の国別ストアは変わりません。（指定可能な値：ar / bn / cs / da / de / en / es / fr）
- limit: この呼び出しで返す最大行数で、1〜50の整数で指定します。省略するとデフォルト値が適用されます。また、返される行数がこれより少なくなる場合があります。最大値を超える値を指定すると、課金前に422が返されます。（デフォルト：10）
- レコードのリストを返します。各レコードの主なフィールド: asin（Amazon標準識別番号（Amazon Standard Identifica…）、title、url、brand（ブランド）、price、list_price（参考価格（取り消し線付きの価格））、currency、rating、rating_scale、rating_count、in_stock（商品の在庫があるかどうか）、category。フィールドは全部で19個です。一覧はhttps://api.everyinfra.com/api/v1/social/catalog?platform=amazonを参照してください。.
- リクエストボディの例：
{
"platform": "amazon",
"action": "search",
"params": {
"keyword": "coffee grinder"
}
}
- 料金：1,000リクエストあたり$2.24。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。
コードを書く前に、必要な対象とその件数、必要なフィールド、希望する出力形式を私に質問してください。そのうえで、計画と概算費用を私に確認してください。リクエストパラメータ
| 名前 | 場所 | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|---|
Authorization | header | string | はい | - | Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。 |
platform | body | string | はい | amazon | プラットフォームの識別子です。値は固定です。 |
action | body | string | はい | search | 機能の識別子です。値は固定です。 |
keyword | body.params | string | はい | - | リクエストするAmazonアクションに応じたメインの検索文字列を指定します。searchでは商品の検索語句を渡します。bestsellersでは、Amazonのベストセラーカテゴリの完全なURL、またはパスの生成に使うカテゴリの短縮名を渡します。sellersでは商品ページまたは出品者ページのURLを渡します。検索語句をそのまま渡すと、出品者IDを直接検索するのではなく商品検索ページが生成されます。 |
domain | body.params | string | いいえ | - | Amazonの国別ドメインを、スキームやパスなしで指定します（例：amazon.com、amazon.co.uk、amazon.co.jp）。デフォルトはamazon.comで、searchアクションはこれを使ってそのストアの検索URLを生成します。 |
lang | body.params | string (enum) | いいえ | - | 対応するAmazonエンドポイントのページ言語を、enやjaなどの有効なコードで指定します。簡体字中国語にはzhcn、繁体字中国語にはzhtwを使用し、汎用のzhコードは使用しないでください。リクエストではアクションごとに記載された言語コードのみ使用できます。言語を選択すると表示されるコンテンツが変わりますが、対象の国別ストアは変わりません。指定可能な値arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw |
limit | body.params | integer (1–50) | いいえ | 10 | この呼び出しで返す最大行数で、1〜50の整数で指定します。省略するとデフォルト値が適用されます。また、返される行数がこれより少なくなる場合があります。最大値を超える値を指定すると、課金前に422が返されます。 |
コードサンプル
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "amazon",
"action": "search",
"params": {
"keyword": "coffee grinder"
}
}'OpenAPI定義（JSON）サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。
レスポンス例
実際のレスポンス
September 26, 2026 at 08:56（UTC）に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報（名前、ハンドル、アバター、プロフィールリンク、連絡先）を削除したものです。リストは先頭の2件のみ掲載しています。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。
json
{
"id": "req_…",
"platform": "amazon",
"action": "search",
"results": [
{
"asin": "B0GWHGT8C6",
"title": "SHARDOR Burr Coffee Grinder Electric with 32 Grinding Sizes, 2026 Upgraded",
"url": "https://www.amazon.com/dp/B0GWHGT8C6",
"brand": "SHARDOR",
"price": 39.98,
"list_price": 49.99,
"currency": "$",
"rating": 4.4,
"rating_count": 23,
"in_stock": true,
"category": "Home & Kitchen > Kitchen & Dining > Coffee, Tea & Espresso > Coffee Grinders > Electric Burr Grinders",
"image_url": "https://m.media-amazon.com/images/I/71umDJaSBGL._AC_SY300_SX300_QL70_FMwebp_.jpg",
"is_amazon_choice": false,
"seller_name": "KDSXG",
"platform": "amazon",
"images": [
"https://m.media-amazon.com/images/I/71umDJaSBGL._AC_SL1500_.jpg",
"https://m.media-amazon.com/images/I/71WkUEs07pL._AC_SL1500_.jpg",
"https://m.media-amazon.com/images/I/71h+360x8gL._AC_SL1500_.jpg"
],
"features": [
"CONSISTENT DAILY GRINDING Designed for home coffee routines, this flat burr grinder helps prepare beans for drip, pour over, french press, cold brew, moka pot, and espresso style drinks. The compact body fits small counters, apartments, office corners, and coffee stations without…",
"SMALL BATCH CONTROL The adjustable time based grinding design lets users grind only what they need for fresh cups, single serve brewers, or family coffee prep. To help protect the motor, the built in safety program supports up to 120 seconds of continuous operation before a short…",
"32 SIZE OPTIONS Choose from 32 grind settings to match different brewing needs, from finer grounds for espresso style preparation to coarser grounds for french press and cold brew. The grinder includes a chamber, cleaning brush, and hopper for daily use and simple upkeep."
],
"bestseller_ranks": [
{
"rank": 19549,
"category": "Home & Kitchen"
},
{
"rank": 7,
"category": "Burr Coffee Grinders"
}
],
"rating_scale": 5
},
{
"asin": "B0HB98V4SP",
"title": "Flat Burr Coffee Grinder Electric, Adjustable Coffee Bean Grinder with 17 Grinding Sizes, Burr Mill for Espresso & French Press, 2-12 Cup, Silver",
"url": "https://www.amazon.com/dp/B0HB98V4SP",
"brand": "Rounexes",
"price": 39.99,
"currency": "$",
"rating": 5,
"rating_count": 17,
"in_stock": true,
"category": "Home & Kitchen > Kitchen & Dining > Coffee, Tea & Espresso > Coffee Grinders > Electric Burr Grinders",
"image_url": "https://m.media-amazon.com/images/I/81lB7SOI39L._AC_SY300_SX300_QL70_FMwebp_.jpg",
"is_amazon_choice": false,
"seller_name": "MeiDing",
"platform": "amazon",
"images": [
"https://m.media-amazon.com/images/I/81lB7SOI39L._AC_SL1500_.jpg",
"https://m.media-amazon.com/images/I/81khWIt-ThL._AC_SL1500_.jpg",
"https://m.media-amazon.com/images/I/712ulwCFZuL._AC_SL1500_.jpg"
],
"features": [
"[17 Precise Grind Settings] From fine espresso to coarse French press, dial in the perfect grind across 17 calibrated levels—ideal for drip, pour-over, or cold brew, and designed to unlock your beans’ full aroma every morning.",
"[Uniform Flat Burr & Anti-Overheating] Heavy-duty stainless steel flat burrs ensure even grinding for consistent extraction and richer flavor. Low-speed operation prevents overheating, preserving delicate oils and freshness.",
"[2–12 Cup Quantity Control] Set your desired yield (2–12 cups) with the intuitive cup selector knob and 7 oz. bean hopper—grind just what you need, with zero waste."
],
"bestseller_ranks": [
{
"rank": 68800,
"category": "Home & Kitchen"
},
{
"rank": 28,
"category": "Burr Coffee Grinders"
}
],
"rating_scale": 5
}
],
"count": 10,
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}レスポンスフィールド
業務データはresultsに含まれます。この表はレコードに含まれうるフィールドの一覧です。プラットフォームに表示されない値を作り出すことはありません。
| フィールド | 意味 |
|---|---|
asin | Amazon標準識別番号（Amazon Standard Identification Number）。ストア内で商品を一意に識別するIDです。 |
title | タイトルです。プラットフォームにタイトルがない場合（テキストのみの投稿など）はnullになります。 |
url | プラットフォーム上のレコードへのリンクです。 |
brand | ブランド。 |
price | 通貨記号を含まない数値で表した価格です。通貨についてはcurrencyを参照してください。 |
list_price | 参考価格（取り消し線付きの価格）。 |
currency | 価格の通貨コードです（例：CNY、USD）。priceフィールドが存在してもcurrencyがnullの場合は、通貨を推測しないでください。 |
rating | 評価です。スケールはプラットフォームによって異なります。最大値は同じ行のrating_scaleで示されます（通常は5。Booking、Douban、iQIYI、NAVERは10）。プラットフォーム間で比較する前にrating_scaleで換算してください。換算しないと比較結果が逆転することがあります。 |
rating_scale | 同じ行のratingの最大値です。5段階評価では5、10点満点では10になります。行にratingがある場合のみ含まれます。 |
rating_count | 評価した人数です。nullは非公開を示し、0ではありません。 |
in_stock | 商品の在庫があるかどうか。 |
category | プラットフォーム独自の分類体系におけるカテゴリ名です。プラットフォーム間で正規化されていません。 |
image_url | 画像のリンクです。複数の画像を返す機能では、image_urls配列が返される場合があります。 |
description | 概要または説明文で、通常はtextより短くなります。 |
is_amazon_choice | 商品にAmazon's Choiceバッジが付いているかどうか。 |
seller_name | 販売者名。 |
platform | 取得元プラットフォームの識別子で、リクエストのplatformと同じです（例：xiaohongshu、tiktok）。 |
images | 画像リンクの配列で、プラットフォームでの表示順に並びます。画像がない場合は含まれません。 |
features | 商品ページにある箇条書きの特徴リスト（search、profile）。記載されたとおりに返します。ない場合はフィールド自体がありません。 |
bestseller_ranks | 売れ筋ランキング（search、profile）。各項目にrankとcategoryがあり、カテゴリごとに1件です。取得時点の順位であり、販売数ではありません。 |
FAQ
他の国のストアを検索するにはどうすればよいですか？
domainにストアのドメインを指定してください（例：amazon.co.uk、amazon.co.jp）。https://やパスは付けません。デフォルトはamazon.comです。langはページの言語を変えるだけで、ストアは切り替わりません。
langにはどの値を指定できますか？
この機能で指定可能な言語コード（en、ja、deなど）のみです。簡体字中国語はzhcn、繁体字中国語はzhtwで、単なるzhは受け付けられません。言語によって変わるのはページのテキストで、検索対象のストアは変わりません。
見つけた商品のレビューを取得するにはどうすればよいですか？
asinからhttps://www.amazon.com/dp/<ASIN>のような商品リンクを組み立て、「Amazonレビュー」機能に渡してください。商品リンクには検索したストアのドメインを使い、米国以外のストアでは「Amazonレビュー」機能にも同じdomainを指定してください。指定しないとamazon.comからレビューが取得され、検索結果の商品と一致しません。
エラーと課金
- 401
- キーが未指定か無効です。
- 402
- 残高が不足しています。先にチャージしてください。
- 422
- パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
- 429
- 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
- 503
- 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
- 200（空）
- データがありません。課金はされません。