API Documentation

API

Spis treści

Ograniczenia pracy z API

  • Identyczne zapytania można wysyłać nie częściej niż 1 raz na 5 sekund. Jeśli przekroczysz ograniczenie częstotliwości, serwer zwróci błąd: "Too many lonely requests. Timeout 5 second"
  • Do metod API można odwoływać się nie częściej niż 3*(liczba aktywnych kupionych proxy) razy na sekundę. Jeśli przekroczysz ograniczenie częstotliwości, serwer zwróci błąd: "Too many requests per second". (Jeśli masz 10 proxy, to ograniczenie 30 zapytań na sekundę, jeśli 100 proxy to 300 zapytań na sekundę...)

SDK

PHP SDK
Node SDK
Python SDK
OpenAPI Spec

Quick Start

To zapytanie pozwala dowiedzieć się, jaki adres IP w danym momencie wydaje Twoje proxy

curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=get_my_proxy' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
$ch = curl_init('https://mobileproxy.space/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://mobileproxy.space/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.

GET Pobieranie adresu IP Twojego proxy

To zapytanie pozwala dowiedzieć się, jaki adres IP w danym momencie wydaje Twoje proxy

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=proxy_ip&proxy_id={proxy_id}{&check_spam=true}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parametry zapytania
proxy_id int, int list , *obowiązkowy — Identyfikator proxy, jeśli trzeba pobrać kilka proxy, wskazuje się je przez przecinek, na przykład: 1,2,3,4
check_spam bool — Jeśli podać parametr check_spam=true, to nastąpi sprawdzenie wydawanego przez proxy adresu IP w bazie adresów spamowych IPGuardian.net: true
Odpowiedź JSON
{
  "status": "ok",
  "ip": "123.45.67.89",
  "ipguardian.net": { ... }
}

GET Zmiana adresu IP proxy

To zapytanie nie wymaga podania nagłówka z autoryzacją, wystarczy wywołać link do zmiany adresu IP z przeglądarki, jeśli używasz wywołania programowego, to koniecznie trzeba podawać User-agent przeglądarki. Sam link można znaleźć w tabeli Moje proxy w kolumnie Zmiana IP. Dla tej komendy nie ma ograniczeń API w 3 zapytania na sekundę.

Zapytanie Curl
curl --request GET \
  --url 'https://changeip.mobileproxy.space/?proxy_key={proxy_key}&format={format}' \
  --header 'User-Agent: {user-Agent-Name-Here}'
Parametry zapytania
proxy_key varchar(32) , *obowiązkowy — Klucz proxy, znajduje się w linku do zmiany IP w sekcji moje proxy
User-Agent varchar(255) , *obowiązkowy — User-Agent nienależący do bota
format string — Format odpowiedzi: json lub 0
Odpowiedź JSON
{
  "status": "ok",
  "code": 0,
  "new_ip": "1.2.3.4",
  "rt": 1234,
  "message": "...",
  "proxy_id": 123
}

GET Pobieranie cen

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/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'
Parametry zapytania
id_country int, int list — Identyfikator kraju (otrzymany komendą get_id_country): 1,2,3,4
currency string — usd, rub (default rub)
Odpowiedź JSON
{
  "status": "ok",
  "price": [
    {
      "id_country": 1,
      "iso": "RU",
      "amount": 700,
      "country_name": "..",
      "period": 30
    },
    ...
  ]
}

GET Pobieranie czarnej listy sprzętu i operatorów

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=get_black_list&proxy_id={proxy_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parametry zapytania
proxy_id int, int list — Identyfikator proxy, jeśli trzeba pobrać kilka proxy, wskazuje się je przez przecinek, na przykład: 1,2,3,4
Odpowiedź JSON
{
  "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 Dodaj operatora do czarnej listy

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/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}'
Parametry zapytania
proxy_id int — Identyfikator proxy
operator_id int , *obowiązkowy — Identyfikator operatora
Odpowiedź JSON
{ "status": "ok" }

GET Usuń operatora z czarnej listy

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/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}'
Parametry zapytania
proxy_id int, int list — Identyfikator proxy, jeśli trzeba zmienić kilka proxy, wskazuje się je przez przecinek, na przykład: 1,2,3,4
operator_id int , *obowiązkowy — Identyfikator operatora

Jeśli nie podano żadnego parametru, cała lista zostanie wyczyszczona

Odpowiedź JSON
{ "status": "ok" }

GET Usuń wpisy z czarnej listy sprzętu

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/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}'
Parametry zapytania
proxy_id int, int list — Identyfikator proxy, jeśli trzeba zmienić kilka proxy, wskazuje się je przez przecinek, na przykład: 1,2,3,4
black_list_id int — Identyfikator wpisu
eid int — Identyfikator sprzętu

