Sem KYC — sem documento de identificação, selfie ou documentos
Idioma: Português
Escolher 1 GB

Referência da API

Proxies residenciais e credenciais

Gira subscrições de tráfego (residencial e 4G/5G rotativo por GB): credenciais de proxy, subutilizadores com credenciais e limite de tráfego próprios, utilização diária e locais selecionáveis no nome de utilizador do proxy.

Última atualização: · 10 min de leitura

Endpoints nesta página

  • GET /v1/residential/subscriptions: Listar subscrições de tráfego (residencial e móvel rotativo por GB)
  • GET /v1/residential/subscriptions/{subscriptionId}: Obter uma subscrição residencial
  • PATCH /v1/residential/subscriptions/{subscriptionId}: Alterar o nome ou ativar/desativar a renovação automática
  • POST /v1/residential/subscriptions/{subscriptionId}/reset-password: Gerar uma nova palavra-passe de proxy para o utilizador principal
  • GET /v1/residential/subscriptions/{subscriptionId}/usage: Utilização diária de tráfego
  • GET /v1/residential/subscriptions/{subscriptionId}/sub-users: Listar subutilizadores (credenciais de proxy separadas, com limite de tráfego próprio)
  • POST /v1/residential/subscriptions/{subscriptionId}/sub-users: Criar um subutilizador
  • PATCH /v1/residential/subscriptions/{subscriptionId}/sub-users/{subUserId}: Atualizar um subutilizador (nome, limite, ativar/desativar, nova palavra-passe)
  • DELETE /v1/residential/subscriptions/{subscriptionId}/sub-users/{subUserId}: Eliminar um subutilizador
  • GET /v1/catalog/countries: Países onde um produto está disponível
  • GET /v1/catalog/countries/{countryCode}/cities: Cidades selecionáveis num país
  • GET /v1/catalog/countries/{countryCode}/asns: Fornecedores de Internet selecionáveis (ASN) num país — apenas residencial

URL base https://africaproxies.com/api/v1. Autenticação, erros e limites: consulte a visão geral da API.

Sessões com o mesmo endereço

Acrescente -session-{id}-ttl-{minutes} ao nome de utilizador do proxy para manter o mesmo IP: {id} são 1–32 letras ou algarismos à sua escolha; ttl são 1–30 minutos. O IP pode mudar antes, por exemplo, se o dispositivo que o fornece ficar offline.

Listar subscrições de tráfego (residencial e móvel rotativo por GB)

GET/v1/residential/subscriptions

Autenticação: API chave no cabeçalho Authorization: Bearer API_KEY.

Parâmetros

NomeEmTipoObrigatórioDescrição
productIdqueryresidential · mobile-gbNãoApenas este produto (ausente: ambos).

Resposta 200 OK

{
  "data": [
    {
      "id": "res_9x2m4k",
      "productId": "residential",
      "label": "Residential #1",
      "planId": "res-10",
      "status": "active",
      "trafficTotalBytes": 10000000000,
      "trafficUsedBytes": 2350000000,
      "trafficRemainingBytes": 7650000000,
      "expiresAt": null,
      "autoRenew": false,
      "username": "u7k2m9",
      "password": "PASSWORD",
      "endpoint": {
        "host": "gw.africaproxies.com",
        "httpPort": 7777,
        "socksPort": 7778
      },
      "subUserCount": 1,
      "createdAt": "2026-10-05T14:03:11Z"
    }
  ]
}

Exemplos de código

curl
curl -s "https://africaproxies.com/api/v1/residential/subscriptions" \
  -H "Authorization: Bearer $API_KEY"
Python
import os
import requests

API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.get(f"{API}/residential/subscriptions", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())
Node.js
// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';

