Dokumentation

Entwicklerdokumentation

Integrationsleitfäden, funktionierende Beispiele und REST-API-Referenz für das mobileproxy.space-Netzwerk für mobile Proxies — Python, Node.js, Go, cURL, Playwright, Selenium.

Schnellstart API-Referenz GitHub

Schnellstart

Starten Sie Ihre erste Proxy-Anfrage in unter einer Minute. Sie benötigen: einen aktiven Proxy in Ihrem Konto und ein API-Token vom Dashboard.

  1. Registrieren Sie sich auf mobileproxy.space.
  2. Bestellen Sie einen Proxy — wählen Sie Land und Betreiber auf der Kaufseite.
  3. Kopieren Sie Ihr API-Token von der API-Seite im eingeloggten Zustand.
  4. Stellen Sie Ihre erste Anfrage — wählen Sie unten eine Sprache.
curl --request GET \ --url 'https://mobileproxy.space/api.html?command=get_my_proxy' \ --header 'Authorization: Bearer YOUR_API_TOKEN'
import requests r = requests.get( "https://mobileproxy.space/api.html", params={"command": "get_my_proxy"}, headers={"Authorization": "Bearer YOUR_API_TOKEN"}, timeout=10, ) print(r.json())
const res = await fetch( "https://mobileproxy.space/api.html?command=get_my_proxy", { headers: { Authorization: "Bearer YOUR_API_TOKEN" } } ); console.log(await res.json());
req, _ := http.NewRequest("GET", "https://mobileproxy.space/api.html?command=get_my_proxy", nil) req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close() body, _ := io.ReadAll(resp.Body) fmt.Println(string(body))
Rate-Limit: 3 req/sec × N aktive Proxies. Cooldown für gleiche Anfrage: 3 Sek. HTTP 429 bei Überschreitung.

Authentifizierung

Alle API-Aufrufe authentifizieren sich mit einem persönlichen Bearer-Token. Das Token ist an Ihr Konto gebunden, nicht an einen einzelnen Proxy.

Wo Sie Ihr Token bekommen

Loggen Sie sich ein und öffnen Sie API. Das Token-Feld ist oben. Sie können das Token jederzeit rotieren — das alte wird sofort widerrufen.

Token senden

Authorization: Bearer YOUR_API_TOKEN

IP-Allowlist (optional)

Für zusätzliche Sicherheit können Sie API-Aufrufe auf eine einzelne IP beschränken. Setzen Sie Erlaubte IP auf der API-Seite. Anfragen von anderen IPs werden auch mit gültigem Token abgelehnt.

Proxy-Authentifizierung selbst

Proxies verwenden entweder Login/Passwort (Standard) oder IP-Autorisierung. Pro Proxy im Dashboard einstellbar. Mit IP-Auth werden keine Anmeldedaten auf der Proxy-Verbindung gesendet.

Grundkonzepte

IPs von Mobilfunkbetreibern

Jeder Proxy im Netzwerk ist ein echtes 4G/5G-Modem, das mit einem echten Mobilfunkbetreiber (MTS, Beeline, T-Mobile, Vodafone usw.) verbunden ist. Zielseiten sehen den Traffic, als käme er von einem normalen Smartphone in einem Mobilfunknetz — nicht aus einem Rechenzentrum.

CGNAT — warum mobile IPs „geteilt" sind

Mobilfunkbetreiber routen Tausende von Abonnenten über dieselbe öffentliche IP via Carrier-Grade NAT. Ein Bann gegen eine einzelne IP würde echte Kunden blockieren, daher behandeln Anti-Fraud-Systeme mobile IPs nachsichtiger als Residential- oder Datacenter-IPs. Das ist der strukturelle Grund für die höheren Trust-Scores mobiler Proxies.

Rotation