Jeśli nie podano żadnego parametru, cała lista zostanie wyczyszczona

Odpowiedź JSON
{ "status": "ok" }

GET Pobieranie listy Twoich aktywnych proxy

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=get_my_proxy&proxy_id={proxy_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parametry zapytania
proxy_id int, int list — Identyfikator proxy, jeśli trzeba pobrać kilka proxy, wskazuje się je przez przecinek, na przykład: 1,2,3,4
Odpowiedź JSON
[
  {
    "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 Zmiana loginu i hasła proxy

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/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}'
Parametry zapytania
proxy_id int, int list , *obowiązkowy — Identyfikator proxy
proxy_login text , *obowiązkowy — Login (tylko cyfry i litery alfabetu łacińskiego), jeśli nie podać, wygeneruje się automatycznie
proxy_pass text , *obowiązkowy — Hasło (tylko cyfry i litery alfabetu łacińskiego), jeśli nie podać, wygeneruje się automatycznie
Odpowiedź JSON
{
  "status": "ok",
  "proxy_id": 123,
  "proxy_login": "new",
  "proxy_pass": "pass"
}

GET Restart proxy

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=reboot_proxy&proxy_id={proxy_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parametry zapytania
proxy_id int , *obowiązkowy — Identyfikator proxy
Odpowiedź JSON
{
  "status": "ok",
  "message": "..."
}

GET Pobieranie tylko dostępnego sprzętu pogrupowanego po GEO i operatorze

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=get_geo_operator_list{&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}'
Parametry zapytania
equipments_back_list isset — Wykluczyć z listy zawartość czarnej listy sprzętu
operators_back_list isset — Wykluczyć z listy zawartość czarnej listy operatorów
proxy_id int — Identyfikator proxy, jeśli podać, to w odpowiedzi na zapytanie będą wskazane serwery, na które można zmienić GEO
show_count_null bool — Show null count, default false
Odpowiedź JSON
{
  "status": "ok",
  "geo_operator_list": {
    "10": {
      "geoid": 10,
      "geo_caption": "Moscow",
      "id_city": 1,
      "id_country": 1,
      "count_free": {
        "MTS": 15,
        "Beeline": 8
      }
    },
    ...
  }
}

GET Pobieranie listy operatorów

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=get_operators_list&geoid={geoid}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parametry zapytania
geoid int, int list — Identyfikatory GEO, jeśli wskazać, wyświetli liczbę dostępnych portów z operatorami dla tego GEO, można wskazać kilka identyfikatorów przez przecinek: 1,2,3,4
Odpowiedź JSON
[
  {
    "operator": "MTS",
    "id_country": 1,
    "count_free": 15
  },
  ...
]

GET Pobieranie listy krajów

curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=get_id_country&only_avaliable=1' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}' \
  --header 'Accept-Language: en'
Parametry zapytania
only_avaliable bool — Jeśli podać ten parametr, to komenda zwróci tylko kraje z dostępnym do wynajmu sprzętem ze wskazaniem ilości , nieobowiązkowy
Odpowiedź JSON
{
  "status": "ok",
  "id_country": { ... }
}

GET Pobieranie listy miast

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

GET Pobieranie listy dostępnych GEO

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=get_geo_list&proxy_id={proxy_id}&geoid={geoid}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parametry zapytania
proxy_id int — Identyfikator proxy, jeśli podać, to w odpowiedzi na zapytanie będą wskazane serwery, na które można zmienić GEO
geoid int, int list — Identyfikatory GEO, jeśli wskazać, wyświetli liczbę dostępnych portów z operatorami dla tego GEO, można wskazać kilka identyfikatorów przez przecinek: 1,2,3,4
Odpowiedź JSON
[
  {
    "geoid": 10,
    "geo_caption": "Moscow",
    "count_free": 15,
    "iso": "RU",
    "id_city": 1
  },
  ...
]

GET Zmiana sprzętu

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/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}'
Parametry zapytania
proxy_id int, int list , *obowiązkowy — Identyfikator proxy, jeśli trzeba zmienić kilka proxy, wskazuje się je przez przecinek, na przykład: 1,2,3,4
operator varchar — Identyfikator operatora (nieobowiązkowy), pobierany z funkcji "Pobieranie listy operatorów" (get_operators_list)
geoid int — Identyfikator GEO (nieobowiązkowy), pobierany z funkcji "Pobieranie listy dostępnych GEO" (get_geo_list)
id_country int — Identyfikator kraju (otrzymany komendą get_id_country)
id_city int — Identyfikator miasta (otrzymany komendą get_id_city)
eid int — Identyfikator sprzętu
add_to_black_list int — Dodaj używany sprzęt do czarnej listy, nie będzie już Ci się trafiać przy zmianie. Po co to?: 1/0
check_after_change bool — Jeśli podać ten parametr równy true, to zapytanie po zmianie sprzętu zażąda nowego adresu IP na nowym sprzęcie i zwróci go w odpowiedzi
check_spam bool — Jeśli podać parametr check_spam=true, to nastąpi sprawdzenie wydawanego przez proxy adresu IP w bazie adresów spamowych IPGuardian.net: true
Odpowiedź JSON
{
  "status": "ok",
  "message": { ... },
  "error": { ... },
  "checked": { ... },
  "ipguardian.net": { ... }
}

GET Generowanie browser fingerprint

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=fingerprint_generate&proxy_id={proxy_id}{&os=windows}{&seed={seed}}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parametry zapytania
proxy_id int — ID Twojego aktywnego proxy (priorytet). Przynależność do konta jest weryfikowana. Jeśli określone, serwer wykrywa IP i kraj automatycznie przez Twoje proxy
proxy varchar — Dowolny proxy, jeśli proxy_id nie jest określone. Formaty: host:port:login:pass, login:pass:host:port, login:pass@host:port, host:port
os varchar — System operacyjny profilu: windows | macos | android | ios (domyślnie: windows)
seed varchar — Opcjonalny ciąg dla powtarzalności profilu. Te same ip + country + os + seed zwracają ten sam profil
Odpowiedź JSON
{
  "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", ... ]
  }
}
Możliwe błędy
proxy_or_proxy_id_required — nie podano ani proxy_id, ani proxy
proxy_not_found — proxy_id nie należy do konta lub proxy jest nieaktywne
proxy_invalid — nie udało się sparsować ciągu proxy
proxy_connect_failed — serwer nie mógł połączyć się przez proxy (zobacz details w odpowiedzi)

