API Documentation

API

Содержание статьи

Ограничения работы с API

  • Одинаковые запросы можно слать не чаще 1 раза в 5 секунд. Если вы превысите частотное ограничение, сервер вернет ошибку: "Too many lonely requests. Timeout 5 second"
  • К методам API можно обращаться не чаще 3*(количество активных купленных прокси) раз в секунду. Если вы превысите частотное ограничение, сервер вернет ошибку: "Too many requests per second". (Если у вас 10 прокси то ограничение 30 запросов в секунду, если 100 прокси то 300 запросов в секунду...)

Quick Start

Данный запрос позволяет узнать, какой ip-адрес в данный момент выдает ваш прокси

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-адреса вашего прокси

Данный запрос позволяет узнать, какой ip-адрес в данный момент выдает ваш прокси

Запрос Curl
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}'
Параметры запроса
proxy_id int, int list , *обязательный — Идентификатор прокси, если потребуется получить несколько прокси, они указываются через запятую, например: 1,2,3,4
check_spam bool — Если указать параметр check_spam=true, то произойдет проверка выдаваетмого прокси ip адреса по базе спам адресов IPGuardian.net: true
Ответ JSON
{
  "status": "ok",
  "ip": "123.45.67.89",
  "ipguardian.net": { ... }
}

GET Изменение IP-адреса прокси

Данный запрос не требует указания заголовка с авторизацией, вам достаточно вызвать ссылку для смены IP-адреса из браузера, если вы используете программный вызов, то обязательно необходимо указывать User-agent браузера. Саму ссылку можно найти в таблице Мои прокси в столбике Смена IP. Для данной команды нет ограничений API в 3 запроса на секунду.

Запрос Curl
curl --request GET --url 'https://changeip.proxeon.net/?proxy_key={proxy_key}&format={format}'
Параметры запроса
proxy_key varchar(32) , *обязательный — Ключ прокси, содержится в ссылке для смены IP в разделе мои прокси
format string — Формат ответа: json или 0
Ответ JSON
{
  "status": "ok",
  "code": 0,
  "new_ip": "1.2.3.4",
  "rt": 1234,
  "message": "...",
  "proxy_id": 123
}

GET Получение цен

Запрос Curl
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'
Параметры запроса
id_country int, int list — Идентификатор страны (получен командой get_id_country): 1,2,3,4
currency string — usd, rub (default rub)
type int — Тип прокси: 0 — мобильные, 1 — серверные, 2 — бэкконнект (по умолчанию 0): 0/1/2 (default 0)
Ответ JSON
{
  "status": "ok",
  "price": [
    {
      "id_country": 1,
      "iso": "RU",
      "amount": 700,
      "country_name": "..",
      "period": 30
    },
    ...
  ]
}

GET Получение черного списка оборудования и операторов

Запрос Curl
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}'
Параметры запроса
proxy_id int, int list — Идентификатор прокси, если потребуется получить несколько прокси, они указываются через запятую, например: 1,2,3,4
Ответ 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 Добавить оператора в черный список

Запрос Curl
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}'
Параметры запроса
proxy_id int — Идентификатор прокси
operator_id int , *обязательный — Идентификатор оператора
Ответ JSON
{ "status": "ok" }

GET Удалить оператора из черного списка

Запрос Curl
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}'
Параметры запроса
proxy_id int, int list — Идентификатор прокси, если потребуется изменить несколько прокси, они указываются через запятую, например: 1,2,3,4
operator_id int , *обязательный — Идентификатор оператора

Если не указан ни один параметр, очистится весь список

Ответ JSON
{ "status": "ok" }

GET Add equipment to favorites

Запрос Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=add_to_favorite&eid={eid}&comment={comment}' \
  --header 'Authorization: Bearer {api_key}'
Параметры запроса
eid int — Идентификатор оборудования
comment string — your note, up to 190 chars, optional

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

Ответ JSON
{
  "status": "ok"
}

GET Get favorite equipment list

Запрос Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_favorite_list' \
  --header 'Authorization: Bearer {api_key}'
Ответ JSON
{
  "status": "ok",
  "favorite_equipment": {
    "11389": {
      "eid": "11389",
      "comment": "fast one",
      "operator": "megafone",
      "geo": "Russia, Moscow",
      "busy": 0
    }
  }
}

GET Remove equipment from favorites

Запрос Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=remove_from_favorite&eid={eid}' \
  --header 'Authorization: Bearer {api_key}'
Параметры запроса
eid int, int list — Идентификатор оборудования: 1,2,3. Omit to clear the whole list
Ответ JSON
{
  "status": "ok"
}