Sie ändern die externe IP bei Bedarf durch Auslösen einer Modem-Wiederverbindung:

  • Per Link — GET-Anfrage an eine eindeutige URL (changeip.host/?proxy_key=…) löst die Rotation aus. Gibt die neue IP als JSON zurück.
  • Per Timer — automatische Rotation alle N Minuten (pro Proxy konfigurierbar).
  • Keine (sticky) — IP bleibt erhalten, bis Sie anfragen.

Sticky-Sessions

Eine „sticky"-Session ist einfach ein Proxy mit deaktivierter Rotation (oder langem Timer). Alle Anfragen über diesen Proxy teilen sich eine IP für die Dauer. Nützlich für mehrstufige Flows (Login → Checkout, Parsing über mehrere Seiten einer Session).

Session-Persistenz über Rotationen hinweg

Cookies, localStorage und TLS-Sessions leben auf dem Client — nicht auf dem Proxy. Nach einer Rotation überlebt Ihre bestehende Session im Browser/in der Library; nur die Quell-IP ändert sich.

Integrationen

Sofort einsetzbare Snippets für die häufigsten Stacks. Ersetzen Sie PROXY_HOST, PROXY_PORT, LOGIN, PASSWORD mit den Werten aus get_my_proxy.

import requests proxy = "http://LOGIN:PASSWORD@PROXY_HOST:PROXY_PORT" r = requests.get("https://httpbin.org/ip", proxies={"http": proxy, "https": proxy}, timeout=15) print(r.json())
import { HttpsProxyAgent } from "https-proxy-agent"; const agent = new HttpsProxyAgent("http://LOGIN:PASSWORD@PROXY_HOST:PROXY_PORT"); const res = await fetch("https://httpbin.org/ip", { agent }); console.log(await res.json());
proxyURL, _ := url.Parse("http://LOGIN:PASSWORD@PROXY_HOST:PROXY_PORT") client := &http.Client{Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)}} resp, _ := client.Get("https://httpbin.org/ip") defer resp.Body.Close() body, _ := io.ReadAll(resp.Body) fmt.Println(string(body))
curl -x http://LOGIN:PASSWORD@PROXY_HOST:PROXY_PORT https://httpbin.org/ip # SOCKS5 curl --socks5 LOGIN:PASSWORD@PROXY_HOST:SOCKS_PORT https://httpbin.org/ip
import { chromium } from "playwright"; const browser = await chromium.launch({ proxy: { server: "http://PROXY_HOST:PROXY_PORT", username: "LOGIN", password: "PASSWORD", }, }); const page = await browser.newPage(); await page.goto("https://httpbin.org/ip"); console.log(await page.content()); await browser.close();
from seleniumwire import webdriver opts = {"proxy": { "http": "http://LOGIN:PASSWORD@PROXY_HOST:PROXY_PORT", "https": "http://LOGIN:PASSWORD@PROXY_HOST:PROXY_PORT", "no_proxy": "localhost,127.0.0.1", }} driver = webdriver.Chrome(seleniumwire_options=opts) driver.get("https://httpbin.org/ip") print(driver.page_source) driver.quit()
Offizielle SDKs und vollständige Beispiele auf GitHub: Python · Node · PHP · OpenAPI-Spec.

Anwendungsfälle

Was Entwickler tatsächlich mit mobilen Proxies bauen. Jede Karte ist ein typisches Muster.

Web Scraping

IP-Rotation pro Anfrage oder pro Session, in Kombination mit Browser-Fingerprinting-Tools.

Browser-Automatisierung

Playwright / Selenium mit einem Proxy pro Worker, sticky Sessions für stateful Flows.

Verifikation und QA

Geo-gezielte Inhalte, Preise, A/B-Varianten aus echten Mobilfunknetzen prüfen.

Anzeigen-/SERP-Prüfung

SERP-Scraping, Anzeigen-Platzierungsverifikation, mobile-spezifische Creative-Checks.

SMM und Multi-Account

Ein mobiler Proxy pro Account — das Carrier-Grade-IP-Profil ähnelt am meisten einem echten Nutzer.

