Amazon Scraperのエンドポイント

このページのすべての操作には、アクター scraper.amazon を使用します。input.type で操作を選択し、対応する入力値を指定してください。

リクエストと認証

POST https://api.scrapeless.com/api/v1/scraper/request
x-api-token: YOUR_API_KEY
Content-Type: application/json

YOUR_API_KEY を Scrapeless APIキーに置き換えてください。actor と input を含むJSONオブジェクトを1つ送信します。

操作の選択

操作	`input.type`	以下の入力値を使用
商品	`product`	`url`, `zip_code`
出品者	`seller`	`url`, `zip_code`
キーワード検索	`keywords`	`keywords`, `page`, `domain`, `zip_code`
Rufus	`rufus`	`keywords`, `domain`

商品

Amazon商品のURLを指定します。商品スキーマでは url が必須です。zip_code は配送先情報の提供に使用されます。

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.amazon",
  "input": {
    "type": "product",
    "url": "https://www.amazon.com/dp/B0BQXHK363",
    "zip_code": ""
  }
}'

公開されるレスポンスには、asin、title、availability、final_price、rating、reviews_count、images、variations が含まれます。短縮版のレスポンス例については、Quickstart を参照してください。

商品APIリファレンス

出品者

出品者ページのURLを指定します。zip_code を含めてください。出品者スキーマでは必須項目としてマークされており、リクエスト例では空文字列が使用されています。

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.amazon",
  "input": {
    "type": "seller",
    "url": "https://www.amazon.com/sp?seller=A2XZ7JICGUQ1CX",
    "zip_code": ""
  }
}'

出品者リファレンスでは、成功時のレスポンスをフィールドレベルのスキーマや例のないJSONオブジェクトとして定義しています。アプリケーションで出品者フィールドをマッピングする前に、返されたペイロードを確認してください。

出品者APIリファレンス

キーワード検索

keywords に検索テキストを指定します。page を使用して検索結果ページを選択します。以下の例はドキュメントに記載された数値のページ値に従い、Amazon.comには domain: "com" を使用しています。オプションの部門フィルターは省略されています。

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.amazon",
  "input": {
    "type": "keywords",
    "keywords": "Iphone+14+Pro+512GB",
    "page": 1,
    "domain": "com",
    "zip_code": ""
  }
}'

入力値	用途
`keywords`	検索キーワード。操作スキーマで必須です。
`page`	検索結果のページ番号。
`domain`	Amazonドメイン設定。公式例では `com` が使用されています。
`department`	オプションの部門エイリアス。Amazonの `i` クエリパラメータに対応します。
`zip_code`	配送情報用の郵便番号。

公開されるレスポンスには、keyword、page、result、total_results_count、url が含まれます。商品エントリは result.organic の下に表示されます。レスポンス例はリクエスト例とは異なるクエリとページを対象としているため、正確な結果を予測するためではなく、フィールドを理解するために使用してください。

Amazonパラメータガイドでは page の値を整数として指定しており、リクエスト例では 1 が使用されています。生成された操作スキーマでは現在 page が文字列としてラベル付けされています。本ガイドはパラメータガイドおよびリクエスト例に従います。

キーワード検索APIリファレンス

Rufus

type を rufus に設定します。操作スキーマでは keywords と domain の両方が必須です。キーワード検索の例で使用されている com 形式ではなく、www.amazon.es のような完全なAmazonドメインを使用してください。

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.amazon",
  "input": {
    "type": "rufus",
    "keywords": "macbook",
    "domain": "www.amazon.es"
  }
}'

公開されるレスポンスには以下が含まれます：

フィールド	API例に表示される内容
`html`	イベントレコードとHTMLフラグメントを含む生コンテンツ。
`metadata`	`type` と `rawUrl` を含みます。
`result.user_query`	クエリテキスト。
`result.products`	クエリに対して返された商品エントリ。
`result.related_questions`	関連質問。
`result.sources`	データソース。このフィールドはすべてのレスポンスで返されるとは限りません。可用性は商品とプロンプトに依存します。

操作スキーマには is_sse_data、is_get_question、asin もリストされていますが、その動作については説明されていません。上記のドキュメント化されたリクエストから開始してください。

Rufus APIリファレンス

タスク結果の処理

HTTP 200 レスポンスには完了した結果が含まれます。HTTP 201 レスポンスは処理がまだ進行中であることを意味します。その taskId を保存し、以下の方法でタスクを取得してください：

curl --request GET 'https://api.scrapeless.com/api/v1/scraper/result/YOUR_TASK_ID' \
  --header 'x-api-token: YOUR_API_KEY'

YOUR_TASK_ID をリクエストによって返されたIDに置き換えてください。ポーリング間隔とリトライ制限については、結果とポーリングを参照してください。

HTTPステータスコードだけでなく、エラーボディも確認してください。400 レスポンスには code: 20500 および message: "scraping failed" が含まれる場合があります。これは正常なデータレスポンスではありません。リトライする前に、ターゲットとリクエスト入力を確認してください。

パラメータリファレンス

部門エイリアスおよびその他のドキュメント化された入力値については、Amazon APIパラメータを使用してください。選択した type に応じて結果を解析してください。商品、キーワード検索、出品者、Rufusは単一のフィールドレイアウトを共有していません。

クイックスタート紹介