Lista de proxies

Gere strings de proxy prontas para uso para um pacote, com geo-targeting opcional e seleção de formato.

GET /packages/:id/proxies

Retorna uma lista de strings de conexão proxy para o pacote fornecido. Por padrão a resposta é texto simples (um proxy por linha), tornando a importação trivial em qualquer ferramenta. Passe 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

Parâmetros de consulta

Parâmetro	Padrão	Descrição
`quantity`	`10`	Número de strings de proxy a retornar (1–1000)
`type`	`rotating`	`rotating` or `sticky`
`protocol`	`http`	`http` or `socks5`
`format`	`user:pass@host:port`	Formato de saída — veja tabela abaixo
`countries`	—	Códigos de país ISO 3166-1 alpha-2 separados por vírgulas
`exclude_countries`	—	Códigos de país separados por vírgulas para excluir
`states`	—	Nomes de estados (minúsculas, sem espaços, ex. california)
`cities`	—	Nomes de cidades (minúsculas, sem espaços, ex. newyork)
`zipcodes`	—	Códigos ZIP/postais, separados por vírgulas
`asns`	—	Números de sistema autônomo (numérico, com ou sem prefixo AS)
`exclude_states`	—	Nomes de estados a excluir (minúsculas, sem espaços). Faturamento 2×.
`exclude_cities`	—	Nomes de cidades a excluir (minúsculas, sem espaços). Faturamento 2×.
`exclude_zipcodes`	—	Códigos ZIP a excluir. Faturamento 2×.
`exclude_asns`	—	ASNs a excluir (numérico). Faturamento 2×.
`sessid`	—	ID de sessão sticky. Reutilize a mesma string nos próximos ~30 minutos para manter o mesmo IP de saída sem ocupar uma porta sticky.
`sessttl`	`30`	TTL da sessão sticky em minutos (1–120). 30 min por padrão.
`unique_sessid`	`false`	Quando true e sessid definido: proxies gerados compartilham o prefixo sessid mas recebem sufixo único por linha (sessid.0, sessid.1, …) — útil para N sessões sticky independentes em uma única requisição.
`anonymous`	`false`	true para retornar apenas saídas de alta anonimidade. Pode reduzir o pool.

2× faturamento para estado / cidade / ZIP / ASN

O targeting por estado, cidade, ZIP e ASN aplica um multiplicador de tráfego 2× para pacotes Residential, Mobile e Datacenter. Premium Residential está isento. O targeting por país (countries / exclude_countries) é sempre gratuito.

Formatos de saída

valor de formato	Exemplo de saída
`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`

Exemplos de filtragem geográfica

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" }
}

Sessões sticky: porta vs sessid

Dois modos de manter o mesmo IP de saída: conectar a uma porta do intervalo sticky (10000–20000) — um IP por porta — ou anexar o parâmetro sessid às credenciais usando a porta rotativa padrão. sessid é preferível para muitas sessões sticky simultâneas.

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"

Exemplos de código

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]);

← Anterior

Estatísticas do pacote

Chaves de API