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() ERRORS Response format & errors
Success
{
"status": "ok",
...
} Error
{
"status": "err",
"message": "Human-readable description of the problem"
} 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 missingAuthorization error #2. No authorization token — the header has no Bearer tokenAuthorization error #3. Wrong token — token is unknown or revokedAuthorization error #4. Wrong IP — token is used from an IP that is not in your API IP whitelistCommon command errors
NULL proxy_id / NULL eid / NULL IP — a required parameter is missing or not numericnot enough balance / Low balance. Need X, you have Y — top up the balance to perform the operationModem always rented or can not rent — the chosen equipment is already taken or unavailableModem not support this command — the rotation/command code is not 1–4proxy_not_found / proxy_invalid — proxy does not exist or does not belong to youproxy_connect_failed — could not connect through the proxy (see details, proxy_type)proxy_or_proxy_id_required — pass either proxy or proxy_idOnly http/https URLs are allowed — the supplied URL scheme is not permittedNo json data / Not valid json data / Invalid JSON — the POST body is missing or malformedspecify at least one filter: id_country, operator_id or geoid — required for get_free_eid_listCannot disable equipment #X: N active client rental(s)… — release active rentals first"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,4check_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,4currency 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,4operator_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, optionalFavorite 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,4black_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 requiredoperator_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 0equipments_back_list isset — Исключить из списка содержимое черного списка оборудованияlimit int — Max rows, default 1000, max 10000count_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,4type 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,4type 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,4operator 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/0check_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:portos 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:passproxy_not_found — proxy_id не принадлежит аккаунту или прокси не активенproxy_invalid — не удалось распарсить строку proxyproxy_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,4period int — Период, на который приобретается/продляется прокси (по умолчанию 30). Возможные значения: 1,7,30,90,365num int — Количество требуемых прокси в случае покупки (по умолчанию 1)type int — Тип прокси: 0 — мобильные, 1 — серверные, 2 — бэкконнект (по умолчанию 0): 0/1/2coupons_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,4proxy_reboot_time int — Время смены ip-адреса для таймера в минутах, для отмены необходимо передать 0proxy_ipauth ip list — Список ip-адресов, с которых разрешена авторизация без логина и пароля, IPv4 через запятую, для отмены нужно передать '-1', поддерживается как список ip-адресов, так и указание подсетей. Например: 192.168.34.76,123.123.212.0/24proxy_auto_renewal int — Автопродление. 1 - включено, 0 - выключено. По умолчанию 1 - включено: 1/0proxy_auto_change_equipment int — Настройка автоматической смены оборудования, 0 - отключена, 1 - не ограничивать, 2 - страна, 3 - область, край, регион, 4 - город: 0,1,2,3,4proxy_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.netid_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 или asnscountry string — код страны ISO2, например USregion 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 intdays 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_plansnum int — множитель тарифа, 1-100country string — код страны ISO2, например USperiod 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 intprice_id int — ID тарифа из residential_plansnum 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_locationssession_mode string — rotating / stickysession_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 — без параметров — чтение текущих настроек, с параметрами — сохранениеОтвет JSON
{
"status": "ok",
"proxy_id": "525819",
"new_ip": "203.23.179.163",
"message": "IP refreshed"
}