プロキシリスト
パッケージ用のすぐに使えるプロキシ文字列を、オプションの Geo ターゲティングとフォーマット選択付きで生成します。
GET /packages/:id/proxies
指定したパッケージのプロキシ接続文字列のリストを返します。デフォルトのレスポンスはプレーンテキスト(1行に1プロキシ)で、どのツールにも簡単にインポートできます。 plain text (one proxy per line), making it trivially importable into any tool. Pass Accept: application/json to get a JSON envelope instead.
GET
/api/v1/packages/{id}/proxiesクエリパラメータ
| パラメータ | デフォルト | 説明 |
|---|---|---|
quantity | 10 | 返すプロキシ文字列の数(1–1000) |
type | rotating | rotating or sticky |
protocol | http | http or socks5 |
format | user:pass@host:port | 出力フォーマット — 下の表を参照 |
countries | — | カンマ区切りの ISO 3166-1 alpha-2 国コード |
exclude_countries | — | 除外するカンマ区切りの国コード |
states | — | 州名(小文字、スペースなし、例:california) |
cities | — | 都市名(小文字、スペースなし、例:newyork) |
zipcodes | — | ZIP/郵便番号、カンマ区切り |
asns | — | 自律システム番号(数値、AS プレフィックスあり/なし) |
exclude_states | — | 除外する州名(小文字、スペースなし)。2× 課金が適用されます。 |
exclude_cities | — | 除外する都市名(小文字、スペースなし)。2× 課金が適用されます。 |
exclude_zipcodes | — | 除外する ZIP コード。2× 課金が適用されます。 |
exclude_asns | — | 除外する ASN(数値)。2× 課金が適用されます。 |
sessid | — | スティッキーセッション ID。次の ~30 分以内に同じ文字列を再利用すれば、スティッキーポートを占有せずに同じ出口 IP を保持できます。 |
sessttl | 30 | スティッキーセッションの TTL(分、1–120)。省略時は 30 分。 |
unique_sessid | false | true かつ sessid が設定されている場合、生成されたプロキシは sessid プレフィックスを共有し、各行に一意の接尾辞(sessid.0、sessid.1、…)が追加されます — 1回のリクエストで N 個の独立したスティッキーセッションを発行するのに便利です。 |
anonymous | false | true で高匿名性の出口のみを返します。プールサイズが小さくなる可能性があります。 |
州 / 都市 / ZIP / ASN では 2× 課金
州、都市、ZIP、ASN ターゲティングは Residential、Mobile、Datacenter パッケージに 2× トラフィック乗数を適用します。Premium Residential は免除されます。国ターゲティング(countries / exclude_countries)は常に無料です。
出力フォーマット
| format 値 | 出力例 |
|---|---|
user:pass@host:port | abc123:pass7x9k2m@proxy.raxyproxy.com:823 |
host:port:user:pass | proxy.raxyproxy.com:823:abc123:pass7x9k2m |
user:pass:host:port | abc123:pass7x9k2m:proxy.raxyproxy.com:823 |
host:port@user:pass | proxy.raxyproxy.com:823@abc123:pass7x9k2m |
user:pass | abc123:pass7x9k2m |
host:port | proxy.raxyproxy.com:823 |
http://user:pass@host:port | http://abc123:pass7x9k2m@proxy.raxyproxy.com:823 |
socks5://user:pass@host:port | socks5://abc123:pass7x9k2m@proxy.raxyproxy.com:824 |
Geo フィルタリング例
geo-examples.sh
# US proxies only
curl "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=5&countries=us" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# US, UK, and Germany — rotating HTTP
curl "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=10&countries=us,gb,de" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# California only — note: 2× billing applies
curl "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=5&countries=us&states=california" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# New York city, sticky, SOCKS5, JSON response
curl "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=3&countries=us&cities=newyork&type=sticky&protocol=socks5" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Accept: application/json"proxies-plain.txt
# Plain text response (default):
abc123def456:pass7x9k2m@proxy.raxyproxy.com:823
abc123def456:pass7x9k2m@proxy.raxyproxy.com:823
abc123def456:pass7x9k2m@proxy.raxyproxy.com:823proxies-json.json
{
"data": {
"package_id": 12,
"count": 3,
"billing_multiplier": 1.0,
"proxies": [
"abc123def456:pass7x9k2m@proxy.raxyproxy.com:823",
"abc123def456:pass7x9k2m@proxy.raxyproxy.com:823",
"abc123def456:pass7x9k2m@proxy.raxyproxy.com:823"
]
},
"meta": { "version": "v1" }
}スティッキーセッション:ポート vs sessid
同じ出口 IP を保持する 2 つの方法:スティッキー範囲(10000–20000)のポートに接続する(ポートごとに 1 IP)、または資格情報に sessid パラメータを付けて標準のローテーションポートを使用する。多数の独立した同時スティッキーセッションが必要な場合は sessid が推奨されます。
sticky-sessid.sh
# Sticky session via sessid — same IP for 10 minutes, single proxy
curl "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=1&countries=us&sessid=worker-7&sessttl=10" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# Sticky session via port range — same IP per port, 100 distinct sticky exits in parallel
curl "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=100&type=sticky" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# 20 unique sessid sticky sessions on the standard rotating port — 20 isolated IPs, 30 min TTL
curl "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=20&sessid=worker&unique_sessid=true&sessttl=30" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# Anonymous-only US proxies, excluding California
curl "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=10&countries=us&exclude_states=california&anonymous=true" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"コード例
proxies.sh
# Download 100 US proxies in URL format to a file
curl -s "https://raxyproxy.com/api/v1/packages/12/proxies?quantity=100&countries=us&format=http://user:pass@host:port" \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-o proxies.txtproxies.py
import requests
API_KEY = 'raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
PACKAGE_ID = 12
resp = requests.get(
f'https://raxyproxy.com/api/v1/packages/{PACKAGE_ID}/proxies',
params={
'quantity': 10,
'countries': 'us',
'format': 'http://user:pass@host:port',
},
headers={
'Authorization': f'Bearer {API_KEY}',
'Accept': 'text/plain',
},
timeout=10,
)
proxies = resp.text.strip().splitlines()
print(f'Got {len(proxies)} proxies')
# Use the first one
session = requests.Session()
session.proxies = {'http': proxies[0], 'https': proxies[0]}
ip = session.get('https://httpbin.org/ip', timeout=10).json()['origin']
print(f'My IP via proxy: {ip}')proxies.mjs
const API_KEY = 'raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
const PACKAGE_ID = 12;
const url = new URL(`https://raxyproxy.com/api/v1/packages/${PACKAGE_ID}/proxies`);
url.searchParams.set('quantity', '10');
url.searchParams.set('countries', 'us');
url.searchParams.set('format', 'http://user:pass@host:port');
const resp = await fetch(url, {
headers: { Authorization: `Bearer ${API_KEY}` },
});
const proxies = (await resp.text()).trim().split('\n');
console.log(`Got ${proxies.length} proxies`);
console.log(proxies[0]);