プロキシリスト
Docsプロキシリスト

プロキシリスト

パッケージ用のすぐに使えるプロキシ文字列を、オプションの 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

クエリパラメータ

パラメータデフォルト説明
quantity10返すプロキシ文字列の数(1–1000)
typerotatingrotating or sticky
protocolhttphttp or socks5
formatuser:pass@host:port出力フォーマット — 下の表を参照
countriesカンマ区切りの ISO 3166-1 alpha-2 国コード
exclude_countries除外するカンマ区切りの国コード
states州名(小文字、スペースなし、例:california)
cities都市名(小文字、スペースなし、例:newyork)
zipcodesZIP/郵便番号、カンマ区切り
asns自律システム番号(数値、AS プレフィックスあり/なし)
exclude_states除外する州名(小文字、スペースなし)。2× 課金が適用されます。
exclude_cities除外する都市名(小文字、スペースなし)。2× 課金が適用されます。
exclude_zipcodes除外する ZIP コード。2× 課金が適用されます。
exclude_asns除外する ASN(数値)。2× 課金が適用されます。
sessidスティッキーセッション ID。次の ~30 分以内に同じ文字列を再利用すれば、スティッキーポートを占有せずに同じ出口 IP を保持できます。
sessttl30スティッキーセッションの TTL(分、1–120)。省略時は 30 分。
unique_sessidfalsetrue かつ sessid が設定されている場合、生成されたプロキシは sessid プレフィックスを共有し、各行に一意の接尾辞(sessid.0、sessid.1、…)が追加されます — 1回のリクエストで N 個の独立したスティッキーセッションを発行するのに便利です。
anonymousfalsetrue で高匿名性の出口のみを返します。プールサイズが小さくなる可能性があります。

州 / 都市 / ZIP / ASN では 2× 課金

州、都市、ZIP、ASN ターゲティングは Residential、Mobile、Datacenter パッケージに 2× トラフィック乗数を適用します。Premium Residential は免除されます。国ターゲティング(countries / exclude_countries)は常に無料です。

出力フォーマット

format 値出力例
user:pass@host:portabc123:pass7x9k2m@proxy.raxyproxy.com:823
host:port:user:passproxy.raxyproxy.com:823:abc123:pass7x9k2m
user:pass:host:portabc123:pass7x9k2m:proxy.raxyproxy.com:823
host:port@user:passproxy.raxyproxy.com:823@abc123:pass7x9k2m
user:passabc123:pass7x9k2m
host:portproxy.raxyproxy.com:823
http://user:pass@host:porthttp://abc123:pass7x9k2m@proxy.raxyproxy.com:823
socks5://user:pass@host:portsocks5://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:823
proxies-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.txt
proxies.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]);