Datenpipelines

Background-Worker hinter einem rotierenden Pool, Retries bei Rotation, strukturiertes Error-Logging.

API-Referenz

Die vollständige REST-Referenz — jeder Endpoint, Parameter und Response-Format — lebt auf der dedizierten API-Seite. Sie wird automatisch mit Ihrem Token personalisiert, wenn Sie eingeloggt sind.

Vollständige REST-API-Dokumentation

~15 Endpoints: Proxy-Management, IP-Rotation, Blacklists, Geo-/Betreibersuche, Guthaben.

API-Referenz öffnen

Meistverwendete Endpoints

  • GET /api.html?command=get_my_proxy
  • GET CHANGEIP_HOST/?proxy_key=…
  • GET /api.html?command=proxy_ip&proxy_id=…
  • GET /api.html?command=change_equipment&…
  • GET /api.html?command=get_geo_operator_list

Fehlerbehebung

Top-Probleme, auf die Entwickler stoßen, mit der Standard-Lösung. Vollständige FAQ auf der FAQ-Seite.

Verbindung läuft ab / abgelehnt

Prüfen Sie, ob der Proxy im Dashboard aktiv ist, die IP-Allowlist mit der Ausgangs-IP Ihres Rechners übereinstimmt und Sie den richtigen Port für HTTP vs SOCKS5 verwenden.

Rotation gibt dieselbe IP zurück

Der Betreiber kann dieselbe Adresse neu zuweisen — normal bei kleinen Pools. Lösen Sie die Rotation erneut aus oder wechseln Sie den Betreiber mit change_equipment.

Zielseite zeigt Captcha

Captchas korrelieren mit dem Fingerprint, nicht nur mit der IP. Kombinieren Sie die mobile IP mit einem mobilen User-Agent, mobilem Viewport und einem konsistenten TLS-Profil. Siehe Fingerprint-Generator.

Session läuft unerwartet ab

Auto-Rotation feuert mitten in Ihrer Session. Deaktivieren Sie die Timer-Rotation oder erfassen Sie Cookies/Tokens vor der Rotation.

Geo passt nicht / falsches Land

Mobilfunkbetreiber routen gelegentlich über ausländische Hops. Verifizieren Sie mit proxy_ip und routen Sie bei Bedarf via change_equipment neu.

HTTP 429 von der API

Sie haben das Rate-Limit erreicht. Fügen Sie exponentiellen Backoff hinzu, cachen Sie get_my_proxy-Responses, senden Sie proxy_id-Listen im Batch wo unterstützt.

Best Practices

Retry-Strategie

Wickeln Sie jede Proxy-Anfrage in Retry-with-Jitter (3 Versuche, 500ms–3s). Bei 429 — exponentieller Backoff. Bei Connection-Errors — Rotation vor dem Retry.

Session-Management

Ein Proxy pro logischer Session. Persistieren Sie Cookies/localStorage pro Worker. Teilen Sie niemals einen HTTP-Keep-Alive-Pool über Rotationen hinweg.

Rotationsintervalle

Für Scraping — rotieren Sie pro Anfrage oder alle 30–120 Sek. Für Account-Arbeit — lange Sticky-Sessions (Stunden), Rotation nur bei explizitem Logout/Error.

Browser-Konsistenz

Passen Sie User-Agent an den Betreiber an (4G → mobiler UA). Stellen Sie Zeitzone und Locale auf die Region des Proxies ein. Deaktivieren Sie WebRTC-IP-Leak.

Bans vermeiden

Halten Sie Anfrageraten im menschlichen Bereich. Randomisieren Sie das Timing. Kombinieren Sie mobile IP mit mobilem Fingerprint — nicht mit einem Desktop-Fingerprint.

Observability

Loggen Sie proxy_id, aktuelle IP, Response-Code und Rotationsereignisse zusammen. Wenn etwas kaputt geht, wissen Sie, ob es die IP, der Fingerprint oder das Ziel war.