はじめに
APIキーの取得
Scraping Browserコントロールパネルにアクセスし、設定タブでAPIキーを取得します。このAPIキーは以下の手順で使用します。
パラメータ
| パラメータ名 | タイプ | 説明 |
|---|---|---|
| token | string | コントロールパネルで生成されたAPIキー。 |
| sessionTTL | number | セッションの持続時間を制御し、タイムアウト後にブラウザインスタンスを自動的に閉じます。秒単位 (s) で測定され、デフォルトは180秒 (3分) です。60秒 (1分) から900秒 (推奨最大15分ですが、より長い時間を設定することも可能) の間でカスタマイズできます。指定されたTTLに達すると、セッションは期限切れとなり、Scraping Browserはリソースを解放するためにブラウザインスタンスを閉じます。 |
| sessionName | string | 履歴セッションリストでの検索と表示を容易にするために、セッションに名前を設定します。 |
| sessionRecording | boolean | セッション記録を有効にするかどうか。有効にすると、ブラウザセッションの実行プロセス全体が自動的に記録され、セッション完了後に履歴セッションリストの詳細で再生および表示できます。デフォルトはfalseです。 |
| proxyURL | string | ブラウザのプロキシURLを設定するために使用されます。例: http://user:pass@ip:port。このパラメータが設定されている場合、他のすべてのproxy_*パラメータは無視されます。💡カスタムプロキシ機能は現在、サブスクライバーのみが利用できます。こちらでアップグレード |
| proxyCountry | string | プロキシルーティングのターゲット国/地域を指定し、選択した場所からのIPアドレスを介してリクエストをルーティングします。ISO国コード (例: 米国の場合はUS、英国の場合はGB、ランダム選択の場合はANY) を受け入れます。195以上の国と地域をサポートしています。proxyStateおよびproxyCityと組み合わせることで、都市レベルまでの正確な地理的ターゲティングを可能にします。 |
| proxyState | string | (オプション) より詳細なプロキシルーティングのために、選択した国内のターゲット州/県を指定します。proxyCountryと組み合わせて使用する必要があります。州コード (例: カリフォルニア州の場合はCA、ニューヨーク州の場合はNY) を受け入れます。州/県の区分が定義されている一部の国で利用可能です。詳細はこちら |
| proxyCity | string | (オプション) 都市レベルのプロキシルーティングのために、選択した州/県内のターゲット都市を指定します。proxyCountryおよびproxyStateと組み合わせて使用する必要があります。最も正確な地理的ターゲティングを提供します。特定の都市でのプロキシインフラストラクチャによって利用可能性が異なります。詳細はこちら |
| extensionIds | string | 拡張機能IDでブラウザ拡張機能を設定します。複数の拡張機能はカンマで区切ります。 |
| fingerprint | string | ブラウザのフィンガープリントは、ブラウザとデバイスの構成情報を使用して作成されるほぼ一意の「デジタルフィンガープリント」であり、Cookieなしでもオンラインアクティビティを追跡するために使用できます。幸いなことに、Scraping Browserでのフィンガープリントの設定はオプションです。ブラウザのユーザーエージェント、タイムゾーン、言語、画面解像度などのコアパラメータ、およびカスタム起動パラメータを介した機能拡張のサポートなど、ブラウザのフィンガープリントの深いカスタマイズを提供します。マルチアカウント管理、データ収集、プライバシー保護のシナリオに適しており、scrapeless独自のChromiumブラウザを使用することで検出を完全に回避します。デフォルトでは、Scraping Browserサービスは各セッションでランダムなフィンガープリントを生成します。参照 |
Scraping Browser WebSocket接続URLの完全な例:
wss://browser.scrapeless.com/api/v2/browser?token=APIKey&sessionTTL=180&proxyCountry=ANYwss://browser.scrapeless.com/api/v2/browser?token=APIKey&sessionTTL=180&proxyCountry=US&proxyState=CA&proxyCity=Los%20Angeleswss://browser.scrapeless.com/api/v2/browser?token=APIKey&sessionTTL=180&proxyURL=proxyURL注: proxyURLが指定されている場合、それが優先され、他のプロキシ関連パラメータ (proxyCountry、proxyState、proxyCity) は無視されます。地理的プロキシパラメータは一緒に使用する必要があります:proxyStateにはproxyCountryが必要であり、proxyCityにはproxyCountryとproxyStateの両方が必要です。