API Documentation

API

Inhalt des Artikels

Einschränkungen bei der API-Nutzung

  • Identische Anfragen können höchstens einmal alle 5 Sekunden gesendet werden. Wenn Sie das Ratenlimit überschreiten, gibt der Server den Fehler zurück: „Too many lonely requests. Timeout 5 second"
  • API-Methoden können höchstens 3 × (Anzahl aktiver gekaufter Proxys) Mal pro Sekunde aufgerufen werden. Wenn Sie das Ratenlimit überschreiten, gibt der Server den Fehler zurück: „Too many requests per second". (Bei 10 Proxys liegt das Limit bei 30 Anfragen pro Sekunde, bei 100 Proxys bei 300 Anfragen pro Sekunde…)

SDK

PHP SDK
Node SDK
Python SDK
OpenAPI Spec

Quick Start

Diese Anfrage ermöglicht es, die aktuell von Ihrem Proxy vergebene IP-Adresse zu erfahren

curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_my_proxy' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
$ch = curl_init('https://mpsapi.com/api.html?command=get_my_proxy');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer {do_not_working_token_only_for_preview}']
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
import requests
response = requests.get(
    'https://mpsapi.com/api.html',
    params={'command': 'get_my_proxy'},
    headers={'Authorization': 'Bearer {do_not_working_token_only_for_preview}'}
)
result = response.json()
Rate limit: 3 req/sec (×N active proxies). Same request cooldown: 3 sec. HTTP 429 on exceed.

ERRORS Response format & errors

Success
{
  "status": "ok",
  ...
}
Error
{
  "status": "err",
  "message": "Human-readable description of the problem"
}
The HTTP status code is 200 even for errors (the only exception is 429 when the rate limit is exceeded). Always branch on the status field, not on the HTTP code. Some errors add extra fields, e.g. url, details, proxy_type.
Authorization errors
Authorization error #1. No authorization header — the Authorization header is missing
Authorization error #2. No authorization token — the header has no Bearer token
Authorization error #3. Wrong token — token is unknown or revoked
Authorization error #4. Wrong IP — token is used from an IP that is not in your API IP whitelist
Common command errors
NULL proxy_id / NULL eid / NULL IP — a required parameter is missing or not numeric
not enough balance / Low balance. Need X, you have Y — top up the balance to perform the operation
Modem always rented or can not rent — the chosen equipment is already taken or unavailable
Modem not support this command — the rotation/command code is not 1–4
proxy_not_found / proxy_invalid — proxy does not exist or does not belong to you
proxy_connect_failed — could not connect through the proxy (see details, proxy_type)
proxy_or_proxy_id_required — pass either proxy or proxy_id
Only http/https URLs are allowed — the supplied URL scheme is not permitted
No json data / Not valid json data / Invalid JSON — the POST body is missing or malformed
specify at least one filter: id_country, operator_id or geoid — required for get_free_eid_list
Cannot disable equipment #X: N active client rental(s)… — release active rentals first
Good to know when parsing responses: numeric values are often returned as strings (e.g. "15"); proxy_exp is a MySQL DATETIME string (YYYY-MM-DD HH:MM:SS), not a Unix timestamp; and a few legacy commands return status in a different case ("OK") — compare it case-insensitively.

GET IP-Adresse Ihres Proxys abrufen

Diese Anfrage ermöglicht es, die aktuell von Ihrem Proxy vergebene IP-Adresse zu erfahren

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=proxy_ip&proxy_id={proxy_id}{&check_spam=true}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int, int list , *erforderlich — Proxy-ID; um mehrere Proxys abzurufen, werden diese durch Komma getrennt, z. B.: 1,2,3,4
check_spam bool — Wenn der Parameter check_spam=true angegeben ist, wird die vom Proxy ausgegebene IP-Adresse mit der Spam-Adressen-Datenbank von IPGuardian.net abgeglichen.: true
JSON-Antwort
{
  "status": "ok",
  "ip": "123.45.67.89",
  "ipguardian.net": { ... }
}

