API Documentation

API

API 请求限制

相同请求间隔不得少于5秒，超频返回 "Too many lonely requests. Timeout 5 second"
API方法调用频率不超过3 * 活跃代理数次/秒，超频返回"Too many requests per second"。（10个代理限制30次/秒）

SDK

Quick Start

此请求允许了解您的代理当前提供的IP地址

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 获取您代理的IP地址

此请求允许了解您的代理当前提供的IP地址

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}'

请求参数

proxy_id int, int list ，*必需 — 代理ID，多个逗号分隔: 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链接，需用户代理header。接口无速率限制。

Curl请求

curl --request GET \
  --url 'https://changeip.mobileproxy.space/?proxy_key={proxy_key}&format={format}' \
  --header 'User-Agent: {user-Agent-Name-Here}'

请求参数

proxy_key varchar(32) ，*必需 — API令牌，来自换IP链接用户

User-Agent varchar(255) ，*必需 — 非机器人User-Agent

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://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'

请求参数

id_country int, int list — 国家标识符（通过get_id_country命令获得）: 1,2,3,4

currency string — usd, rub (default rub)

JSON响应

{
  "status": "ok",
  "price": [
    {
      "id_country": 1,
      "iso": "RU",
      "amount": 700,
      "country_name": "..",
      "period": 30
    },
    ...
  ]
}

GET 获取设备和运营商黑名单

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}'

请求参数

proxy_id int, int list — 代理ID，多个逗号分隔: 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://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}'

请求参数

proxy_id int — 代理ID

operator_id int ，*必需 — 运营商ID

JSON响应

{ "status": "ok" }

GET 从黑名单中删除运营商

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}'

请求参数

proxy_id int, int list — 代理ID，多个用逗号分隔: 1,2,3,4

operator_id int ，*必需 — 运营商ID

如果没有指定任何参数，将清除整个列表

JSON响应

{ "status": "ok" }

GET 从设备黑名单中删除记录

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}'

请求参数

proxy_id int, int list — 代理ID，多个用逗号分隔: 1,2,3,4

black_list_id int — 记录标识符

eid int — 设备标识符

如果没有指定任何参数，将清除整个列表

JSON响应

{ "status": "ok" }

GET 获取活跃代理列表

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}'

请求参数

proxy_id int, int list — 代理ID，多个逗号分隔: 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://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}'

请求参数

proxy_id int, int list ，*必需 — 代理ID

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://mobileproxy.space/api.html?command=reboot_proxy&proxy_id={proxy_id}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'

请求参数

proxy_id int ，*必需 — 代理ID

JSON响应

{
  "status": "ok",
  "message": "..."
}

GET 仅获取按地理位置和运营商分组的可用设备

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}'

请求参数

equipments_back_list isset — 从列表中排除设备黑名单内容

operators_back_list isset — 从列表中排除运营商黑名单内容

proxy_id int — 代理标识符，如果指定，响应中将显示可以更换地理位置的服务器

show_count_null bool — Show null count, default false

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 获取运营商列表

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}'

请求参数

geoid int, int list — 国家ID，返回此地区可用端口及运营商数量，可逗号分隔多个: 1,2,3,4

JSON响应

[
  {
    "operator": "MTS",
    "id_country": 1,
    "count_free": 15
  },
  ...
]

GET 获取国家列表

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'

请求参数

only_avaliable bool — 如果指定此参数，命令将仅返回有可租设备的国家及其数量，非必需

JSON响应

{
  "status": "ok",
  "id_country": { ... }
}

GET 获取城市列表

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'

JSON响应

{
  "status": "ok",
  "id_city": { ... }
}

GET 获取可用国家列表

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}'

请求参数

proxy_id int — 代理标识符，如果指定，响应中将显示可以更换地理位置的服务器

geoid int, int list — 国家ID，返回此地区可用端口及运营商数量，可逗号分隔多个: 1,2,3,4

