API Documentation

API

Makale içeriği

API ile çalışma sınırlamaları

  • Aynı istekleri 5 saniyede 1’den sık gönderemezsiniz. Sıklık sınırını aşarsanız sunucu şu hatayı döndürür: "Too many lonely requests. Timeout 5 second"
  • API yöntemlerine saniyede en fazla 3*(aktif satın alınmış proxy sayısı) kez başvurabilirsiniz. Sıklık sınırını aşarsanız sunucu şu hatayı döndürür: "Too many requests per second". (10 proxy’niz varsa sınır saniyede 30 istektir, 100 proxy varsa saniyede 300 istek...)

SDK

PHP SDK
Node SDK
Python SDK
OpenAPI Spec

Quick Start

Bu istek, proxy’nizin şu anda hangi IP adresini verdiğini öğrenmenizi sağlar

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 Proxy’nizin IP adresini alma

Bu istek, proxy’nizin şu anda hangi IP adresini verdiğini öğrenmenizi sağlar

Curl isteği
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}'
İstek parametreleri
proxy_id int, int list , *zorunlu — Proxy tanımlayıcısı; birden fazla proxy alınacaksa, bunlar virgülle ayrılarak belirtilir, örneğin: 1,2,3,4
check_spam bool — Eğer check_spam=true parametresi belirtilirse, verilen proxy ip adresinin IPGuardian.net spam adres veri tabanına karşı kontrolü yapılacaktır.: true
JSON yanıtı
{
  "status": "ok",
  "ip": "123.45.67.89",
  "ipguardian.net": { ... }
}

GET Proxy IP adresini değiştirme

Bu istek için yetkilendirme başlığı belirtmeniz gerekmez; IP adresini değiştirme bağlantısını tarayıcıdan çağırmanız yeterlidir; programlı çağrı kullanıyorsanız mutlaka bir tarayıcı User-Agent’ı belirtmelisiniz. Bağlantının kendisini Proxy’lerim tablosunda IP Değiştirme sütununda bulabilirsiniz. Bu komut için saniyede 3 istek API sınırı yoktur.

Curl isteği
curl --request GET --url 'https://changeip.mobileproxy.space/?proxy_key={proxy_key}&format={format}'
İstek parametreleri
proxy_key varchar(32) , *zorunlu — Proxy anahtarı, proxy’lerim bölümünde IP değiştirme bağlantısında yer alır
format string — Yanıt biçimi: json veya 0
JSON yanıtı
{
  "status": "ok",
  "code": 0,
  "new_ip": "1.2.3.4",
  "rt": 1234,
  "message": "...",
  "proxy_id": 123
}

GET Fiyatların alınması

Curl isteği
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'
İstek parametreleri
id_country int, int list — Ülke kimliği (get_id_country komutuyla alınır): 1,2,3,4
currency string — usd, rub (default rub)
type int — Proxy türü: 0 — mobil, 1 — sunucu, 2 — backconnect (varsayılan 0): 0/1/2 (default 0)
JSON yanıtı
{
  "status": "ok",
  "price": [
    {
      "id_country": 1,
      "iso": "RU",
      "amount": 700,
      "country_name": "..",
      "period": 30
    },
    ...
  ]
}

GET Ekipman ve operatör kara listesinin alınması

Curl isteği
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}'
İstek parametreleri
proxy_id int, int list — Proxy tanımlayıcısı; birden fazla proxy alınacaksa, bunlar virgülle ayrılarak belirtilir, örneğin: 1,2,3,4
JSON yanıtı
{
  "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 Operatörü kara listeye ekle

Curl isteği
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}'
İstek parametreleri
proxy_id int — Proxy tanımlayıcısı
operator_id int , *zorunlu — Operatör tanımlayıcısı
JSON yanıtı
{ "status": "ok" }

GET Operatörü kara listeden çıkar