GET IP-Adresse des Proxys ändern

Diese Anfrage erfordert keinen Authorization-Header: Es genügt, den Link zum IP-Wechsel aus dem Browser aufzurufen. Bei programmatischen Aufrufen muss der User-Agent des Browsers angegeben werden. Den Link selbst finden Sie in der Tabelle Meine Proxys in der Spalte „IP wechseln". Für diesen Befehl gilt das API-Limit von 3 Anfragen pro Sekunde nicht.

Curl-Anfrage
curl --request GET --url 'https://changeip.mobileproxy.space/?proxy_key={proxy_key}&format={format}'
Anfrageparameter
proxy_key varchar(32) , *erforderlich — Proxy-Schlüssel; enthalten im Link zur IP-Änderung im Bereich Meine Proxys
format string — Antwortformat: json oder 0
JSON-Antwort
{
  "status": "ok",
  "code": 0,
  "new_ip": "1.2.3.4",
  "rt": 1234,
  "message": "...",
  "proxy_id": 123
}

GET Preise abrufen

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_price&id_country={id_country}¤cy={currency}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}' \
  --header 'Accept-Language: en'
Anfrageparameter
id_country int, int list — Länder-ID (erhalten über den Befehl get_id_country): 1,2,3,4
currency string — usd, rub (default rub)
type int — Proxy-Typ: 0 — mobil, 1 — Server, 2 — Backconnect (Standard 0): 0/1/2 (default 0)
JSON-Antwort
{
  "status": "ok",
  "price": [
    {
      "id_country": 1,
      "iso": "RU",
      "amount": 700,
      "country_name": "..",
      "period": 30
    },
    ...
  ]
}