GET Add equipment to black list

Запрос Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=add_to_black_list&eid={eid}' \
  --header 'Authorization: Bearer {api_key}'
Параметры запроса
eid int — Идентификатор оборудования
proxy_id int — Идентификатор прокси, если потребуется изменить несколько прокси, они указываются через запятую, например, optional
Ответ JSON
{
  "status": "ok"
}

GET Удалить записи из черного списка оборудования

Запрос Curl
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}'
Параметры запроса
proxy_id int, int list — Идентификатор прокси, если потребуется изменить несколько прокси, они указываются через запятую, например: 1,2,3,4
black_list_id int — Идентификатор записи
eid int — Идентификатор оборудования

Если не указан ни один параметр, очистится весь список

Ответ JSON
{ "status": "ok" }

GET Получение списка ваших активных прокси

Запрос Curl
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}'
Параметры запроса
proxy_id int, int list — Идентификатор прокси, если потребуется получить несколько прокси, они указываются через запятую, например: 1,2,3,4
Ответ 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 Изменение логина и пароля прокси

Запрос Curl
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}'
Параметры запроса
proxy_id int, int list , *обязательный — Идентификатор прокси
proxy_login text , *обязательный — Логин (только цифры и буквы латинского алфавита), если не указать, сгенерируется автоматически
proxy_pass text , *обязательный — Пароль (только цифры и буквы латинского алфавита), если не указать, сгенерируется автоматически
Ответ JSON
{
  "status": "ok",
  "proxy_id": 123,
  "proxy_login": "new",
  "proxy_pass": "pass"
}

GET Перезагрузка прокси

Запрос Curl
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}'
Параметры запроса
proxy_id int , *обязательный — Идентификатор прокси
Ответ JSON
{
  "status": "ok",
  "message": "..."
}

GET Получение только доступного оборудования сгруппированного по ГЕО и оператору

Запрос Curl
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}'
Параметры запроса
type int — Тип прокси: 0 — мобильные, 1 — серверные, 2 — бэкконнект (по умолчанию 0): 0/1/2 (auto-detected from proxy_id if omitted)
equipments_back_list isset — Исключить из списка содержимое черного списка оборудования
operators_back_list isset — Исключить из списка содержимое черного списка операторов (type=0 only)
proxy_id int — Идентификатор прокси, если указать, то в ответе на запрос будут указаны сервера, на которые можно сменить ГЕО (also sets type to this proxy's type unless overridden)
show_count_null bool — Show null count, default false
Ответ JSON (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 (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
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}'
Параметры запроса
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 — Исключить из списка содержимое черного списка оборудования
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
{
  "status": "ok",
  "count": 2,
  "free_eid": [
    {
      "eid": 12345,
      "geoid": 42,
      "operator_id": 3,
      "id_country": 13,
      "id_city": 7
    },
    ...
  ]
}

GET Получение списка операторов

Запрос Curl
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}'
Параметры запроса
geoid int, int list — Идентификаторы ГЕО, если указать, выведет количество доступных портов с операторами по данному ГЕО, можно указать несколько идентификаторов через запятую: 1,2,3,4
type int — Тип прокси: 0 — мобильные, 1 — серверные, 2 — бэкконнект (по умолчанию 0): 0/1/2 (default 0)
Ответ JSON
[
  {
    "operator": "MTS",
    "id_country": 1,
    "count_free": 15
  },
  ...
]

GET Получение списка стран

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'
Параметры запроса
only_avaliable bool — Если указать этот параметр, то команда вернет только страны с доступным для аренды оборудованием с указанием количества , необязательный
Ответ JSON
{
  "status": "ok",
  "id_country": { ... }
}

GET Получение списка городов

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

GET Получение списка доступных ГЕО

Запрос Curl
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}'
Параметры запроса
proxy_id int — Идентификатор прокси, если указать, то в ответе на запрос будут указаны сервера, на которые можно сменить ГЕО
geoid int, int list — Идентификаторы ГЕО, если указать, выведет количество доступных портов с операторами по данному ГЕО, можно указать несколько идентификаторов через запятую: 1,2,3,4
type int — Тип прокси: 0 — мобильные, 1 — серверные, 2 — бэкконнект (по умолчанию 0): 0/1/2 (default 0)
Ответ JSON
[
  {
    "geoid": 10,
    "geo_caption": "Moscow",
    "count_free": 15,
    "iso": "RU",
    "id_city": 1
  },
  ...
]

GET Смена оборудования