Curl isteği
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}'
İstek parametreleri
proxy_id int, int list — Proxy tanımlayıcısı; birden fazla proxy değiştirilecekse, bunlar virgülle ayrılarak belirtilir, örneğin: 1,2,3,4
operator_id int , *zorunlu — Operatör tanımlayıcısı

Hiçbir parametre belirtilmezse, listenin tamamı temizlenir

JSON yanıtı
{ "status": "ok" }

GET Add equipment to favorites

Curl isteği
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=add_to_favorite&eid={eid}&comment={comment}' \
  --header 'Authorization: Bearer {api_key}'
İstek parametreleri
eid int — Ekipman kimliği
comment string — your note, up to 190 chars, optional

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

JSON yanıtı
{
  "status": "ok"
}

GET Get favorite equipment list

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

GET Remove equipment from favorites

Curl isteği
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=remove_from_favorite&eid={eid}' \
  --header 'Authorization: Bearer {api_key}'
İstek parametreleri
eid int, int list — Ekipman kimliği: 1,2,3. Omit to clear the whole list
JSON yanıtı
{
  "status": "ok"
}

GET Add equipment to black list

Curl isteği
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=add_to_black_list&eid={eid}' \
  --header 'Authorization: Bearer {api_key}'
İstek parametreleri
eid int — Ekipman kimliği
proxy_id int — Proxy tanımlayıcısı; birden fazla proxy değiştirilecekse, bunlar virgülle ayrılarak belirtilir, örneğin, optional
JSON yanıtı
{
  "status": "ok"
}

GET Ekipman kara listesinden kayıtları sil

Curl isteği
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}'
İstek parametreleri
proxy_id int, int list — Proxy tanımlayıcısı; birden fazla proxy değiştirilecekse, bunlar virgülle ayrılarak belirtilir, örneğin: 1,2,3,4
black_list_id int — Kayıt kimliği
eid int — Ekipman kimliği

Hiçbir parametre belirtilmezse, listenin tamamı temizlenir

JSON yanıtı
{ "status": "ok" }

GET Aktif proxylerinizin listesini alma

Curl isteği
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}'
İstek parametreleri
proxy_id int, int list — Proxy tanımlayıcısı; birden fazla proxy alınacaksa, bunlar virgülle ayrılarak belirtilir, örneğin: 1,2,3,4
JSON yanıtı
[
  {
    "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 Proxy'nin giriş ve parolasını değiştirme

Curl isteği
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}'
İstek parametreleri
proxy_id int, int list , *zorunlu — Proxy tanımlayıcısı
proxy_login text , *zorunlu — Kullanıcı adı (yalnızca rakamlar ve Latin harfleri), belirtilmezse otomatik olarak oluşturulur
proxy_pass text , *zorunlu — Şifre (yalnızca rakamlar ve Latin harfleri), belirtilmezse otomatik olarak oluşturulur
JSON yanıtı
{
  "status": "ok",
  "proxy_id": 123,
  "proxy_login": "new",
  "proxy_pass": "pass"
}

GET Proxy'yi yeniden başlatma

Curl isteği
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}'
İstek parametreleri
proxy_id int , *zorunlu — Proxy tanımlayıcısı
JSON yanıtı
{
  "status": "ok",
  "message": "..."
}

GET Yalnızca mevcut ekipmanın GEO ve operatöre göre gruplanmış olarak alınması

