API do Brasil Proxy

Autenticação

Crie uma chave em Minha conta → API e envie em toda requisição no cabeçalho X-API-Key (ou Authorization: Bearer). A chave começa com bp_live_ e aparece inteira só uma vez, na criação. Guarde em lugar seguro e nunca coloque em código público.

curl https://brasilproxy.com/api/v1/proxies \
  -H "X-API-Key: bp_live_sua_chave"

Permissões: leitura consulta proxies e conta; escrita também pode testar proxies pela API.

Rotas

Endereço base: https://brasilproxy.com/api/v1. Respostas em JSON.

Listar proxies

Filtros opcionais na URL:

• status=active (padrão) ou status=expired
• type=ipv4, isp, mobile, ipv6, mix, residential ou intl
• sort=expires_at ordena pelo vencimento
• format=txt devolve texto puro, um acesso por linha (host:porta:usuário:senha), para importar em lote

curl "https://brasilproxy.com/api/v1/proxies?format=txt" -H "X-API-Key: bp_live_sua_chave"

Resposta (JSON):

{
  "data": [
    {
      "id": "8f1c…",
      "type": "ipv4",
      "host": "203.0.113.10",
      "port": 8000,
      "username": "usuario",
      "password": "senha",
      "protocol": "http",
      "country": "BR",
      "status": "active",
      "health_score": 100,
      "uptime_7d": 99.8,
      "current_latency_ms": 41,
      "expires_at": "2026-12-13T15:00:00.000Z",
      "days_remaining": 29,
      "created_at": "2026-11-13T15:00:00.000Z"
    }
  ],
  "meta": { "total": 1, "active": 1, "expiring_soon": 0 }
}

Testar um proxy

Precisa de chave com permissão de escrita.

curl -X POST https://brasilproxy.com/api/v1/proxies/ID_DO_PROXY/check \
  -H "X-API-Key: bp_live_sua_chave"

{
  "proxy_id": "8f1c…",
  "online": true,
  "ip": "203.0.113.10",
  "country": "BR",
  "city": "São Paulo",
  "latency_ms": 212,
  "checked_at": "2026-11-13T15:00:00.000Z"
}

Exemplos

JavaScript (Node 18+):

const r = await fetch('https://brasilproxy.com/api/v1/proxies', {
  headers: { 'X-API-Key': process.env.BRASILPROXY_API_KEY },
})
const { data } = await r.json()
console.log(data.map((p) => `${p.host}:${p.port}`))

Python:

import os, requests

r = requests.get(
    "https://brasilproxy.com/api/v1/proxies",
    headers={"X-API-Key": os.environ["BRASILPROXY_API_KEY"]},
)
for p in r.json()["data"]:
    print(p["host"], p["port"])

Limites e erros

Até 60 requisições por minuto por chave. Toda resposta traz X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset.

A renovação continua em Minha conta → Renovar, por Pix ou cartão.