const res = await fetch(`${API}/residential/subscriptions`, {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Obter uma subscrição residencial

GET/v1/residential/subscriptions/{subscriptionId}

Autenticação: API chave no cabeçalho Authorization: Bearer API_KEY.

Parâmetros

NomeEmTipoObrigatórioDescrição
subscriptionIdpathstringSim—

Resposta 200 OK

{
  "id": "res_9x2m4k",
  "productId": "residential",
  "label": "Residential #1",
  "planId": "res-10",
  "status": "active",
  "trafficTotalBytes": 10000000000,
  "trafficUsedBytes": 2350000000,
  "trafficRemainingBytes": 7650000000,
  "expiresAt": null,
  "autoRenew": false,
  "username": "u7k2m9",
  "password": "PASSWORD",
  "endpoint": {
    "host": "gw.africaproxies.com",
    "httpPort": 7777,
    "socksPort": 7778
  },
  "subUserCount": 1,
  "createdAt": "2026-10-05T14:03:11Z"
}

Exemplos de código

curl
curl -s "https://africaproxies.com/api/v1/residential/subscriptions/res_9x2m4k" \
  -H "Authorization: Bearer $API_KEY"
Python
import os
import requests

API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.get(f"{API}/residential/subscriptions/res_9x2m4k", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())
Node.js
// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';

const res = await fetch(`${API}/residential/subscriptions/res_9x2m4k`, {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Alterar o nome ou ativar/desativar a renovação automática

PATCH/v1/residential/subscriptions/{subscriptionId}

Autenticação: API chave no cabeçalho Authorization: Bearer API_KEY.

Parâmetros

NomeEmTipoObrigatórioDescrição
subscriptionIdpathstringSim—

Corpo da requisição

CampoTipoObrigatórioDescrição
labelstringNãomáx. 60 caracteres
autoRenewbooleanNão—
Exemplo
{
  "label": "Price monitoring",
  "autoRenew": true
}

Resposta 200 OK

{
  "id": "res_9x2m4k",
  "productId": "residential",
  "label": "Residential #1",
  "planId": "res-10",
  "status": "active",
  "trafficTotalBytes": 10000000000,
  "trafficUsedBytes": 2350000000,
  "trafficRemainingBytes": 7650000000,
  "expiresAt": null,
  "autoRenew": false,
  "username": "u7k2m9",
  "password": "PASSWORD",
  "endpoint": {
    "host": "gw.africaproxies.com",
    "httpPort": 7777,
    "socksPort": 7778
  },
  "subUserCount": 1,
  "createdAt": "2026-10-05T14:03:11Z"
}

Exemplos de código

curl
curl -s -X PATCH "https://africaproxies.com/api/v1/residential/subscriptions/res_9x2m4k" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label":"Price monitoring","autoRenew":true}'
Python
import os
import requests

API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.patch(f"{API}/residential/subscriptions/res_9x2m4k", headers=HEADERS, json={"label": "Price monitoring", "autoRenew": True}, timeout=30)
r.raise_for_status()
print(r.json())
Node.js
// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';

const res = await fetch(`${API}/residential/subscriptions/res_9x2m4k`, {
  method: 'PATCH',
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ label: 'Price monitoring', autoRenew: true }),
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Gerar uma nova palavra-passe de proxy para o utilizador principal

POST/v1/residential/subscriptions/{subscriptionId}/reset-password

A palavra-passe anterior deixa de funcionar no gateway em até 60 segundos.

Autenticação: API chave no cabeçalho Authorization: Bearer API_KEY.

Parâmetros

NomeEmTipoObrigatórioDescrição
subscriptionIdpathstringSim—

Resposta 200 OK

{
  "id": "res_9x2m4k",
  "productId": "residential",
  "label": "Residential #1",
  "planId": "res-10",
  "status": "active",
  "trafficTotalBytes": 10000000000,
  "trafficUsedBytes": 2350000000,
  "trafficRemainingBytes": 7650000000,
  "expiresAt": null,
  "autoRenew": false,
  "username": "u7k2m9",
  "password": "PASSWORD",
  "endpoint": {
    "host": "gw.africaproxies.com",
    "httpPort": 7777,
    "socksPort": 7778
  },
  "subUserCount": 1,
  "createdAt": "2026-10-05T14:03:11Z"
}

Exemplos de código

curl
curl -s -X POST "https://africaproxies.com/api/v1/residential/subscriptions/res_9x2m4k/reset-password" \
  -H "Authorization: Bearer $API_KEY"
Python
import os
import requests

API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.post(f"{API}/residential/subscriptions/res_9x2m4k/reset-password", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())
Node.js
// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';

const res = await fetch(`${API}/residential/subscriptions/res_9x2m4k/reset-password`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Utilização diária de tráfego

GET/v1/residential/subscriptions/{subscriptionId}/usage

Autenticação: API chave no cabeçalho Authorization: Bearer API_KEY.

Parâmetros

NomeEmTipoObrigatórioDescrição
subscriptionIdpathstringSim—
fromquerystring (date)NãoPrimeiro dia (UTC), inclusive. Predefinição = 29 dias antes de to.
toquerystring (date)NãoÚltimo dia (UTC), inclusive. Predefinição = hoje. Intervalo máximo de 366 dias.
subUserIdquerystringNãoRestringir a um subutilizador.

Resposta 200 OK

{
  "from": "2026-10-04",
  "to": "2026-10-05",
  "totalBytes": 2350000000,
  "totalRequests": 48210,
  "points": [
    {
      "date": "2026-10-04",
      "bytes": 1200000000,
      "requests": 24800
    },
    {
      "date": "2026-10-05",
      "bytes": 1150000000,
      "requests": 23410
    }
  ],
  "byCountry": [
    {
      "country": "AE",
      "bytes": 2350000000
    }
  ]
}

Exemplos de código

curl
curl -s "https://africaproxies.com/api/v1/residential/subscriptions/res_9x2m4k/usage" \
  -H "Authorization: Bearer $API_KEY"
Python
import os
import requests

API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.get(f"{API}/residential/subscriptions/res_9x2m4k/usage", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())
Node.js
// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';

const res = await fetch(`${API}/residential/subscriptions/res_9x2m4k/usage`, {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Listar subutilizadores (credenciais de proxy separadas, com limite de tráfego próprio)

GET/v1/residential/subscriptions/{subscriptionId}/sub-users

Autenticação: API chave no cabeçalho Authorization: Bearer API_KEY.

Parâmetros

NomeEmTipoObrigatórioDescrição
subscriptionIdpathstringSim—

Resposta 200 OK

{
  "data": [
    {
      "id": "sub_3m9qk2",
      "label": "Client A",
      "username": "u7k2m9_scraper",
      "password": "PASSWORD",
      "trafficLimitBytes": 5000000000,
      "trafficUsedBytes": 1200000000,
      "enabled": true,
      "createdAt": "2026-10-05T14:03:11Z"
    }
  ],
  "limit": 50
}

Exemplos de código

curl
curl -s "https://africaproxies.com/api/v1/residential/subscriptions/res_9x2m4k/sub-users" \
  -H "Authorization: Bearer $API_KEY"
Python
import os
import requests

API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.get(f"{API}/residential/subscriptions/res_9x2m4k/sub-users", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.json())
Node.js
// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';

const res = await fetch(`${API}/residential/subscriptions/res_9x2m4k/sub-users`, {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Criar um subutilizador

POST/v1/residential/subscriptions/{subscriptionId}/sub-users

Autenticação: API chave no cabeçalho Authorization: Bearer API_KEY.

Parâmetros

NomeEmTipoObrigatórioDescrição
subscriptionIdpathstringSim—

Corpo da requisição

CampoTipoObrigatórioDescrição
labelstringSimmáx. 60 caracteres
passwordstringNãoGerada quando omitida. — máx. 64 caracteres
trafficLimitBytesinteger (int64), nullableNão≥ 0
Exemplo
{
  "label": "Scraper EU",
  "trafficLimitBytes": 5000000000
}

Resposta 201 Created

{
  "id": "sub_3m9qk2",
  "label": "Client A",
  "username": "u7k2m9_scraper",
  "password": "PASSWORD",
  "trafficLimitBytes": 5000000000,
  "trafficUsedBytes": 1200000000,
  "enabled": true,
  "createdAt": "2026-10-05T14:03:11Z"
}

Exemplos de código

curl
curl -s -X POST "https://africaproxies.com/api/v1/residential/subscriptions/res_9x2m4k/sub-users" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label":"Scraper EU","trafficLimitBytes":5000000000}'
Python
import os
import requests

API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.post(f"{API}/residential/subscriptions/res_9x2m4k/sub-users", headers=HEADERS, json={"label": "Scraper EU", "trafficLimitBytes": 5000000000}, timeout=30)
r.raise_for_status()
print(r.json())
Node.js
// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';

const res = await fetch(`${API}/residential/subscriptions/res_9x2m4k/sub-users`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ label: 'Scraper EU', trafficLimitBytes: 5000000000 }),
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Atualizar um subutilizador (nome, limite, ativar/desativar, nova palavra-passe)

PATCH/v1/residential/subscriptions/{subscriptionId}/sub-users/{subUserId}

Autenticação: API chave no cabeçalho Authorization: Bearer API_KEY.

Parâmetros

NomeEmTipoObrigatórioDescrição
subscriptionIdpathstringSim—
subUserIdpathstringSim—

Corpo da requisição

CampoTipoObrigatórioDescrição
labelstringNãomáx. 60 caracteres
trafficLimitBytesinteger (int64), nullableNão≥ 0
enabledbooleanNão—
regeneratePasswordbooleanNão—
Exemplo
{
  "enabled": false
}

Resposta 200 OK

{
  "id": "sub_3m9qk2",
  "label": "Client A",
  "username": "u7k2m9_scraper",
  "password": "PASSWORD",
  "trafficLimitBytes": 5000000000,
  "trafficUsedBytes": 1200000000,
  "enabled": true,
  "createdAt": "2026-10-05T14:03:11Z"
}

Exemplos de código

curl
curl -s -X PATCH "https://africaproxies.com/api/v1/residential/subscriptions/res_9x2m4k/sub-users/sub_3m9qk2" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled":false}'
Python
import os
import requests

API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.patch(f"{API}/residential/subscriptions/res_9x2m4k/sub-users/sub_3m9qk2", headers=HEADERS, json={"enabled": False}, timeout=30)
r.raise_for_status()
print(r.json())
Node.js
// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';

const res = await fetch(`${API}/residential/subscriptions/res_9x2m4k/sub-users/sub_3m9qk2`, {
  method: 'PATCH',
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ enabled: false }),
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Eliminar um subutilizador

DELETE/v1/residential/subscriptions/{subscriptionId}/sub-users/{subUserId}

Autenticação: API chave no cabeçalho Authorization: Bearer API_KEY.

Parâmetros

NomeEmTipoObrigatórioDescrição
subscriptionIdpathstringSim—
subUserIdpathstringSim—

Resposta 204 No Content

Sem corpo: o código de estado é a resposta.

Exemplos de código

curl
curl -s -X DELETE "https://africaproxies.com/api/v1/residential/subscriptions/res_9x2m4k/sub-users/sub_3m9qk2" \
  -H "Authorization: Bearer $API_KEY"
Python
import os
import requests

API = "https://africaproxies.com/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

r = requests.delete(f"{API}/residential/subscriptions/res_9x2m4k/sub-users/sub_3m9qk2", headers=HEADERS, timeout=30)
r.raise_for_status()
print(r.status_code)  # 204: done
Node.js
// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';

const res = await fetch(`${API}/residential/subscriptions/res_9x2m4k/sub-users/sub_3m9qk2`, {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
console.log(res.status); // 204: done

Países onde um produto está disponível

GET/v1/catalog/countries

Público: não é necessária uma chave API.

Parâmetros

NomeEmTipoObrigatórioDescrição
productquerystringNãoRestringir aos locais onde este produto está disponível (residential, mobile, mobile-gb).

Resposta 200 OK

{
  "data": [
    {
      "code": "AE",
      "name": "United Arab Emirates",
      "region": "Asia",
      "products": [
        "residential",
        "mobile",
        "mobile-gb"
      ],
      "cities": 6,
      "asns": 2,
      "carriers": 2
    }
  ]
}

Exemplos de código

curl
curl -s "https://africaproxies.com/api/v1/catalog/countries"
Python
import os
import requests

API = "https://africaproxies.com/api/v1"

r = requests.get(f"{API}/catalog/countries", timeout=30)
r.raise_for_status()
print(r.json())
Node.js
// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';

const res = await fetch(`${API}/catalog/countries`);
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Cidades selecionáveis num país

GET/v1/catalog/countries/{countryCode}/cities

Com product=mobile ou product=mobile-gb, apenas as cidades onde existem modems 4G/5G.

Público: não é necessária uma chave API.

Parâmetros

NomeEmTipoObrigatórioDescrição
countryCodepathstringSimISO 3166-1 alpha-2, em maiúsculas.
productquerystringNãoRestringir aos locais onde este produto está disponível (residential, mobile, mobile-gb).

Resposta 200 OK

{
  "data": [
    {
      "id": "dubai",
      "name": "Dubai",
      "state": null
    }
  ]
}

Exemplos de código

curl
curl -s "https://africaproxies.com/api/v1/catalog/countries/AE/cities"
Python
import os
import requests

API = "https://africaproxies.com/api/v1"

r = requests.get(f"{API}/catalog/countries/AE/cities", timeout=30)
r.raise_for_status()
print(r.json())
Node.js
// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';

const res = await fetch(`${API}/catalog/countries/AE/cities`);
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

Fornecedores de Internet selecionáveis (ASN) num país — apenas residencial

GET/v1/catalog/countries/{countryCode}/asns

Público: não é necessária uma chave API.

Parâmetros

NomeEmTipoObrigatórioDescrição
countryCodepathstringSimISO 3166-1 alpha-2, em maiúsculas.

Resposta 200 OK

{
  "data": [
    {
      "asn": 7922,
      "name": "Comcast Cable"
    }
  ]
}

Exemplos de código

curl
curl -s "https://africaproxies.com/api/v1/catalog/countries/AE/asns"
Python
import os
import requests

API = "https://africaproxies.com/api/v1"

r = requests.get(f"{API}/catalog/countries/AE/asns", timeout=30)
r.raise_for_status()
print(r.json())
Node.js
// Node.js 18+ (built-in fetch), ES module
const API = 'https://africaproxies.com/api/v1';

const res = await fetch(`${API}/catalog/countries/AE/asns`);
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

1 GB US$ 1,23 · Carregamento de saldo a partir de US$ 25

Escolher 1 GB