Curl isteği
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}'
İstek parametreleri
type int — Proxy türü: 0 — mobil, 1 — sunucu, 2 — backconnect (varsayılan 0): 0/1/2 (auto-detected from proxy_id if omitted)
equipments_back_list isset — Listeden ekipman kara listesindeki içerikleri hariç tut
operators_back_list isset — Listeden operatör kara listesindeki içerikleri hariç tut (type=0 only)
proxy_id int — Proxy tanımlayıcısı; belirtilirse, yanıtta GEO’nun değiştirilebileceği sunucular yer alır (also sets type to this proxy's type unless overridden)
show_count_null bool — Show null count, default false
JSON yanıtı (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 yanıtı (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 isteği
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}'
İstek parametreleri
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 — Listeden ekipman kara listesindeki içerikleri hariç tut
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 yanıtı
{
  "status": "ok",
  "count": 2,
  "free_eid": [
    {
      "eid": 12345,
      "geoid": 42,
      "operator_id": 3,
      "id_country": 13,
      "id_city": 7
    },
    ...
  ]
}

GET Operatör listesini alma

Curl isteği
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}'
İstek parametreleri
geoid int, int list — GEO tanımlayıcıları; belirtilirse, bu GEO için operatörlere göre mevcut port sayısı gösterilir; birden fazla tanımlayıcıyı virgülle ayırarak belirtebilirsiniz: 1,2,3,4
type int — Proxy türü: 0 — mobil, 1 — sunucu, 2 — backconnect (varsayılan 0): 0/1/2 (default 0)
JSON yanıtı
[
  {
    "operator": "MTS",
    "id_country": 1,
    "count_free": 15
  },
  ...
]

GET Ülke listesinin alınması

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'
İstek parametreleri
only_avaliable bool — Bu parametreyi belirtirseniz, yalnızca kiralanabilir ekipmanın bulunduğu ülkeler ve adetleri döner , zorunlu değil
JSON yanıtı
{
  "status": "ok",
  "id_country": { ... }
}

GET Şehir listesinin alınması

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 yanıtı
{
  "status": "ok",
  "id_city": { ... }
}

GET Mevcut GEO listesini alma

Curl isteği
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}'
İstek parametreleri
proxy_id int — Proxy tanımlayıcısı; belirtilirse, yanıtta GEO’nun değiştirilebileceği sunucular yer alır
geoid int, int list — GEO tanımlayıcıları; belirtilirse, bu GEO için operatörlere göre mevcut port sayısı gösterilir; birden fazla tanımlayıcıyı virgülle ayırarak belirtebilirsiniz: 1,2,3,4
type int — Proxy türü: 0 — mobil, 1 — sunucu, 2 — backconnect (varsayılan 0): 0/1/2 (default 0)
JSON yanıtı
[
  {
    "geoid": 10,
    "geo_caption": "Moscow",
    "count_free": 15,
    "iso": "RU",
    "id_city": 1
  },
  ...
]

GET Donanım değişimi

Curl isteği
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}'
İstek parametreleri
proxy_id int, int list , *zorunlu — Proxy tanımlayıcısı; birden fazla proxy değiştirilecekse, bunlar virgülle ayrılarak belirtilir, örneğin: 1,2,3,4
operator varchar — Operatör tanımlayıcısı (zorunlu değil), "Operatör listesini alma" (get_operators_list) fonksiyonundan alınır
geoid int — GEO tanımlayıcısı (zorunlu değil), "Mevcut GEO listesini alma" (get_geo_list) fonksiyonundan alınır
id_country int — Ülke kimliği (get_id_country komutuyla alınır)
id_city int — Şehir kimliği (get_id_city komutuyla alınır)
eid int — Ekipman kimliği
add_to_black_list int — Kullandığınız donanımı kara listeye ekleyin; böylece değişim sırasında bir daha karşınıza çıkmaz. Bu ne işe yarar?: 1/0
check_after_change bool — Bu parametre true olarak ayarlanırsa, ekipman değişikliğinden sonra istek, yeni ekipmandan yeni bir IP adresi talep edecek ve yanıtında döndürecektir
check_spam bool — Eğer check_spam=true parametresi belirtilirse, verilen proxy ip adresinin IPGuardian.net spam adres veri tabanına karşı kontrolü yapılacaktır.: true
JSON yanıtı
{
  "status": "ok",
  "message": { ... },
  "error": { ... },
  "checked": { ... },
  "ipguardian.net": { ... }
}

