Este guia mostra como criar uma lista de proxies residenciais com geossegmentação e rotação.
Cada requisição usa sua chave de API pessoal do painel da sua conta (como obter sua chave de API). Nos exemplos abaixo, substitua YOUR_API_KEY pela sua própria chave. Para pagar com o saldo da conta, use paymentId = 1.
Passo 1 — Verifique o pacote
Confirme que o pacote residencial está ativo e tem tráfego. Copie o package_key.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/package
Resposta
{
"status": "success",
"data": {
"rotation": 60,
"traffic_limit": "7516192768",
"traffic_usage": "10",
"traffic_left": "10",
"package_key": "1234567890abcdefedcb",
"expired_at": "d.m.Y",
"is_active": true,
"tarif_id": 2
},
"errors": []
}
Passo 2 — Obtenha as localizações disponíveis
Baixe as localizações disponíveis (país / região / cidade / ISP) para saber os valores GEO exatos. A resposta é um JSON/ZIP com a árvore GEO completa.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/geo
Resposta
[
{
"code": "US",
"name": "United States",
"regions": [
{ "name": "Washington", "cities": [ { "name": "Garfield", "isps": [ "FIRST-STEP" ] } ] }
]
}
]
Passo 3 — Crie a lista
Crie a lista com um título, o objeto geo (do passo 2), as configurações export e um valor de rotação.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
Corpo da requisição
Nome | Tipo | Descrição |
title | String | Nome da lista. |
whitelist (opcional) | String | IPs para autorização. Deixe em branco para login:senha. |
geo | object | Objeto com |
export | object | Objeto: |
rotation | Number | Rotação: |
Exemplo
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
Resposta
{
"status": "success",
"data": {
"id": 561,
"title": "US Washington Garfield FIRST-STEP",
"login": "3c8aa1d4",
"password": "AZT62Dx3",
"geo": { "country": "US", "region": "Washington", "city": "Garfield", "isp": "FIRST-STEP" },
"export": { "ports": 10000, "ext": "txt" }
},
"errors": []
}
Passo 4 — Verifique a nova lista
Liste suas listas residenciais para confirmar a criação e obter os dados de conexão.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/lists
Resposta
{
"status": "success",
"data": [
{ "id": 561, "title": "US Washington", "login": "3c8aa1d4", "rotation": 60 }
],
"errors": []
}