Kein KYC — kein Ausweis, kein Selfie, keine Dokumente
Sprache: Deutsch
1 GB wählen

API-Referenz

Mobile Ports und IP-Rotation

Dedizierte 4G/5G-Ports: IP sofort oder per Timer ändern, Rotationslink verwenden und Tagesverbrauch lesen.

Zuletzt aktualisiert: · 7 Min. Lesezeit

Endpunkte auf dieser Seite

  • GET /v1/mobile: Mobile Ports auflisten
  • GET /v1/mobile/{portId}: Mobilen Port abrufen
  • PATCH /v1/mobile/{portId}: Umbenennen, automatische Verlängerung umschalten oder automatische Rotation konfigurieren
  • POST /v1/mobile/{portId}/rotate: IP jetzt ändern
  • GET /v1/mobile/{portId}/rotate: Rotationslink (GET mit API-Schlüssel im Query-String)
  • POST /v1/mobile/{portId}/reset-password: Neues Proxy-Passwort für den Port erzeugen
  • GET /v1/mobile/{portId}/usage: Tägliches Datenvolumen des Ports (zur Information: unbegrenzte Daten unter Fair Use)
  • GET /v1/catalog/countries/{countryCode}/carriers: Mobilfunkanbieter mit verfügbaren 4G/5G-Ports in einem Land

Basis-URL https://africaproxies.com/api/v1. Authentifizierung, Fehler und Limits: siehe API-Übersicht.

Mobile Ports auflisten

GET/v1/mobile

Authentifizierung: API Schlüssel im Authorization: Bearer API_KEY Header.

Antwort 200 OK

{
  "data": [
    {
      "id": "mob_2v8k1q",
      "label": "AE Etisalat #1",
      "status": "active",
      "country": "AE",
      "city": null,
      "carrier": "etisalat",
      "carrierName": "Etisalat",
      "networkType": "4G",
      "currentIp": "203.0.113.201",
      "ipChangedAt": "2026-10-05T14:03:11Z",
      "endpoint": {
        "host": "gw.africaproxies.com",
        "httpPort": 7777,
        "socksPort": 7778
      },
      "username": "USERNAME",
      "password": "PASSWORD",
      "rotation": {
        "mode": "interval",
        "intervalMinutes": 10
      },
      "minRotationIntervalSeconds": 30,
      "rotationLink": "https://africaproxies.com/api/v1/mobile/mob_2v8k1q/rotate?key=API_KEY",
      "planId": "mob-30d",
      "autoRenew": false,
      "createdAt": "2026-10-05T14:03:11Z",
      "expiresAt": "2026-11-04T14:03:11Z"
    }
  ]
}

Code-Beispiele

curl
curl -s "https://africaproxies.com/api/v1/mobile" \
  -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}/mobile", 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}/mobile`, {
  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());

Mobilen Port abrufen

GET/v1/mobile/{portId}

Authentifizierung: API Schlüssel im Authorization: Bearer API_KEY Header.

Parameter

NameInTypErforderlichBeschreibung
portIdpathstringJa—

Antwort 200 OK

{
  "id": "mob_2v8k1q",
  "label": "AE Etisalat #1",
  "status": "active",
  "country": "AE",
  "city": null,
  "carrier": "etisalat",
  "carrierName": "Etisalat",
  "networkType": "4G",
  "currentIp": "203.0.113.201",
  "ipChangedAt": "2026-10-05T14:03:11Z",
  "endpoint": {
    "host": "gw.africaproxies.com",
    "httpPort": 7777,
    "socksPort": 7778
  },
  "username": "USERNAME",
  "password": "PASSWORD",
  "rotation": {
    "mode": "interval",
    "intervalMinutes": 10
  },
  "minRotationIntervalSeconds": 30,
  "rotationLink": "https://africaproxies.com/api/v1/mobile/mob_2v8k1q/rotate?key=API_KEY",
  "planId": "mob-30d",
  "autoRenew": false,
  "createdAt": "2026-10-05T14:03:11Z",
  "expiresAt": "2026-11-04T14:03:11Z"
}

Code-Beispiele

curl
curl -s "https://africaproxies.com/api/v1/mobile/mob_2v8k1q" \
  -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}/mobile/mob_2v8k1q", 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}/mobile/mob_2v8k1q`, {
  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());