GET Browser fingerprint oluştur

Curl isteği
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}'
İstek parametreleri
proxy_id int — Aktif proxy'nizin PID'i — «Proxy'lerim» panelindeki sayı, örn. 534167 (proxy parametresine göre önceliklidir). Hesaba aitlik doğrulanır. Belirtilirse, sunucu IP'yi ve ülkeyi proxy'niz aracılığıyla otomatik olarak algılar
proxy varchar — proxy_id belirtilmediğinde rastgele bir proxy. Formatlar: host:port:login:pass, login:pass:host:port, login:pass@host:port, host:port
os varchar — Profilin işletim sistemi: windows | macos | android | ios (varsayılan: windows)
seed varchar — Profilin tekrar üretilebilirliği için isteğe bağlı dize. Aynı ip + country + os + seed aynı profili döndürür
JSON yanıtı
{
  "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", ... ]
  }
}
Olası hatalar
proxy_or_proxy_id_required — ne proxy_id ne de proxy verildi — birini belirtin: proxy_id=534167 (panelden PID) veya proxy=host:port:login:pass
proxy_not_found — proxy_id hesaba ait değil veya proxy aktif değil
proxy_invalid — proxy dizesi ayrıştırılamadı
proxy_connect_failed — sunucu proxy üzerinden bağlanamadı (yanıttaki details alanına bakın)

GET TCP Fingerprint: profil listesi

TCP Fingerprint, anti-fraud sistemlerinin istenen işletim sistemini görmesi için modemin giden TCP paket parametrelerini (TTL, MSS, TCP seçenek sırası) değiştirir — Android, iPhone, Linux, Windows. Browser Fingerprint'i tamamlar: o tarayıcı katmanını (Canvas/WebGL/User-Agent), bu ise ağ katmanını maskeler.

Mobil ve sunucu proxyleri için kullanılabilir.

Curl isteği
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}'
İstek parametreleri
category string — kategoriye göre filtrele: mobile, desktop, linux, custom
JSON yanıtı
{
  "status": "ok",
  "profiles": [
    {
      "profile_id": 3,
      "name": "Android 13",
      "category": "mobile",
      "profile_json": { "ttl": 64, "mss": 1400, "wscale": 8 }
    }
  ]
}

GET TCP Fingerprint: mevcut profil

Curl isteği
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}'
İstek parametreleri
proxy_id int, int list , *zorunlu — proxy ID veya virgülle ayrılmış liste
JSON yanıtı
{
  "status": "ok",
  "proxy": [
    { "proxy_id": 123, "profile_id": 3, "name": "Android 13" },
    { "proxy_id": 124, "profile_id": null, "name": null }
  ]
}

GET TCP Fingerprint: profil uygula

Profil hemen kaydedilir, ekipmana teslim kuyruk üzerinden yapılır ve bir dakikaya kadar sürer.

Curl isteği
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}'
İstek parametreleri
proxy_id int, int list , *zorunlu — proxy ID veya virgülle ayrılmış liste
profile_id int — profil ID; 0 veya belirtilmezse native olarak sıfırlanır
JSON yanıtı
{
  "status": "ok",
  "profile_id": 3,
  "applied": 2,
  "requested": 3,
  "skipped": 1
}

GET TCP Fingerprint: tanılama

Ağda gerçekte ne göründüğünü gösterir ve beklenen profille karşılaştırır. İstek proxynizden geçer ve 25 saniyeye kadar sürebilir, sonuç 60 saniye önbelleğe alınır.