Запрос Curl
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}'
Параметры запроса
proxy_id int, int list , *обязательный — Идентификатор прокси, если потребуется изменить несколько прокси, они указываются через запятую, например: 1,2,3,4
operator varchar — Идентификатор оператора(не обязательный), берется из функции "Получение списка операторов" (get_operators_list)
geoid int — Идентификатор ГЕО (не обязательный), берется из функции "Получение списка доступных ГЕО" (get_geo_list)
id_country int — Идентификатор страны (получен командой get_id_country)
id_city int — Идентификатор города (получен командой get_id_city)
eid int — Идентификатор оборудования
add_to_black_list int — Добавить используемое оборудование в черный список, оно больше не будет попадаться вам при смене. Для чего это?: 1/0
check_after_change bool — Если указать данный параметр равный true, то запрос после смены обоурдования запросит новый ip адрес на новом оборудовании и вернет его в ответе
check_spam bool — Если указать параметр check_spam=true, то произойдет проверка выдаваетмого прокси ip адреса по базе спам адресов IPGuardian.net: true

Передавайте либо geoid (конкретную точку), либо id_country + id_city, но не то и другое сразу: geoid имеет приоритет и перекрывает страну и город. Тип точки должен совпадать с типом прокси (0 мобильный, 1 серверный, 2 backconnect). Идентификаторы точек отдаёт get_geo_list, идентификаторы городов — get_id_city.

Ответ JSON
{
  "status": "ok",
  "message": { ... },
  "error": { ... },
  "checked": { ... },
  "ipguardian.net": { ... }
}

GET Генерация browser fingerprint

Запрос Curl
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}'
Параметры запроса
proxy_id int — PID вашего активного прокси — число из кабинета «Мои прокси», например 534167 (приоритет над proxy). Проверяется принадлежность аккаунту. Если задан, сервер определит IP и страну автоматически через ваш прокси
proxy varchar — Произвольный прокси, если не указан proxy_id. Форматы: host:port:login:pass, login:pass:host:port, login:pass@host:port, host:port
os varchar — Операционная система профиля: windows | macos | android | ios (по умолчанию windows)
seed varchar — Необязательная строка для воспроизводимости профиля. При одинаковых ip + country + os + seed возвращается один и тот же профиль
Ответ JSON
{
  "status": "ok",
  "score": 95,
  "profile": {
    "os": "windows",
    "browser": "chrome",
    "browser_version": "154.0.0.0",
    "geo": { "country_iso": "DE", "locale": "de-DE", "ip": "..." },
    "navigator": { "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) ... Chrome/154.0.0.0 Safari/537.36", "platform": "Win32", "language": "de-DE", "accept_language": "de-DE,de;q=0.9,en;q=0.8", "hardwareConcurrency": 8, "deviceMemory": 8, "maxTouchPoints": 0,
      "userAgentData": { "mobile": false, "platform": "Windows" }, ... },
    "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", ... ],
    "_meta": { "version": "2.0", "engine": "chromium", "tcp_match": "windows_11", "tcp_profile": "windows_11" }
  }
}

Профили Windows, macOS и Android — это Chrome; в navigator.userAgentData для них лежат значения Client Hints (на Android реальные модель устройства и версия ОС есть только там — строка User-Agent урезана до «Android 10; K»). Профили iOS — это Safari: deviceMemory равен null, userAgentData нет, и ни один антидетект на базе Chromium не воспроизведёт такой профиль достоверно. _meta.tcp_match — TCP-профиль, соответствующий ОС браузера.

Возможные ошибки
proxy_or_proxy_id_required — не передан ни proxy_id, ни proxy — укажите одно из двух: proxy_id=534167 (PID из кабинета) либо proxy=host:port:login:pass
proxy_not_found — proxy_id не принадлежит аккаунту или прокси не активен
proxy_invalid — не удалось распарсить строку proxy
proxy_connect_failed — сервер не смог подключиться через прокси (см. details в ответе)

GET TCP Fingerprint: список профилей

TCP Fingerprint меняет параметры исходящих сетевых пакетов модема (TTL, MSS, порядок TCP options), чтобы антифрод-системы видели нужную ОС — Android, iPhone, Linux, Windows. Дополняет Browser Fingerprint: тот маскирует слой браузера (Canvas/WebGL/User-Agent), а этот — слой сети.

Доступно для мобильных и серверных прокси.

Запрос Curl
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}'
Параметры запроса
category string — фильтр по категории: mobile, desktop, linux, custom
Ответ JSON
{
  "status": "ok",
  "profiles": [
    {
      "profile_id": 3,
      "name": "Android 13",
      "category": "mobile",
      "profile_json": { "ttl": 64, "mss": 1400, "wscale": 8 }
    }
  ]
}

