Amazon Scraperクイックスタート

cURLを使用して1つのAmazon商品をリクエストし、その構造化された結果を読み取ります。このチュートリアルでは、 ProductAPIリファレンスのリクエスト例を使用します。

はじめに

Scrapelessアカウントと有効なAPIキー、および cURL が必要です。キーは Scrapelessダッシュボードから取得してください。

サンプルでは、APIリファレンスにある商品URLを使用しています。取得したいAmazon商品のURLに置き換えることができます。在庫状況および返される値は変更される場合があります。

1. リクエストを送信

YOUR_API_KEY を自分のキーに置き換えます：

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": ""
  }
}'

リクエストボディは Amazonactorを選択し、 type を productに設定し、製品の urlを提供します。空の zip_code は公式の例に一致しています。特定の場所の配送情報を必要とする場合は、郵便番号を提供してください。

2. 完了した結果を読み取る

HTTP 200 が完了を示します。以下は公開されている Product レスポンス例の一部フィールドであり、新しいキャプチャではありません：

{
  "asin": "B0BQXHK363",
  "availability": "In Stock",
  "final_price": "$44.99",
  "rating": "4.0",
  "reviews_count": "115"
}

この例の価格、評価、レビュー数は文字列です。ペイロードを読み取る際は返された型を保持し、アプリケーションで数値が必要な場合は明示的に変換してください。完全な例の他のフィールドには title、 images、および variationsが含まれます。

3. まだ処理中のタスクを取得

HTTP 201 レスポンスはタスク ID を返します。APIリファレンスには以下が示されています：

{
  "message": "task in progress",
  "taskId": "a8af123c-0f81-477d-a2e7-c57ad18fe54a"
}

このリクエストでは、例のIDではなく、自身のレスポンスから得たIDを使用してください：

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

タスクがまだ処理中の場合は、結果の取得とポーリングに従って継続してください。同じ製品リクエストを繰り返し送信するのではなく、制限付きのリトライポリシーを使用してください。

リクエストが失敗した場合

HTTPステータスとレスポンスボディの両方を確認してください。Product リファレンスには 400 および code: 20500 を含む message: "scraping failed"の例が含まれています。キー、製品のURL、およびJSON入力を確認してください。レートリミットやサーバーエラーについては、共有されたポーリングガイドに従ってください。

次のステップ

Seller、キーワード検索、Rufusリクエストについては、 エンドポイント に進んでください。公開済みの完全な例については、 ProductAPIリファレンスを確認してください。

紹介エンドポイント