Amazon Scraper エンドポイント

このページのすべての操作でactor 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キーに置き換えてください。JSONオブジェクトを1つ送信し、その中に actor と inputを含めてください。

操作を選択

操作	`input.type`	以下で使用される入力
製品	`product`	`url`, `zip_code`
販売者	`seller`	`url`, `zip_code`
キーワード検索	`keywords`	`keywords`, `page`, `domain`, `zip_code`
Rufus	`rufus`	`keywords`, `domain`

製品

Amazon製品のURLを提供してください。Productスキーマは 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を含めてください：Sellerスキーマでは必須とされており、リクエスト例では空文字列を使用しています。

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 の両方が必須です。ドメインには www.amazon.esのようなAmazonの完全なドメイン名を指定してください。キーワード検索の例で使用する 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": "rufus",
    "keywords": "macbook",
    "domain": "www.amazon.es"
  }
}'

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

フィールド	API 例に表示されるコンテンツ
`html`	イベントレコードと HTML フラグメントを含む生データ。
`metadata`	`type` と `rawUrl`が含まれます。
`result.user_query`	クエリテキスト。
`result.products`	クエリに対して返された製品エントリ。
`result.related_questions`	関連する質問。

操作スキーマには 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"が含まれる場合があります。これは成功したデータレスポンスではありません。再試行する前にターゲットとリクエスト入力を確認してください。

パラメータリファレンス

部門のエイリアスやその他のドキュメント化された入力には、 AmazonAPIParameters を使用してください。選択した typeの結果を解析してください。商品、キーワード検索、セラー、Rufusは単一のフィールドレイアウトを共有していません。

クイックスタート紹介