GET TCP Fingerprint: текущий профиль

Запрос Curl
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}'
Параметры запроса
proxy_id int, int list , *обязательный — ID прокси или список через запятую
Ответ JSON
{
  "status": "ok",
  "proxy": [
    { "proxy_id": 123, "profile_id": 3, "name": "Android 13" },
    { "proxy_id": 124, "profile_id": null, "name": null }
  ]
}

GET TCP Fingerprint: применить профиль

Профиль сохраняется сразу, доставка на оборудование идёт очередью и занимает до минуты.

Запрос Curl
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}'
Параметры запроса
proxy_id int, int list , *обязательный — ID прокси или список через запятую
profile_id int — ID профиля; 0 или не указан — сброс на native
Ответ JSON
{
  "status": "ok",
  "profile_id": 3,
  "applied": 2,
  "requested": 3,
  "skipped": 1
}

GET TCP Fingerprint: диагностика

Показывает, что реально видно в сети, и сверяет с ожидаемым профилем. Запрос идёт через ваш прокси и может занять до 25 секунд, результат кэшируется на 60 секунд.

Запрос Curl
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}'
Параметры запроса
proxy_id int , *обязательный — Идентификатор прокси
Ответ JSON
{
  "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 Покупка прокси

Запрос Curl
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}'
Параметры запроса
operator varchar — Идентификатор оператора(не обязательный), берется из функции "Получение списка операторов" (get_operators_list)
geoid int — Идентификатор ГЕО (не обязательный), берется из функции "Получение списка доступных ГЕО" (get_geo_list)
proxy_id int, int list — Идентификатор прокси, указывается только в случае продления нужного прокси, если потребуется продлить несколько прокси, они указываются через запятую, например: 1,2,3,4
period int — Период, на который приобретается/продляется прокси (по умолчанию 30). Возможные значения: 1,7,30,90,365
num int — Количество требуемых прокси в случае покупки (по умолчанию 1)
type int — Тип прокси: 0 — мобильные, 1 — серверные, 2 — бэкконнект (по умолчанию 0): 0/1/2
coupons_code varchar — Код купона в случае наличия
id_country int — Идентификатор страны (получен командой get_id_country)
id_city int — Идентификатор города (получен командой get_id_city)
amount_only bool — Если передать данный параметр, то вам вернется сумма, которая спишется с баланса при покупке, сама покупка совершена не будет
auto_renewal int — Автопродление. 1 - включено, 0 - выключено. По умолчанию 1 - включено: 1/0
Ответ JSON
{
  "status": "ok",
  "proxy_id": [123, 124],
  "amount": 700.00,
  "message": "...",
  "proxy_data": [ ... ]
}

GET Получение баланса аккаунта

Запрос Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_balance' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Ответ JSON
{
  "status": "ok",
  "balance": 1500.00
}

GET Изменение настроек существующего прокси

Запрос Curl
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}'
Параметры запроса
proxy_id int, int list , *обязательный — Идентификатор прокси, если потребуется изменить несколько прокси, они указываются через запятую, например: 1,2,3,4
proxy_reboot_time int — Время смены ip-адреса для таймера в минутах, для отмены необходимо передать 0
proxy_ipauth ip list — Список ip-адресов, с которых разрешена авторизация без логина и пароля, IPv4 через запятую, для отмены нужно передать '-1', поддерживается как список ip-адресов, так и указание подсетей. Например: 192.168.34.76,123.123.212.0/24
proxy_auto_renewal int — Автопродление. 1 - включено, 0 - выключено. По умолчанию 1 - включено: 1/0
proxy_auto_change_equipment int — Настройка автоматической смены оборудования, 0 - отключена, 1 - не ограничивать, 2 - страна, 3 - область, край, регион, 4 - город: 0,1,2,3,4
proxy_comment varchar(255) — Text proxy comment
Ответ JSON
{
  "status": "ok",
  "proxy_id": [123, 124],
  "message": ""
}

GET Статистика IP-адресов мобильных прокси по ГЕО на 12 ноября 2026 13:08

Запрос Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=get_ipstat' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Ответ JSON
{
  "status": "ok",
  "ipstat": [ ... ]
}

POST Получить содержимое страницы с разных IP

Данная команда позволяет увидеть содержимое страницы используя разные ГЕО, команда создает задачу на проверку страницы из указанных стран. Если не указывать идентификаторы стран, страница будет запрошена из всех доступных стран. В ответ вы получите идентификатор задачи и после окончания выполнения вы сможете получить содержимое страницы по этому идентификатору.