Umbenennen, automatische Verlängerung umschalten oder automatische Rotation konfigurieren

PATCH/v1/mobile/{portId}

Port umbenennen, automatische Verlängerung ein- oder ausschalten oder einen Rotationstimer zwischen alle 2 Minuten und alle 24 Stunden setzen: "rotation": { "mode": "interval", "intervalMinutes": 10 } (2–1440 Minuten); "mode": "manual" schaltet ihn aus. Sonst behält der Port seine IP bis zur Rotation, obwohl der Mobilfunkanbieter sie gelegentlich selbst ändern kann.

Authentifizierung: API Schlüssel im Authorization: Bearer API_KEY Header.

Parameter

NameInTypErforderlichBeschreibung
portIdpathstringJa—

Anfragekörper

FeldTypErforderlichBeschreibung
labelstringNeinmax. 60 Zeichen
autoRenewbooleanNein—
rotationobjectNeinAutomatischer Rotationstimer: { "mode": "interval", "intervalMinutes": 2–1440 } (zwischen alle 2 Minuten und alle 24 Stunden) oder { "mode": "manual", "intervalMinutes": null }, um nur auf Anforderung zu rotieren.
Beispiel: Automatische Rotation
{
  "rotation": {
    "mode": "interval",
    "intervalMinutes": 10
  }
}
Beispiel: Manuell
{
  "rotation": {
    "mode": "manual",
    "intervalMinutes": null
  }
}

Antwort 200 OK

{
  "id": "mob_2v8k1q",
  "label": "AE Etisalat #1",
  "status": "active",
  "country": "AE",
  "city": null,
  "carrier": "etisalat",
  "carrierName": "Etisalat",
  "networkType": "4G",
  "currentIp": "203.0.113.201",
  "ipChangedAt": "2026-10-05T14:03:11Z",
  "endpoint": {
    "host": "gw.africaproxies.com",
    "httpPort": 7777,
    "socksPort": 7778
  },
  "username": "USERNAME",
  "password": "PASSWORD",
  "rotation": {
    "mode": "interval",
    "intervalMinutes": 10
  },
  "minRotationIntervalSeconds": 30,
  "rotationLink": "https://africaproxies.com/api/v1/mobile/mob_2v8k1q/rotate?key=API_KEY",
  "planId": "mob-30d",
  "autoRenew": false,
  "createdAt": "2026-10-05T14:03:11Z",
  "expiresAt": "2026-11-04T14:03:11Z"
}

Code-Beispiele

curl
curl -s -X PATCH "https://africaproxies.com/api/v1/mobile/mob_2v8k1q" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rotation":{"mode":"interval","intervalMinutes":10}}'
Python
import os
import requests

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

r = requests.patch(f"{API}/mobile/mob_2v8k1q", headers=HEADERS, json={"rotation": {"mode": "interval", "intervalMinutes": 10}}, 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}/mobile/mob_2v8k1q`, {
  method: 'PATCH',
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({ rotation: { mode: 'interval', intervalMinutes: 10 } }),
});
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

IP jetzt ändern

POST/v1/mobile/{portId}/rotate

Jede Rotation verbindet deinen Port erneut mit dem Mobilfunkanbieter, um eine neue IP zu erhalten, und dauert gewöhnlich 5–15 Sekunden. Gelegentlich vergibt der Anbieter dieselbe IP: Rotiere dann erneut. Höchstens einmal alle 30 Sekunden pro Port (minRotationIntervalSeconds): Eine zu früh angeforderte Rotation gibt 429 rotation_too_soon mit Retry-After zurück (Wartezeit in Sekunden).

Authentifizierung: API Schlüssel im Authorization: Bearer API_KEY Header.

Parameter

NameInTypErforderlichBeschreibung
portIdpathstringJa—

Antwort 200 OK

{
  "ip": "203.0.113.201",
  "previousIp": "203.0.113.77",
  "rotatedAt": "2026-10-05T14:03:11Z",
  "nextRotationAvailableAt": "2026-10-05T14:03:41Z"
}

Code-Beispiele

curl
curl -s -X POST "https://africaproxies.com/api/v1/mobile/mob_2v8k1q/rotate" \
  -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}/mobile/mob_2v8k1q/rotate", 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}/mobile/mob_2v8k1q/rotate`, {
  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());

GET/v1/mobile/{portId}/rotate