GET Zakup proxy

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=buyproxy&operator={operator}&geoid={geoid}&proxy_id={proxy_id}&period={period}&num={num}&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}'
Parametry zapytania
operator varchar — Identyfikator operatora (nieobowiązkowy), pobierany z funkcji "Pobieranie listy operatorów" (get_operators_list)
geoid int — Identyfikator GEO (nieobowiązkowy), pobierany z funkcji "Pobieranie listy dostępnych GEO" (get_geo_list)
proxy_id int, int list — Identyfikator proxy, wskazywany tylko w przypadku przedłużania potrzebnego proxy, jeśli trzeba przedłużyć kilka proxy, wskazuje się je przez przecinek, na przykład: 1,2,3,4
period int — Okres, na który kupowane/przedłużane jest proxy (domyślnie 30). Możliwe wartości: 1,7,30,90,365
num int — Liczba wymaganych proxy w przypadku zakupu (domyślnie 1)
coupons_code varchar — Kod kuponu w przypadku posiadania
id_country int — Identyfikator kraju (otrzymany komendą get_id_country)
id_city int — Identyfikator miasta (otrzymany komendą get_id_city)
amount_only bool — Jeśli przekazać ten parametr, to zwrócona zostanie kwota, która pobrana zostanie z salda przy zakupie, sam zakup nie zostanie dokonany
auto_renewal int — Autoprzedłużenie. 1 - włączone, 0 - wyłączone. Domyślnie 1 - włączone: 1/0
Odpowiedź JSON
{
  "status": "ok",
  "proxy_id": [123, 124],
  "amount": 700.00,
  "message": "...",
  "proxy_data": [ ... ]
}