Curl isteği
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}'
İstek parametreleri
proxy_id int , *zorunlu — Proxy tanımlayıcısı
JSON yanıtı
{
  "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 satın alma

Curl isteği
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}'
İstek parametreleri
operator varchar — Operatör tanımlayıcısı (zorunlu değil), "Operatör listesini alma" (get_operators_list) fonksiyonundan alınır
geoid int — GEO tanımlayıcısı (zorunlu değil), "Mevcut GEO listesini alma" (get_geo_list) fonksiyonundan alınır
proxy_id int, int list — Proxy tanımlayıcısı; yalnızca belirli proxy'nin uzatılması durumunda belirtilir; birden fazla proxy uzatılacaksa virgülle ayırarak belirtin, örn.: 1,2,3,4
period int — Proxy'nin satın alınacağı/uzatılacağı süre (varsayılan 30). Olası değerler: 1,7,30,90,365
num int — Satın alma halinde gerekli proxy sayısı (varsayılan 1)
type int — Proxy türü: 0 — mobil, 1 — sunucu, 2 — backconnect (varsayılan 0): 0/1/2
coupons_code varchar — Varsa kupon kodu
id_country int — Ülke kimliği (get_id_country komutuyla alınır)
id_city int — Şehir kimliği (get_id_city komutuyla alınır)
amount_only bool — Bu parametreyi geçirirseniz, satın alma yapılmadan, bakiyeden düşülecek tutar döner
auto_renewal int — Otomatik uzatma. 1 - açık, 0 - kapalı. Varsayılan 1 - açık: 1/0
JSON yanıtı
{
  "status": "ok",
  "proxy_id": [123, 124],
  "amount": 700.00,
  "message": "...",
  "proxy_data": [ ... ]
}

GET Hesap bakiyesini alma

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

GET Mevcut proxy ayarlarını değiştirme

Curl isteği
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}'
İstek parametreleri
proxy_id int, int list , *zorunlu — Proxy tanımlayıcısı; birden fazla proxy değiştirilecekse, bunlar virgülle ayrılarak belirtilir, örneğin: 1,2,3,4
proxy_reboot_time int — Zamanlayıcı için IP değişim süresi (dakika); iptal etmek için 0 gönderin
proxy_ipauth ip list — Kullanıcı adı ve şifre olmadan yetkilendirmeye izin verilen IP adresleri listesi; IPv4'leri virgülle ayırın; iptal için '-1' gönderin. Hem IP listesi hem de alt ağ belirtilmesi desteklenir. Örneğin: 192.168.34.76,123.123.212.0/24
proxy_auto_renewal int — Otomatik uzatma. 1 - açık, 0 - kapalı. Varsayılan 1 - açık: 1/0
proxy_auto_change_equipment int — Otomatik donanım değişimi ayarı; 0 - kapalı, 1 - sınırlama yok, 2 - ülke, 3 - bölge/eyalet/il, 4 - şehir: 0,1,2,3,4
proxy_comment varchar(255) — Text proxy comment
JSON yanıtı
{
  "status": "ok",
  "proxy_id": [123, 124],
  "message": ""
}

GET GEO'ya göre mobil proxy IP adresi istatistikleri 13 сентября 2026 21:10

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

POST Sayfa içeriğini farklı IP’lerden alma

Bu komut, farklı GEO’lar kullanarak bir sayfanın içeriğini görmenizi sağlar; belirtilen ülkelerden sayfayı kontrol etmek için bir görev oluşturur. Ülke kimlikleri belirtilmezse sayfa tüm mevcut ülkelerden istenir. Yanıt olarak bir görev kimliği alırsınız ve tamamlandıktan sonra bu kimlikle sayfanın içeriğini alabilirsiniz.

Curl isteği
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}'
İstek parametreleri
url url , *zorunlu — Kontrol edilecek sayfanın adresi: https://mobileproxy.space
id_country int, int list — Virgülle ayrılmış ülke kimlikleri listesi (get_id_country komutuyla alınır): 1,2,3,4
JSON yanıtı
{
  "status": "ok",
  "message": "...",
  "tasks_id": 123,
  "task_check_url": "https://...",
  "approximate_end_time": "..."
}

GET Görev sonucunu alma