Wie POST, für Skripte und Lesezeichen: GET https://africaproxies.com/api/v1/mobile/{portId}/rotate?key=API_KEY. Der Schlüssel benötigt die Berechtigung proxies. format=text gibt die neue IP als text/plain zurück.

Authentifizierung: API Schlüssel im key Abfrageparameter (Bereich proxies), sodass der Link von einem Lesezeichen aus funktioniert.

Parameter

NameInTypErforderlichBeschreibung
keyquerystringJaDein API-Schlüssel (Berechtigung proxies).
portIdpathstringJa—
formatqueryjson · textNeinStandard json

Antwort 200 OK

{
  "ip": "203.0.113.201",
  "previousIp": "203.0.113.77",
  "rotatedAt": "2026-10-05T14:03:11Z",
  "nextRotationAvailableAt": "2026-10-05T14:03:41Z"
}

Code-Beispiele

Neues Proxy-Passwort für den Port erzeugen

POST/v1/mobile/{portId}/reset-password

Authentifizierung: API Schlüssel im Authorization: Bearer API_KEY Header.

Parameter

NameInTypErforderlichBeschreibung
portIdpathstringJa—

Antwort 200 OK

{
  "id": "mob_2v8k1q",
  "label": "AE Etisalat #1",
  "status": "active",
  "country": "AE",
  "city": null,
  "carrier": "etisalat",
  "carrierName": "Etisalat",
  "networkType": "4G",
  "currentIp": "203.0.113.201",
  "ipChangedAt": "2026-10-05T14:03:11Z",
  "endpoint": {
    "host": "gw.africaproxies.com",
    "httpPort": 7777,
    "socksPort": 7778
  },
  "username": "USERNAME",
  "password": "PASSWORD",
  "rotation": {
    "mode": "interval",
    "intervalMinutes": 10
  },
  "minRotationIntervalSeconds": 30,
  "rotationLink": "https://africaproxies.com/api/v1/mobile/mob_2v8k1q/rotate?key=API_KEY",
  "planId": "mob-30d",
  "autoRenew": false,
  "createdAt": "2026-10-05T14:03:11Z",
  "expiresAt": "2026-11-04T14:03:11Z"
}

Code-Beispiele

curl
curl -s -X POST "https://africaproxies.com/api/v1/mobile/mob_2v8k1q/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}/mobile/mob_2v8k1q/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}/mobile/mob_2v8k1q/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());

Tägliches Datenvolumen des Ports (zur Information: unbegrenzte Daten unter Fair Use)

GET/v1/mobile/{portId}/usage

Nur zur Information. Unbegrenztes Datenvolumen auf deinem dedizierten Port unter Fair Use: Der Mobilfunkanbieter kann sehr starke Nutzung verlangsamen oder pausieren.

Authentifizierung: API Schlüssel im Authorization: Bearer API_KEY Header.

Parameter

NameInTypErforderlichBeschreibung
portIdpathstringJa—
fromquerystring (date)NeinErster Tag (UTC), einschließlich. Standard = 29 Tage vor to.
toquerystring (date)NeinLetzter Tag (UTC), einschließlich. Standard = heute. Höchstens 366 Tage.

Antwort 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
    }
  ]
}

Code-Beispiele

curl
curl -s "https://africaproxies.com/api/v1/mobile/mob_2v8k1q/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}/mobile/mob_2v8k1q/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}/mobile/mob_2v8k1q/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());

Mobilfunkanbieter mit verfügbaren 4G/5G-Ports in einem Land

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

Öffentlich: kein API-Schlüssel erforderlich.

Parameter

NameInTypErforderlichBeschreibung
countryCodepathstringJaISO 3166-1 alpha-2, Großbuchstaben.

Antwort 200 OK

{
  "data": [
    {
      "id": "etisalat",
      "name": "Etisalat",
      "networkTypes": [
        "4G",
        "5G"
      ],
      "available": true,
      "cities": []
    }
  ]
}

Code-Beispiele

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

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

r = requests.get(f"{API}/catalog/countries/AE/carriers", 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/carriers`);
if (!res.ok) throw new Error((await res.json()).error?.message ?? `HTTP ${res.status}`);
console.log(await res.json());

1 GB 1,23 $ · Kontoguthabenaufladung ab 25 $

1 GB wählen