Запрос Curl
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}'
Параметры запроса
url url , *обязательный — Адрес страницы для проверки: https://proxeon.net
id_country int, int list — Список идентификаторов стран через запятую (получен командой get_id_country): 1,2,3,4
Ответ JSON
{
  "status": "ok",
  "message": "...",
  "tasks_id": 123,
  "task_check_url": "https://...",
  "approximate_end_time": "..."
}

GET Получение результата выполнения задачи

Запрос Curl
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}'
Параметры запроса
tasks_id int — Идентификатор созданной задачи, полученный при ее создании, если не указывать вернет все задачи пользователя
Ответ JSON
{
  "status": "ok",
  "tasks": {
    "tasks_id": 123,
    "tasks_start_time": "...",
    "tasks_end_time": "...",
    "tasks_status": 1,
    "tasks_result": "..."
  }
}

GET Выяснить занятость оборудования

Вы можете узнать доступно ли для аренды конкретное оборудование

Запрос Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=eid_avaliable&eid={eid}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Параметры запроса
eid int, int list , *обязательный — Идентификатор оборудования, можно указать список тогда они указываются через запятую, например: 1,2,3,4
Ответ JSON
{
  "status": "ok",
  "eid": {
    "123": 1, (1 = free, 0 = busy)
    "124": 0
  }
}

GET Получить историю движения средств

Запрос Curl
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
{
  "status": "ok",
  "history": [ ... ]
}

GET Тарифы резидентных прокси

Запрос Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=residential_plans' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Ответ JSON
[
  {
    "price_id": "3",
    "traffic_gb": "10",
    "traffic_mb": "10000",
    "sum": "1800",
    "period_days": "30"
  },
  ...
]

GET Страны резидентных прокси

Запрос Curl
curl --request GET \
  --url 'https://mpsapi.com/api.html?command=residential_countries' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Ответ JSON
[
  { "code": "US", "title": "United States", "title_ru": "США" },
  ...
]

GET Локации: регионы, города, ASN

Запрос Curl
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}'
Параметры запроса
type string — тип справочника: regions, cities или asns
country string — код страны ISO2, например US
region string — код региона, обязателен для type=cities
Ответ JSON
[
  { "id": 1455, "code": "georgia", "title_ru": "Джорджия" },
  ...
]

GET Расход трафика по дням

Запрос Curl
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}'
Параметры запроса
proxy_id int
days int — период в днях, 1-365 (по умолчанию 30)
Ответ JSON
[
  { "date": "2026-07-30", "delta_mb": "125.40" },
  ...
]

GET Купить резидентные прокси

Запрос Curl
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}'
Параметры запроса
price_id int — ID тарифа из residential_plans
num int — множитель тарифа, 1-100
country string — код страны ISO2, например US
period int — Срок аренды в днях: 1, 7, 30 (по умолчанию), 90, 365. Цена умножается на коэффициент срока — тот же, что на сайте
Ответ JSON
{
  "status": "ok",
  "proxy_id": [ 526059 ],
  "amount": "270",
  "period": "30",
  "traffic_mb": "1000",
  "message": "Residential proxy purchased"
}

GET Докупить трафик

Запрос Curl
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}'
Параметры запроса
proxy_id int
price_id int — ID тарифа из residential_plans
num int — множитель тарифа, 1-100
Ответ JSON
{
  "status": "ok",
  "proxy_id": "525819",
  "amount": "270",
  "traffic_added_mb": "1024",
  "message": "Traffic added"
}

GET Настройки подключения (гео и сессия)

Запрос Curl
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}'
Параметры запроса
proxy_id int — без параметров — чтение текущих настроек, с параметрами — сохранение
country, state, city, asn string — residential_locations
session_mode string — rotating / sticky
session_time int — 1-120
Ответ JSON
{
  "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 (residential, sticky-сессия)

Запрос Curl
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}'
Параметры запроса
proxy_id int — без параметров — чтение текущих настроек, с параметрами — сохранение
Работает только в режиме sticky-сессии (см. residential_settings): в режиме ротации IP меняется на каждом запросе. Реквизиты подключения не меняются, таймер сессии обнуляется. new_ip может быть пустым, если новый адрес не удалось определить сразу — IP при этом всё равно сменён.
Ответ JSON
{
  "status": "ok",
  "proxy_id": "525819",
  "new_ip": "203.23.179.163",
  "message": "IP refreshed"
}