CrawlRelayプロキシドキュメント：クイックスタート

最初のリクエストはどうやって送るの？

ダッシュボードからユーザー名とパスワードをコピーして、以下のいずれかを実行してください。各実行でサイトが認識するIPアドレスが表示され、通常は実行ごとに変わります。

curl -x http://USERNAME-country-us:[email protected]:7777 https://api.ipify.org

import requests

proxy = "http://USERNAME-country-us:[email protected]:7777"
r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=(10, 30))
print(r.text)

import { ProxyAgent, fetch } from "undici";

const dispatcher = new ProxyAgent("http://USERNAME-country-us:[email protected]:7777");
const res = await fetch("https://api.ipify.org", { dispatcher });
console.log(await res.text());

ユーザー名はどう作るの？

ダッシュボードのユーザー名をベースに、上記の形式に沿ってパラメータをハイフンで連結してください。すべてのパラメータは任意です。値は小文字、都市名はアンダースコア使用（new_york、sao_paulo）。都市の利用可能性は異なります。

ローテーションとスティッキーセッションの動作は？

session-なしのユーザー名は新しいTCP接続ごとにプールからIPを取得し、通常違うものになります。session-<id>-ttl-<minutes>ありのユーザー名はIDごとにTTL終了かレジデンシャルプロキシ端末がオフラインになるまで同じ出口IPを維持します。

• ローテーションは接続単位でおこなわれ、リクエスト単位ではありません：keep-aliveは同じ出口を使い続けます。
• 1つのジョブ、ブラウザコンテキスト、アカウントフローごとに新しいセッションIDを使ってください。
• 同じセッションIDを送る2つのスクレイパーは1つの出口IPを共有します。

セッションガイドで各ライブラリの接続再利用について説明しています。

制限は何ですか？

• ブロックされた宛先: 銀行、政府、決済ポータルサイトおよびSMTP（メール送信）ポート25、465、587への利用不可。これらへのリクエストは拒否されます。
• 使用: 公共データのみ、許容利用ポリシーに準拠。アカウントの乗っ取り、詐欺、スパム、意図的なブロック回避行為は禁止。
• トラフィック: GB単位で課金。利用量はプロキシ経由の送受信データ全量（アップロード・ダウンロード、ヘッダ含む）。1 GB = 1,000,000,000バイト。ターゲット到達前に失敗した接続試行はカウントしません。。プランのトラフィックが尽きるとリクエストは停止します。
• セッション: 最大30分間。住宅用端末がオフラインになるなどでIPは早期に変わる場合があります。
• プロトコル: HTTP、HTTPS（CONNECT）、SOCKS5対応。
• 同時接続数: 課金されません。制限は各ターゲットの許容量によります。詳細は同時接続ガイドをご覧ください。

認証情報と利用状況はどう管理しますか？

ダッシュボードまたはAPIキーを使ったREST APIhttps://crawlrelay.com/api/v1で管理可能。いつでも取り消せるAPIキー対応。主なタスクは以下:

• サブユーザー: スクレイパーやクライアントプロジェクトごとに1セットの認証情報、オプションでトラフィック上限設定あり。レジデンシャルAPIを参照。
• IP許可リスト: パスワード不要で接続可能な最大10IP。
• 使用状況: サブスクリプションごとの1日トラフィック監視、クロール停止前にアラート。
• カタログ: 対応国、都市、州、ASN。コード内でユーザー名検証に利用可能。
• 注文: ダッシュボードを開かず残高からトラフィックを追加購入可。注文APIを参照。