GET Sperrliste von Hardware und Betreibern abrufen

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_black_list&proxy_id={proxy_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int, int list — Proxy-ID; um mehrere Proxys abzurufen, werden diese durch Komma getrennt, z. B.: 1,2,3,4
JSON-Antwort
{
  "status": "ok",
  "black_list_equipment": {
    "123": {
      "black_list_id": 123,
      "eid": 456,
      "proxy_id": 789,
      "operator_id": 1,
      "geoid": 10
    }
  },
  "black_list_operators": {
    "1": {
      "operator_black_list_id": 1,
      "proxy_id": 789,
      "operator_id": 1,
      "operator_name": "..",
      "id_country": 1
    }
  }
}

GET Betreiber zur Sperrliste hinzufügen

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=add_operator_to_black_list&proxy_id={proxy_id}&operator_id={operator_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int — Proxy-ID
operator_id int , *erforderlich — Betreiber-ID
JSON-Antwort
{ "status": "ok" }

GET Betreiber aus der Sperrliste entfernen

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=remove_operator_black_list&proxy_id={proxy_id}&operator_id={operator_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int, int list — Proxy-ID; bei Änderung mehrerer Proxys werden diese durch Komma getrennt, z. B.: 1,2,3,4
operator_id int , *erforderlich — Betreiber-ID

Werden keine Parameter angegeben, wird die gesamte Liste geleert

JSON-Antwort
{ "status": "ok" }

GET Add equipment to favorites

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=add_to_favorite&eid={eid}&comment={comment}' \
  --header 'Authorization: Bearer {api_key}'
Anfrageparameter
eid int — Hardware-ID
comment string — your note, up to 190 chars, optional

Favorite equipment is offered first on the next equipment change if it is free.

JSON-Antwort
{
  "status": "ok"
}

GET Get favorite equipment list

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_favorite_list' \
  --header 'Authorization: Bearer {api_key}'
JSON-Antwort
{
  "status": "ok",
  "favorite_equipment": {
    "11389": {
      "eid": "11389",
      "comment": "fast one",
      "operator": "megafone",
      "geo": "Russia, Moscow",
      "busy": 0
    }
  }
}

GET Remove equipment from favorites

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=remove_from_favorite&eid={eid}' \
  --header 'Authorization: Bearer {api_key}'
Anfrageparameter
eid int, int list — Hardware-ID: 1,2,3. Omit to clear the whole list
JSON-Antwort
{
  "status": "ok"
}

GET Add equipment to black list

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=add_to_black_list&eid={eid}' \
  --header 'Authorization: Bearer {api_key}'
Anfrageparameter
eid int — Hardware-ID
proxy_id int — Proxy-ID; bei Änderung mehrerer Proxys werden diese durch Komma getrennt, z. B., optional
JSON-Antwort
{
  "status": "ok"
}

GET Einträge aus der Hardware-Sperrliste entfernen

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=remove_black_list&proxy_id={proxy_id}&black_list_id={black_list_id}&eid={eid}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int, int list — Proxy-ID; bei Änderung mehrerer Proxys werden diese durch Komma getrennt, z. B.: 1,2,3,4
black_list_id int — Eintrags-ID
eid int — Hardware-ID

Werden keine Parameter angegeben, wird die gesamte Liste geleert

JSON-Antwort
{ "status": "ok" }

GET Liste Ihrer aktiven Proxys abrufen

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_my_proxy&proxy_id={proxy_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int, int list — Proxy-ID; um mehrere Proxys abzurufen, werden diese durch Komma getrennt, z. B.: 1,2,3,4
JSON-Antwort
[
  {
    "proxy_id": 123,
    "proxy_exp": "2025-12-31 23:59:59",
    "proxy_login": "abc123",
    "proxy_pass": "xyz789",
    "proxy_hostname": "s1.example.com",
    "proxy_host_ip": "1.2.3.4",
    "proxy_independent_http_hostname": "..",
    "proxy_independent_http_host_ip": "..",
    "proxy_independent_socks5_hostname": "..",
    "proxy_independent_socks5_host_ip": "..",
    "proxy_independent_port": 1234,
    "proxy_http_port": 5000,
    "proxy_socks5_port": 5001,
    "proxy_operator": "MTS",
    "proxy_geo": "Moscow, Russia",
    "proxy_auto_renewal": 1,
    "proxy_change_ip_url": "https://...",
    "proxy_reboot_time": 5,
    "proxy_ipauth": "1.2.3.4",
    "proxy_groups_name": "Group1",
    "proxy_auto_change_equipment": 0,
    "eid": 456,
    "geoid": 10,
    "id_country": 1,
    "proxy_self": 0,
    "proxy_testing": 0,
    "proxy_comment": "My proxy"
  },
  ...
]

GET Login und Passwort des Proxys ändern

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=change_proxy_login_password&proxy_id={proxy_id}&proxy_login={proxy_login}&proxy_pass={proxy_pass}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int, int list , *erforderlich — Proxy-ID
proxy_login text , *erforderlich — Login (nur Ziffern und lateinische Buchstaben), falls nicht angegeben, wird automatisch generiert
proxy_pass text , *erforderlich — Passwort (nur Ziffern und lateinische Buchstaben), falls nicht angegeben, wird automatisch generiert
JSON-Antwort
{
  "status": "ok",
  "proxy_id": 123,
  "proxy_login": "new",
  "proxy_pass": "pass"
}

GET Proxy neu starten

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=reboot_proxy&proxy_id={proxy_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int , *erforderlich — Proxy-ID
JSON-Antwort
{
  "status": "ok",
  "message": "..."
}

GET Nur die verfügbare Hardware abrufen, gruppiert nach GEO und Betreiber

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_geo_operator_list{&type={type}}{&equipments_back_list=1}{&operators_back_list=1}{&show_count_null=1}{&proxy_id={proxy_id}}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
type int — Proxy-Typ: 0 — mobil, 1 — Server, 2 — Backconnect (Standard 0): 0/1/2 (auto-detected from proxy_id if omitted)
equipments_back_list isset — Inhalt der Hardware-Sperrliste aus der Liste ausschließen
operators_back_list isset — Inhalt der Betreiber-Sperrliste aus der Liste ausschließen (type=0 only)
proxy_id int — Proxy-ID; falls angegeben, listet die Antwort die Server auf, zu denen Sie das GEO wechseln können (also sets type to this proxy's type unless overridden)
show_count_null bool — Show null count, default false
JSON-Antwort (type=0)
{
  "status": "ok",
  "geo_operator_list": {
    "10": {
      "geoid": 10,
      "geo_caption": "Moscow",
      "id_city": 1,
      "id_country": 1,
      "count_free": {
        "MTS": 15,
        "Beeline": 8
      }
    },
    ...
  }
}
JSON-Antwort (type=1, type=2)
{
  "status": "ok",
  "geo_operator_list": {
    "42": {
      "geoid": 42,
      "geo_caption": "Frankfurt",
      "id_city": 7,
      "id_country": 13,
      "count_free": 27
    },
    ...
  }
}

GET Free EID list

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_free_eid_list&id_country={id_country}{&operator_id={operator_id}}{&geoid={geoid}}{&type={type}}{&equipments_back_list=1}{&limit={limit}}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
id_country int, int list — Filter by country: 1,13. At least one of id_country / operator_id / geoid is required
operator_id int, int list — Filter by operator (type=0 only)
geoid int, int list — Filter by geo point (partners_modems_id)
type int — 0/1/2, default 0
equipments_back_list isset — Inhalt der Hardware-Sperrliste aus der Liste ausschließen
limit int — Max rows, default 1000, max 10000
The "free" predicate is identical to count_free from get_geo_operator_list, so the number of returned eid matches that catalog counter.
JSON-Antwort
{
  "status": "ok",
  "count": 2,
  "free_eid": [
    {
      "eid": 12345,
      "geoid": 42,
      "operator_id": 3,
      "id_country": 13,
      "id_city": 7
    },
    ...
  ]
}

GET Liste der Betreiber abrufen

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_operators_list&geoid={geoid}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
geoid int, int list — GEO-IDs ; falls angegeben, wird die Anzahl verfügbarer Ports mit Betreibern für dieses GEO ausgegeben. Mehrere IDs können durch Komma getrennt werden.: 1,2,3,4
type int — Proxy-Typ: 0 — mobil, 1 — Server, 2 — Backconnect (Standard 0): 0/1/2 (default 0)
JSON-Antwort
[
  {
    "operator": "MTS",
    "id_country": 1,
    "count_free": 15
  },
  ...
]

GET Liste der Länder abrufen

curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_id_country&only_avaliable=1' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}' \
  --header 'Accept-Language: en'
Anfrageparameter
only_avaliable bool — Wenn dieser Parameter angegeben wird, gibt der Befehl nur Länder mit zur Miete verfügbarer Hardware sowie deren Anzahl zurück , optional
JSON-Antwort
{
  "status": "ok",
  "id_country": { ... }
}

GET Liste der Städte abrufen

curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_id_city' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}' \
  --header 'Accept-Language: en'
JSON-Antwort
{
  "status": "ok",
  "id_city": { ... }
}

GET Liste der verfügbaren GEOs abrufen

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_geo_list&proxy_id={proxy_id}&geoid={geoid}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int — Proxy-ID; falls angegeben, listet die Antwort die Server auf, zu denen Sie das GEO wechseln können
geoid int, int list — GEO-IDs ; falls angegeben, wird die Anzahl verfügbarer Ports mit Betreibern für dieses GEO ausgegeben. Mehrere IDs können durch Komma getrennt werden.: 1,2,3,4
type int — Proxy-Typ: 0 — mobil, 1 — Server, 2 — Backconnect (Standard 0): 0/1/2 (default 0)
JSON-Antwort
[
  {
    "geoid": 10,
    "geo_caption": "Moscow",
    "count_free": 15,
    "iso": "RU",
    "id_city": 1
  },
  ...
]

GET Hardware wechseln

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=change_equipment&proxy_id={proxy_id}&operator={operator}&geoid={geoid}&id_country={id_country}&id_city={id_city}&eid={eid}{&add_to_black_list=1}{&check_after_change=true}{&check_spam=true}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int, int list , *erforderlich — Proxy-ID; bei Änderung mehrerer Proxys werden diese durch Komma getrennt, z. B.: 1,2,3,4
operator varchar — Betreiber-ID (optional), aus der Funktion „Liste der Betreiber abrufen" (get_operators_list)
geoid int — GEO-ID (optional), aus der Funktion „Liste der verfügbaren GEOs abrufen" (get_geo_list)
id_country int — Länder-ID (erhalten über den Befehl get_id_country)
id_city int — Stadt-ID (erhalten über den Befehl get_id_city)
eid int — Hardware-ID
add_to_black_list int — Die verwendete Hardware zur Sperrliste hinzufügen; sie wird Ihnen beim Wechsel nicht mehr angeboten. Wozu dient das?: 1/0
check_after_change bool — Wenn dieser Parameter auf true gesetzt ist, fordert die Anfrage nach dem Gerätewechsel die neue IP-Adresse von der neuen Hardware an und gibt sie in der Antwort zurück
check_spam bool — Wenn der Parameter check_spam=true angegeben ist, wird die vom Proxy ausgegebene IP-Adresse mit der Spam-Adressen-Datenbank von IPGuardian.net abgeglichen.: true
JSON-Antwort
{
  "status": "ok",
  "message": { ... },
  "error": { ... },
  "checked": { ... },
  "ipguardian.net": { ... }
}

GET Browser-Fingerprint generieren

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=fingerprint_generate&proxy_id={proxy_id}{&os=windows}{&seed={seed}}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int — PID Ihres aktiven Proxys — die Nummer aus «Meine Proxys», z. B. 534167 (hat Vorrang vor proxy). Die Zugehörigkeit zum Konto wird überprüft. Wenn angegeben, ermittelt der Server IP und Land automatisch über Ihren Proxy
proxy varchar — Beliebiger Proxy, falls keine proxy_id angegeben ist. Formate: host:port:login:pass, login:pass:host:port, login:pass@host:port, host:port
os varchar — Betriebssystem des Profils: windows | macos | android | ios (Standard: windows)
seed varchar — Optionale Zeichenkette zur Reproduzierbarkeit des Profils. Gleiche ip + country + os + seed liefern dasselbe Profil
JSON-Antwort
{
  "status": "ok",
  "score": 95,
  "profile": {
    "os": "windows",
    "browser": "Chrome 131",
    "geo": { "country_iso": "DE", "locale": "de-DE", "ip": "..." },
    "navigator": { "userAgent": "...", "platform": "Win32", "language": "de-DE", "accept_language": "de-DE,de;q=0.9,en;q=0.8", "hardwareConcurrency": 8, "deviceMemory": 8, ... },
    "screen": { "width": 1920, "height": 1080, "colorDepth": 24, "pixelRatio": 1, ... },
    "timezone": { "name": "Europe/Berlin", "offset": -60 },
    "webgl": { "vendor": "Google Inc.", "renderer": "ANGLE (Intel, ...)" },
    "canvas": { "noiseSeed": "..." },
    "audio": { "contextHash": "..." },
    "fonts": [ "Arial", "Calibri", ... ]
  }
}
Mögliche Fehler
proxy_or_proxy_id_required — weder proxy_id noch proxy wurde angegeben — geben Sie eines davon an: proxy_id=534167 (PID aus dem Kundenbereich) oder proxy=host:port:login:pass
proxy_not_found — proxy_id gehört nicht zum Konto oder der Proxy ist inaktiv
proxy_invalid — die proxy-Zeichenkette konnte nicht analysiert werden
proxy_connect_failed — Server konnte sich nicht über den Proxy verbinden (siehe details in der Antwort)

GET TCP Fingerprint: Profilliste

TCP Fingerprint ändert die Parameter der ausgehenden TCP-Pakete des Modems (TTL, MSS, Reihenfolge der TCP-Optionen), damit Anti-Betrug-Systeme das gewünschte Betriebssystem sehen — Android, iPhone, Linux, Windows. Ergänzt Browser Fingerprint: jenes maskiert die Browser-Schicht (Canvas/WebGL/User-Agent), dieses — die Netzwerkschicht.

Verfügbar für mobile und Server-Proxys.

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=tcp_fp_profiles{&category={category}}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
category string — Filter nach Kategorie: mobile, desktop, linux, custom
JSON-Antwort
{
  "status": "ok",
  "profiles": [
    {
      "profile_id": 3,
      "name": "Android 13",
      "category": "mobile",
      "profile_json": { "ttl": 64, "mss": 1400, "wscale": 8 }
    }
  ]
}

GET TCP Fingerprint: aktuelles Profil

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=tcp_fp_get&proxy_id={proxy_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int, int list , *erforderlich — Proxy-ID oder kommagetrennte Liste
JSON-Antwort
{
  "status": "ok",
  "proxy": [
    { "proxy_id": 123, "profile_id": 3, "name": "Android 13" },
    { "proxy_id": 124, "profile_id": null, "name": null }
  ]
}

GET TCP Fingerprint: Profil anwenden

Das Profil wird sofort gespeichert, die Übertragung an das Gerät läuft über eine Warteschlange und dauert bis zu einer Minute.

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=tcp_fp_apply&proxy_id={proxy_id}&profile_id={profile_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int, int list , *erforderlich — Proxy-ID oder kommagetrennte Liste
profile_id int — Profil-ID; 0 oder weggelassen setzt auf native zurück
JSON-Antwort
{
  "status": "ok",
  "profile_id": 3,
  "applied": 2,
  "requested": 3,
  "skipped": 1
}

GET TCP Fingerprint: Diagnose

Zeigt, was im Netzwerk tatsächlich sichtbar ist, und vergleicht es mit dem erwarteten Profil. Die Anfrage läuft über Ihren Proxy und kann bis zu 25 Sekunden dauern, das Ergebnis wird 60 Sekunden zwischengespeichert.

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=tcp_fp_diagnose&proxy_id={proxy_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int , *erforderlich — Proxy-ID
JSON-Antwort
{
  "status": "ok",
  "proxy_id": 123,
  "observed": { "ttl": 64, "mss": 1400, "wscale": 8, "os_guess": "Android" },
  "expected": { "ttl": 64, "mss": 1400, "wscale": 8 },
  "cached": false
}

GET Proxy-Kauf

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=buyproxy&operator={operator}&geoid={geoid}&proxy_id={proxy_id}&period={period}&num={num}&type={type}&coupons_code={coupons_code}&id_country={id_country}&id_city={id_city}&auto_renewal={auto_renewal}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
operator varchar — Betreiber-ID (optional), aus der Funktion „Liste der Betreiber abrufen" (get_operators_list)
geoid int — GEO-ID (optional), aus der Funktion „Liste der verfügbaren GEOs abrufen" (get_geo_list)
proxy_id int, int list — Proxy-ID, nur bei Verlängerung des betreffenden Proxys angegeben; für mehrere Proxys durch Kommas getrennt, z. B.: 1,2,3,4
period int — Zeitraum für Kauf/Verlängerung des Proxys (Standard 30). Mögliche Werte: 1, 7, 30, 90, 365
num int — Anzahl der benötigten Proxys beim Kauf (Standard 1)
type int — Proxy-Typ: 0 — mobil, 1 — Server, 2 — Backconnect (Standard 0): 0/1/2
coupons_code varchar — Gutscheincode, falls vorhanden
id_country int — Länder-ID (erhalten über den Befehl get_id_country)
id_city int — Stadt-ID (erhalten über den Befehl get_id_city)
amount_only bool — Wenn Sie diesen Parameter übergeben, erhalten Sie den Betrag, der beim Kauf vom Saldo abgebucht würde; der Kauf selbst wird nicht ausgeführt
auto_renewal int — Automatische Verlängerung. 1 — aktiviert, 0 — deaktiviert. Standard: 1 — aktiviert: 1/0
JSON-Antwort
{
  "status": "ok",
  "proxy_id": [123, 124],
  "amount": 700.00,
  "message": "...",
  "proxy_data": [ ... ]
}

GET Kontostand abrufen

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_balance' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
JSON-Antwort
{
  "status": "ok",
  "balance": 1500.00
}

GET Einstellungen eines bestehenden Proxys ändern

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=edit_proxy&proxy_id={proxy_id}&proxy_reboot_time={proxy_reboot_time}&proxy_ipauth={proxy_ipauth}&proxy_comment={proxy_comment}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int, int list , *erforderlich — Proxy-ID; bei Änderung mehrerer Proxys werden diese durch Komma getrennt, z. B.: 1,2,3,4
proxy_reboot_time int — Zeitintervall des IP-Wechsels in Minuten; zum Abbrechen 0 übergeben
proxy_ipauth ip list — Liste der IP-Adressen, von denen die Authentifizierung ohne Login/Passwort erlaubt ist (IPv4 durch Komma getrennt); zum Abbrechen '-1' übergeben. Sowohl IP-Listen als auch Subnetze werden unterstützt. Beispiel: 192.168.34.76, 123.123.212.0/24
proxy_auto_renewal int — Automatische Verlängerung. 1 — aktiviert, 0 — deaktiviert. Standard: 1 — aktiviert: 1/0
proxy_auto_change_equipment int — Konfiguration des automatischen Hardware-Wechsels: 0 — deaktiviert, 1 — uneingeschränkt, 2 — Land, 3 — Region/Gebiet, 4 — Stadt: 0,1,2,3,4
proxy_comment varchar(255) — Text proxy comment
JSON-Antwort
{
  "status": "ok",
  "proxy_id": [123, 124],
  "message": ""
}

GET Aktuelle Statistik der IP-Adressen der Mobilfunk-Proxys nach Region zum 13 сентября 2026 20:07

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_ipstat' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
JSON-Antwort
{
  "status": "ok",
  "ipstat": [ ... ]
}

POST Seiteninhalt von verschiedenen IPs abrufen

Dieser Befehl ermöglicht es, den Seiteninhalt aus verschiedenen GEOs zu sehen ; er erstellt eine Aufgabe zur Prüfung der Seite aus den angegebenen Ländern. Werden keine Länder-IDs angegeben, wird die Seite aus allen verfügbaren Ländern abgerufen. Als Antwort erhalten Sie eine Aufgaben-ID; nach Abschluss können Sie den Seiteninhalt anhand dieser ID abrufen.

Curl-Anfrage
curl --request POST \
  --url 'https://mpsapi.com/api.html?command=see_the_url_from_different_IPs' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}' \
  --data 'url={url}&id_country={id_country}'
Anfrageparameter
url url , *erforderlich — Adresse der zu prüfenden Seite: https://mobileproxy.space
id_country int, int list — Liste der Länder-IDs durch Komma getrennt (erhalten über den Befehl get_id_country): 1,2,3,4
JSON-Antwort
{
  "status": "ok",
  "message": "...",
  "tasks_id": 123,
  "task_check_url": "https://...",
  "approximate_end_time": "..."
}

GET Ergebnis der Aufgabenausführung abrufen

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=tasks&tasks_id={tasks_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
tasks_id int — ID der erstellten Aufgabe ; falls nicht angegeben, werden alle Aufgaben des Nutzers zurückgegeben
JSON-Antwort
{
  "status": "ok",
  "tasks": {
    "tasks_id": 123,
    "tasks_start_time": "...",
    "tasks_end_time": "...",
    "tasks_status": 1,
    "tasks_result": "..."
  }
}

GET Verfügbarkeit der Ausrüstung prüfen

Sie können prüfen, ob bestimmte Ausrüstung zur Miete verfügbar ist

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=eid_avaliable&eid={eid}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
eid int, int list , *erforderlich — Kennung der Ausrüstung; Sie können mehrere durch Komma getrennt angeben, zum Beispiel: 1,2,3,4
JSON-Antwort
{
  "status": "ok",
  "eid": {
    "123": 1, (1 = free, 0 = busy)
    "124": 0
  }
}

GET Verlauf der Geldbewegungen abrufen

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_history&start=0&length=50' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
JSON-Antwort
{
  "status": "ok",
  "history": [ ... ]
}

GET Residential-Tarife

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=residential_plans' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
JSON-Antwort
[
  {
    "price_id": "3",
    "traffic_gb": "10",
    "traffic_mb": "10000",
    "sum": "1800",
    "period_days": "30"
  },
  ...
]

GET Residential-Länder

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=residential_countries' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
JSON-Antwort
[
  { "code": "US", "title": "United States", "title_ru": "США" },
  ...
]

GET Standorte: Regionen, Städte, ASN

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=residential_locations&type={regions|cities|asns}&country={country}{®ion={region}}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
type string — Listentyp: regions, cities oder asns
country string — ISO2-Ländercode, z. B. US
region string — Regionscode, erforderlich für type=cities
JSON-Antwort
[
  { "id": 1455, "code": "georgia", "title_ru": "Джорджия" },
  ...
]

GET Traffic-Verbrauch pro Tag

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=residential_traffic&proxy_id={proxy_id}{&days={days}}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int
days int — Zeitraum in Tagen, 1-365 (Standard 30)
JSON-Antwort
[
  { "date": "2026-07-30", "delta_mb": "125.40" },
  ...
]

GET Residential-Proxys kaufen

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=residential_buy&price_id={price_id}{&num={num}}{&country={country}}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
price_id int — Tarif-ID aus residential_plans
num int — Tarif-Multiplikator, 1-100
country string — ISO2-Ländercode, z. B. US
period int — Mietdauer in Tagen: 1, 7, 30 (Standard), 90, 365. Der Preis wird mit dem Laufzeitkoeffizienten multipliziert, wie auf der Website
JSON-Antwort
{
  "status": "ok",
  "proxy_id": [ 526059 ],
  "amount": "270",
  "period": "30",
  "traffic_mb": "1000",
  "message": "Residential proxy purchased"
}

GET Traffic nachkaufen

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=residential_add_traffic&proxy_id={proxy_id}&price_id={price_id}{&num={num}}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int
price_id int — Tarif-ID aus residential_plans
num int — Tarif-Multiplikator, 1-100
JSON-Antwort
{
  "status": "ok",
  "proxy_id": "525819",
  "amount": "270",
  "traffic_added_mb": "1024",
  "message": "Traffic added"
}

GET Verbindungseinstellungen (Geo und Session)

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=residential_settings&proxy_id={proxy_id}{&country={country}}{&state={state}}{&city={city}}{&asn={asn}}{&session_mode={rotating|sticky}}{&session_time={minutes}}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int — ohne Parameter — aktuelle Einstellungen lesen, mit Parametern — speichern
country, state, city, asn string — residential_locations
session_mode string — rotating / sticky
session_time int — 1-120
JSON-Antwort
{
  "status": "ok",
  "proxy_id": "525819",
  "country": "us",
  "state": "georgia",
  "session_mode": "rotating",
  "http": "http://login-zone-custom-region-us-st-georgia:pass@residential.mobileproxy.space:2333",
  "socks5": "socks5://login-zone-custom-region-us-st-georgia:pass@residential.mobileproxy.space:2333"
}

GET IP-Wechsel (Residential, Sticky-Session)

Curl-Anfrage
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=residential_change_ip&proxy_id={proxy_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Anfrageparameter
proxy_id int — ohne Parameter — aktuelle Einstellungen lesen, mit Parametern — speichern
Funktioniert nur im Sticky-Session-Modus (siehe residential_settings): im Rotationsmodus wechselt die IP bei jeder Anfrage. Die Zugangsdaten bleiben unverändert, der Session-Timer startet neu. new_ip kann leer sein, wenn die neue Adresse nicht sofort ermittelt werden konnte — die IP wurde trotzdem gewechselt.
JSON-Antwort
{
  "status": "ok",
  "proxy_id": "525819",
  "new_ip": "203.23.179.163",
  "message": "IP refreshed"
}