Curl isteği
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}'
İstek parametreleri
tasks_id int — Oluşturma sırasında alınan görev kimliği; belirtilmezse kullanıcının tüm görevlerini döndürür
JSON yanıtı
{
  "status": "ok",
  "tasks": {
    "tasks_id": 123,
    "tasks_start_time": "...",
    "tasks_end_time": "...",
    "tasks_status": 1,
    "tasks_result": "..."
  }
}

GET Ekipmanın müsaitliğini öğrenme

Belirli bir ekipmanın kiralamaya uygun olup olmadığını öğrenebilirsiniz

Curl isteği
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=eid_avaliable&eid={eid}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
İstek parametreleri
eid int, int list , *zorunlu — Ekipman kimliği; bir liste de belirtebilirsiniz, bu durumda kimlikler virgülle ayrılır, örneğin: 1,2,3,4
JSON yanıtı
{
  "status": "ok",
  "eid": {
    "123": 1, (1 = free, 0 = busy)
    "124": 0
  }
}

GET Fon hareket geçmişini al

Curl isteği
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 yanıtı
{
  "status": "ok",
  "history": [ ... ]
}

GET Rezidansal proxy paketleri

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

GET Rezidansal ülkeler

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

GET Konumlar: bölgeler, şehirler, ASN

Curl isteği
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}'
İstek parametreleri
type string — liste türü: regions, cities veya asns
country string — ISO2 ülke kodu, örn. US
region string — bölge kodu, type=cities için zorunlu
JSON yanıtı
[
  { "id": 1455, "code": "georgia", "title_ru": "Джорджия" },
  ...
]

GET Günlük trafik tüketimi

Curl isteği
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}'
İstek parametreleri
proxy_id int
days int — gün cinsinden dönem, 1-365 (varsayılan 30)
JSON yanıtı
[
  { "date": "2026-07-30", "delta_mb": "125.40" },
  ...
]

GET Rezidansal proxy satın al

Curl isteği
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}'
İstek parametreleri
price_id int — residential_plans içindeki paket ID
num int — paket çarpanı, 1-100
country string — ISO2 ülke kodu, örn. US
period int — Kiralama süresi (gün): 1, 7, 30 (varsayılan), 90, 365. Fiyat, sitedekiyle aynı süre katsayısıyla çarpılır
JSON yanıtı
{
  "status": "ok",
  "proxy_id": [ 526059 ],
  "amount": "270",
  "period": "30",
  "traffic_mb": "1000",
  "message": "Residential proxy purchased"
}

GET Trafik ekle

Curl isteği
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}'
İstek parametreleri
proxy_id int
price_id int — residential_plans içindeki paket ID
num int — paket çarpanı, 1-100
JSON yanıtı
{
  "status": "ok",
  "proxy_id": "525819",
  "amount": "270",
  "traffic_added_mb": "1024",
  "message": "Traffic added"
}

GET Bağlantı ayarları (geo ve oturum)

Curl isteği
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}'
İstek parametreleri
proxy_id int — parametresiz — mevcut ayarları okur, parametreli — kaydeder
country, state, city, asn string — residential_locations
session_mode string — rotating / sticky
session_time int — 1-120
JSON yanıtı
{
  "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 değiştirme (residential, sticky oturum)

Curl isteği
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}'
İstek parametreleri
proxy_id int — parametresiz — mevcut ayarları okur, parametreli — kaydeder
Yalnızca sticky oturum modunda çalışır (bkz. residential_settings): rotasyon modunda IP her istekte değişir. Bağlantı bilgileri aynı kalır, oturum sayacı yeniden başlar. Yeni adres hemen belirlenemezse new_ip boş olabilir — IP yine de değiştirilmiştir.
JSON yanıtı
{
  "status": "ok",
  "proxy_id": "525819",
  "new_ip": "203.23.179.163",
  "message": "IP refreshed"
}