GET Pobieranie salda konta

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=get_balance' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Odpowiedź JSON
{
  "status": "ok",
  "balance": 1500.00
}

GET Zmiana ustawień istniejącego proxy

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/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}'
Parametry zapytania
proxy_id int, int list , *obowiązkowy — Identyfikator proxy, jeśli trzeba zmienić kilka proxy, wskazuje się je przez przecinek, na przykład: 1,2,3,4
proxy_reboot_time int — Czas zmiany adresu IP dla timera w minutach, do anulowania należy przekazać 0
proxy_ipauth ip list — Lista adresów IP, z których dozwolona jest autoryzacja bez loginu i hasła, IPv4 przez przecinek, do anulowania należy przekazać '-1', obsługiwana jest zarówno lista adresów IP, jak i wskazywanie podsieci. Na przykład: 192.168.34.76,123.123.212.0/24
proxy_auto_renewal int — Autoprzedłużenie. 1 - włączone, 0 - wyłączone. Domyślnie 1 - włączone: 1/0
proxy_auto_change_equipment int — Konfiguracja automatycznej zmiany sprzętu, 0 - wyłączona, 1 - bez ograniczeń, 2 - kraj, 3 - obwód, region, 4 - miasto: 0,1,2,3,4
proxy_comment varchar(255) — Text proxy comment
Odpowiedź JSON
{
  "status": "ok",
  "proxy_id": [123, 124],
  "message": ""
}

GET Statystyki adresów IP mobilnych proxy według GEO na 19 мая 2026 19:07

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=get_ipstat' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Odpowiedź JSON
{
  "status": "ok",
  "ipstat": [ ... ]
}

POST Pobrać zawartość strony z różnych IP

Ta komenda pozwala zobaczyć zawartość strony używając różnych GEO, komenda tworzy zadanie sprawdzenia strony ze wskazanych krajów. Jeśli nie podawać identyfikatorów krajów, strona zostanie pobrana ze wszystkich dostępnych krajów. W odpowiedzi otrzymasz identyfikator zadania i po zakończeniu wykonania będziesz mógł pobrać zawartość strony po tym identyfikatorze.

Zapytanie Curl
curl --request POST \
  --url 'https://mobileproxy.space/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}'
Parametry zapytania
url url , *obowiązkowy — Adres strony do sprawdzenia: https://mobileproxy.space
id_country int, int list — Lista identyfikatorów krajów przez przecinek (otrzymana komendą get_id_country): 1,2,3,4
Odpowiedź JSON
{
  "status": "ok",
  "message": "...",
  "tasks_id": 123,
  "task_check_url": "https://...",
  "approximate_end_time": "..."
}

GET Pobieranie wyniku wykonania zadania

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=tasks&tasks_id={tasks_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parametry zapytania
tasks_id int — Identyfikator utworzonego zadania, otrzymany przy jego tworzeniu, jeśli nie podawać zwróci wszystkie zadania użytkownika
Odpowiedź JSON
{
  "status": "ok",
  "tasks": {
    "tasks_id": 123,
    "tasks_start_time": "...",
    "tasks_end_time": "...",
    "tasks_status": 1,
    "tasks_result": "..."
  }
}

GET Sprawdzić zajętość sprzętu

Możesz dowiedzieć się czy konkretny sprzęt jest dostępny do wynajmu

Zapytanie Curl
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=eid_avaliable&eid={eid}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Parametry zapytania
eid int, int list , *obowiązkowy — Identyfikator sprzętu, można podać listę wtedy podaje się je przez przecinek, na przykład: 1,2,3,4
Odpowiedź JSON
{
  "status": "ok",
  "eid": {
    "123": 1, (1 = free, 0 = busy)
    "124": 0
  }
}

GET Pobrać historię przepływu środków

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