はじめに
ご自身の 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でブラウザ拡張機能を設定。複数の拡張機能の場合はカンマで区切ります |
| フィンガープリント | string | ブラウザフィンガープリントとは、ブラウザとデバイスの構成情報を用いて作成されるほぼ一意の「デジタル指紋」であり、クッキーがなくてもオンライン活動を追跡するために使用できます。幸いなことに、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の両方が必要です。