Referência da API
Conta, recargas, pedidos, uso residencial, chaves de API.
Resposta rápida
Como me conecto à Broadband Proxies?
Conecte-se a gw.broadbandproxies.com na porta 7777 (HTTP, HTTPS) ou 7778 (SOCKS5) com um nome de usuário no formato USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}. Apenas o país é obrigatório. Broadband Proxies inclui todos os segmentos de segmentação de US$ 2,63 por 1 GB (outubro de 2026); sem KYC, apenas cripto.
Quais segmentos do nome de usuário existem?
| Segmento | Valores | Exemplo | Observações |
|---|---|---|---|
country- | Código de país de duas letras, em minúsculas | country-us | Obrigatório |
state- | Código de estado dos EUA com duas letras | state-tx | Somente Estados Unidos |
city- | Nome da cidade, em minúsculas, com sublinhados | city-san_antonio | A disponibilidade de cidades varia; o checkout mostra o que está online |
zip- | Código postal dos EUA com cinco dígitos | zip-77006 | Somente Estados Unidos |
asn- | Número AS sem 'AS' | asn-7922 | Incluído sem custo adicional |
session- | Qualquer ID de letras e dígitos | session-qa7 | Modo sticky; omita para rotativo |
ttl- | Minutos, com uma sessão | ttl-20 | até 30 minutos (o IP pode mudar antes, por exemplo se o dispositivo doméstico ficar offline) |
Referência do gateway e da conta
| Host | gw.broadbandproxies.com |
|---|---|
| HTTP e HTTPS | Porta 7777 (HTTPS via CONNECT) |
| SOCKS5 | Porta 7778 |
| Autenticação | Nome de usuário e senha em todos os planos, ou uma lista de IPs permitidos (até 10 IPs). Subusuários com suas próprias credenciais e limite de tráfego. Chaves de API que você pode revogar a qualquer momento |
| Rotação | Cada nova conexão recebe um IP do pool, geralmente diferente; para obter um novo IP a cada requisição, envie uma requisição por conexão (desative o keep-alive) |
| Contagem de tráfego | O uso conta todos os dados enviados e recebidos pelo proxy (upload e download, cabeçalhos incluídos). 1 GB = 1.000.000.000 bytes. Tentativas de conexão que falham antes de alcançar o destino não são contabilizadas |
| Destinos bloqueados | Sites de bancos, órgãos governamentais e portais de pagamento, além das portas SMTP (envio de e-mail) 25, 465 e 587 |
| API | Documentação da API, URL base neste domínio |
O que significam os erros comuns?
- 407 Proxy Authentication Required: o gateway não aceitou as credenciais. Verifique a senha, a grafia de cada segmento e se não há espaço.
- Conexão encerrada imediatamente: verifique se a porta corresponde ao protocolo (clientes HTTP em 7777, SOCKS5 em 7778) e se o destino não está na lista de bloqueados.
- Timeouts com filtros restritos: nenhum dispositivo residencial corresponde naquele momento. Remova o ZIP e depois a cidade (guia de combinação).
- IP de outra rede: consulte verificar o ASN do seu IP de saída.
Páginas de documentação
Primeiros passos
Do cadastro a um IP ISP verificado.
Verificação do ASN do IP de saída
Exemplos em Python, Node.js e curl.
Lista de ISP e ASN
Todos os números AS que documentamos.
Docs: FAQ
Posso usar uma lista de IPs permitidos em vez de senha?
Sim: Nome de usuário e senha em todos os planos, ou uma lista de IPs permitidos (até 10 IPs). Subusuários com suas próprias credenciais e limite de tráfego. Chaves de API que você pode revogar a qualquer momento. Com uma lista de IPs permitidos, os segmentos de segmentação ainda vão no campo de nome de usuário que sua ferramenta envia.
O tráfego HTTPS é descriptografado?
Não. O HTTPS passa pelo gateway como um túnel CONNECT criptografado. Não registramos o conteúdo das suas requisições, URLs completas nem dados de páginas. Para tratar denúncias de abuso e disputas de cobrança, mantemos metadados de conexão (hora, conta, IP de saída, hostname de destino, bytes) por até 30 dias e depois os excluímos. Mantemos o número da sua conta, pedidos, registros de recarga e totais de tráfego enquanto sua conta estiver aberta e, depois disso, apenas pelo tempo exigido pelas regras contábeis. Divulgamos registros às autoridades somente quando a lei exige. Nosso provedor de rede upstream pode manter seus próprios logs conforme sua própria política.
Posso contratar planos pela API?
Sim, a documentação da API descreve pedidos e recargas. O pagamento em si é sempre uma transferência em cripto a partir da sua carteira.