JSON响应

[
  {
    "geoid": 10,
    "geo_caption": "Moscow",
    "count_free": 15,
    "iso": "RU",
    "id_city": 1
  },
  ...
]

GET 更换设备

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}'

请求参数

proxy_id int, int list ，*必需 — 代理ID，多个用逗号分隔: 1,2,3,4

operator varchar — 运营商ID（可选），来自“获取运营商列表”

geoid int — 国家ID（可选），来自“获取国家列表”

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

JSON响应

{
  "status": "ok",
  "message": { ... },
  "error": { ... },
  "checked": { ... },
  "ipguardian.net": { ... }
}

GET 生成浏览器指纹

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}'

请求参数

proxy_id int — 您当前代理的 ID（优先）。会验证是否属于您的账户。如已指定，服务器将通过您的代理自动检测 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 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", ... ]
  }
}

可能的错误

proxy_or_proxy_id_required — 未提供 proxy_id 或 proxy

proxy_not_found — proxy_id 不属于该账户或代理未激活

proxy_invalid — 无法解析 proxy 字符串

proxy_connect_failed — 服务器无法通过代理连接（请参阅响应中的 details）

GET 购买代理

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}'

请求参数

operator varchar — 运营商ID（可选），来自“获取运营商列表”

geoid int — 国家ID（可选），来自“获取国家列表”

proxy_id int, int list — 代理ID，续费时指定，多个用逗号分隔，如1,2,3

period int — 购买/续费周期，默认30，选项：1,7,30,90,365

num int — 购买数量，默认1

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://mobileproxy.space/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://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}'

请求参数

proxy_id int, int list ，*必需 — 代理ID，多个用逗号分隔: 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地址按地区统计至 15 мая 2026 23:27

Curl请求

curl --request GET \
  --url 'https://mobileproxy.space/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://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}'

请求参数

url url ，*必需 — 要检查的页面地址: https://mobileproxy.space

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://mobileproxy.space/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://mobileproxy.space/api.html?command=eid_avaliable&eid={eid}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'

请求参数

eid int, int list ，*必需 — 设备ID，可多个逗号分隔: 1,2,3,4

JSON响应

{
  "status": "ok",
  "eid": {
    "123": 1, (1 = free, 0 = busy)
    "124": 0
  }
}

GET 获取资金流动历史记录

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}'

JSON响应

{
  "status": "ok",
  "history": [ ... ]
}

API

文章目录

SDK

Quick Start

GET 获取您代理的IP地址

Curl请求

请求参数

JSON响应

GET 代理IP更换

Curl请求

请求参数

JSON响应

GET 获取价格

Curl请求

请求参数

JSON响应

GET 获取设备和运营商黑名单

Curl请求

请求参数

JSON响应

GET 将运营商添加到黑名单

Curl请求

请求参数

JSON响应

GET 从黑名单中删除运营商

Curl请求

请求参数

JSON响应

GET 从设备黑名单中删除记录

Curl请求

请求参数

JSON响应

GET 获取活跃代理列表

Curl请求

请求参数

JSON响应

GET 更改代理登录信息

Curl请求

请求参数

JSON响应

GET 代理重启

Curl请求

请求参数

JSON响应

GET 仅获取按地理位置和运营商分组的可用设备

Curl请求

请求参数

JSON响应

GET 获取运营商列表

Curl请求

请求参数

JSON响应

GET 获取国家列表

请求参数

JSON响应

GET 获取城市列表

JSON响应

GET 获取可用国家列表

Curl请求

请求参数

JSON响应

GET 更换设备

Curl请求

请求参数

JSON响应

GET 生成浏览器指纹

Curl请求

请求参数

JSON响应

可能的错误

GET 购买代理

Curl请求

请求参数

JSON响应

GET 查询账户余额

Curl请求

JSON响应

GET 修改代理设置

Curl请求

请求参数