APIエラー
Web Scraping APIは標準的なHTTPステータスコードを返します。2xx以外のレスポンスには、問題の内容を説明するerrorフィールドを含むJSONボディが含まれます。
エラーコード
Section titled “エラーコード”| コード | 意味 |
|---|---|
400 | Bad Request。リクエストの形式が不正であるか、無効なパラメータを含んでいます。対象URLをスクレイピングできなかった場合にも返されます。 |
401 | Unauthorized。APIキーが指定されていない、無効である、またはクレジットの割り当てを超過しています。 |
403 | Forbidden。ご契約のプランにこの機能(JavaScriptレンダリングや国別ジオロケーションなど)が含まれていません。利用するにはサブスクリプションをアップグレードしてください。 |
406 | Not Acceptable。リクエストされたレスポンス形式はサポートされていません。 |
422 | Unprocessable Entity。リクエスト自体は有効でしたが、処理を完了できませんでした。よくある原因は、対象サイトが200 OKと共にCAPTCHAを返した、レスポンスのHTMLが空である、Instagramのプロフィールがログインページを返した、またはwait_for_cssセレクタが一度も出現しなかった、などです。 |
429 | Too Many Requests。リクエストの送信頻度が高すぎるか、並列実行数が多すぎます。Googleがスクレイパーを検知した場合にもこのコードが返されることがあります。 |
500 | Internal Server Error。当社側で問題が発生しました。しばらくしてから再度お試しください。 |
503 | Service Unavailable。APIはメンテナンスのため一時的に停止しています。後ほど再度お試しください。 |
リトライの仕様
Section titled “リトライの仕様”500と503は指数バックオフ(例: 1秒、2秒、4秒)でリトライしてください。429は一時停止した後にリトライし、リクエストの並列数を減らしてください。400、401、403、406は、リクエスト内容を変更せずにリトライしないでください。
- Web Scraping API - エンドポイントの一覧
- 基本的なリクエスト - 最小構成の呼び出し例