API Documentation

API

Sommaire de l'article

Limitations d'utilisation de l'API

  • Les requêtes identiques peuvent être envoyées au plus une fois toutes les 5 secondes. Si vous dépassez cette limite, le serveur renvoie l'erreur : « Too many lonely requests. Timeout 5 second »
  • Les méthodes API peuvent être appelées au plus 3 × (nombre de proxys actifs achetés) fois par seconde. Si vous dépassez cette limite, le serveur renvoie l'erreur : « Too many requests per second ». (Avec 10 proxys, la limite est de 30 requêtes par seconde ; avec 100 proxys, 300 requêtes par seconde...)

SDK

PHP SDK
Node SDK
Python SDK
OpenAPI Spec

Quick Start

Cette requête permet de connaître l'adresse IP actuellement délivrée par votre 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 Récupérer l'adresse IP de votre proxy

Cette requête permet de connaître l'adresse IP actuellement délivrée par votre proxy

Requête 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}'
Paramètres de la requête
proxy_id int, int list , *obligatoire — Identifiant du proxy ; pour récupérer plusieurs proxys, séparez-les par des virgules, par exemple: 1,2,3,4
check_spam bool — Si le paramètre check_spam=true est indiqué, l'adresse IP délivrée par le proxy sera vérifiée dans la base d'adresses spam IPGuardian.net: true
Réponse JSON
{
  "status": "ok",
  "ip": "123.45.67.89",
  "ipguardian.net": { ... }
}

GET Changer l'adresse IP du proxy

Cette requête ne nécessite pas d'en-tête d'autorisation : il suffit d'appeler le lien de changement d'IP depuis le navigateur ; en cas d'appel programmatique, vous devez impérativement indiquer le User-agent du navigateur. Le lien lui-même est disponible dans la table Mes proxys, dans la colonne « Changer d'IP ». Cette commande n'est pas soumise à la limite API de 3 requêtes par seconde.

Requête Curl
curl --request GET \
  --url 'https://changeip.mobileproxy.space/?proxy_key={proxy_key}&format={format}' \
  --header 'User-Agent: {user-Agent-Name-Here}'
Paramètres de la requête
proxy_key varchar(32) , *obligatoire — Clé du proxy, contenue dans le lien de changement d'IP dans la section Mes proxys
User-Agent varchar(255) , *obligatoire — User-Agent qui n'est pas celui d'un bot
format string — Format de réponse : json ou 0
Réponse JSON
{
  "status": "ok",
  "code": 0,
  "new_ip": "1.2.3.4",
  "rt": 1234,
  "message": "...",
  "proxy_id": 123
}

GET Récupérer les prix

Requête 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'
Paramètres de la requête
id_country int, int list — Identifiant du pays (obtenu via la commande get_id_country): 1,2,3,4
currency string — usd, rub (default rub)
Réponse JSON
{
  "status": "ok",
  "price": [
    {
      "id_country": 1,
      "iso": "RU",
      "amount": 700,
      "country_name": "..",
      "period": 30
    },
    ...
  ]
}

GET Récupérer la liste noire d'équipements et d'opérateurs

Requête 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}'
Paramètres de la requête
proxy_id int, int list — Identifiant du proxy ; pour récupérer plusieurs proxys, séparez-les par des virgules, par exemple: 1,2,3,4
Réponse 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 Ajouter un opérateur à la liste noire

Requête 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}'
Paramètres de la requête
proxy_id int — Identifiant du proxy
operator_id int , *obligatoire — Identifiant de l'opérateur
Réponse JSON
{ "status": "ok" }

GET Retirer un opérateur de la liste noire

Requête 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}'
Paramètres de la requête
proxy_id int, int list — Identifiant du proxy ; pour modifier plusieurs proxys, séparez-les par des virgules, par exemple: 1,2,3,4
operator_id int , *obligatoire — Identifiant de l'opérateur

Si aucun paramètre n'est indiqué, toute la liste sera vidée

Réponse JSON
{ "status": "ok" }

GET Supprimer des entrées de la liste noire d'équipements

Requête 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}'
Paramètres de la requête
proxy_id int, int list — Identifiant du proxy ; pour modifier plusieurs proxys, séparez-les par des virgules, par exemple: 1,2,3,4
black_list_id int — Identifiant de l'enregistrement
eid int — Identifiant de l'équipement

Si aucun paramètre n'est indiqué, toute la liste sera vidée

Réponse JSON
{ "status": "ok" }

GET Récupérer la liste de vos proxys actifs

Requête 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}'
Paramètres de la requête
proxy_id int, int list — Identifiant du proxy ; pour récupérer plusieurs proxys, séparez-les par des virgules, par exemple: 1,2,3,4
Réponse 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 Modifier l'identifiant et le mot de passe du proxy

Requête 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}'
Paramètres de la requête
proxy_id int, int list , *obligatoire — Identifiant du proxy
proxy_login text , *obligatoire — Identifiant (chiffres et lettres latines uniquement), si non spécifié, sera généré automatiquement
proxy_pass text , *obligatoire — Mot de passe (chiffres et lettres latines uniquement), si non spécifié, sera généré automatiquement
Réponse JSON
{
  "status": "ok",
  "proxy_id": 123,
  "proxy_login": "new",
  "proxy_pass": "pass"
}

GET Redémarrer le proxy

Requête 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}'
Paramètres de la requête
proxy_id int , *obligatoire — Identifiant du proxy
Réponse JSON
{
  "status": "ok",
  "message": "..."
}

GET Récupérer uniquement l'équipement disponible, groupé par GEO et opérateur

Requête 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}'
Paramètres de la requête
equipments_back_list isset — Exclure de la liste le contenu de la liste noire d'équipements
operators_back_list isset — Exclure de la liste le contenu de la liste noire d'opérateurs
proxy_id int — Identifiant du proxy ; s'il est indiqué, la réponse listera les serveurs vers lesquels vous pouvez changer le GEO
show_count_null bool — Show null count, default false
Réponse 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 Récupérer la liste des opérateurs

Requête 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}'
Paramètres de la requête
geoid int, int list — Identifiants de GEO ; s'ils sont indiqués, affiche le nombre de ports disponibles avec les opérateurs pour ce GEO. Plusieurs identifiants peuvent être séparés par des virgules.: 1,2,3,4
Réponse JSON
[
  {
    "operator": "MTS",
    "id_country": 1,
    "count_free": 15
  },
  ...
]

GET Récupérer la liste des pays

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'
Paramètres de la requête
only_avaliable bool — Si ce paramètre est indiqué, la commande renverra uniquement les pays disposant d'équipement à louer, avec leur quantité , facultatif
Réponse JSON
{
  "status": "ok",
  "id_country": { ... }
}

GET Récupérer la liste des villes

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'
Réponse JSON
{
  "status": "ok",
  "id_city": { ... }
}

GET Récupérer la liste des GEO disponibles

Requête 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}'
Paramètres de la requête
proxy_id int — Identifiant du proxy ; s'il est indiqué, la réponse listera les serveurs vers lesquels vous pouvez changer le GEO
geoid int, int list — Identifiants de GEO ; s'ils sont indiqués, affiche le nombre de ports disponibles avec les opérateurs pour ce GEO. Plusieurs identifiants peuvent être séparés par des virgules.: 1,2,3,4
Réponse JSON
[
  {
    "geoid": 10,
    "geo_caption": "Moscow",
    "count_free": 15,
    "iso": "RU",
    "id_city": 1
  },
  ...
]

GET Changer le matériel

Requête 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}'
Paramètres de la requête
proxy_id int, int list , *obligatoire — Identifiant du proxy ; pour modifier plusieurs proxys, séparez-les par des virgules, par exemple: 1,2,3,4
operator varchar — Identifiant de l'opérateur (facultatif), provient de la fonction « Récupérer la liste des opérateurs » (get_operators_list)
geoid int — Identifiant du GEO (facultatif), provient de la fonction « Récupérer la liste des GEO disponibles » (get_geo_list)
id_country int — Identifiant du pays (obtenu via la commande get_id_country)
id_city int — Identifiant de la ville (obtenu via la commande get_id_city)
eid int — Identifiant de l'équipement
add_to_black_list int — Ajouter l'équipement utilisé à la liste noire ; il ne vous sera plus proposé lors d'un changement. À quoi cela sert-il ?: 1/0
check_after_change bool — Si ce paramètre est défini sur true, après le changement d'équipement, la requête demandera une nouvelle adresse IP au nouvel équipement et la renverra dans la réponse
check_spam bool — Si le paramètre check_spam=true est indiqué, l'adresse IP délivrée par le proxy sera vérifiée dans la base d'adresses spam IPGuardian.net: true
Réponse JSON
{
  "status": "ok",
  "message": { ... },
  "error": { ... },
  "checked": { ... },
  "ipguardian.net": { ... }
}

GET Générer un browser fingerprint

Requête 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}'
Paramètres de la requête
proxy_id int — ID de votre proxy actif (prioritaire). L'appartenance au compte est vérifiée. Si spécifié, le serveur détecte automatiquement l'IP et le pays via votre proxy
proxy varchar — Proxy arbitraire si proxy_id n'est pas spécifié. Formats : host:port:login:pass, login:pass:host:port, login:pass@host:port, host:port
os varchar — Système d'exploitation du profil : windows | macos | android | ios (par défaut : windows)
seed varchar — Chaîne optionnelle pour la reproductibilité du profil. Les mêmes ip + country + os + seed renvoient le même profil
Réponse 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", ... ]
  }
}
Erreurs possibles
proxy_or_proxy_id_required — ni proxy_id ni proxy n'ont été fournis
proxy_not_found — proxy_id n'appartient pas au compte ou le proxy n'est pas actif
proxy_invalid — impossible d'analyser la chaîne proxy
proxy_connect_failed — le serveur n'a pas pu se connecter via le proxy (voir details dans la réponse)

GET Achat de proxy

Requête 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}'
Paramètres de la requête
operator varchar — Identifiant de l'opérateur (facultatif), provient de la fonction « Récupérer la liste des opérateurs » (get_operators_list)
geoid int — Identifiant du GEO (facultatif), provient de la fonction « Récupérer la liste des GEO disponibles » (get_geo_list)
proxy_id int, int list — Identifiant du proxy, indiqué uniquement en cas de prolongation du proxy souhaité ; pour prolonger plusieurs proxys, séparez-les par des virgules, par exemple : 1,2,3,4
period int — Période d'achat/prolongation du proxy (par défaut 30). Valeurs possibles : 1, 7, 30, 90, 365
num int — Nombre de proxys requis lors de l'achat (par défaut 1)
coupons_code varchar — Code coupon, le cas échéant
id_country int — Identifiant du pays (obtenu via la commande get_id_country)
id_city int — Identifiant de la ville (obtenu via la commande get_id_city)
amount_only bool — Si ce paramètre est transmis, le montant qui serait débité du solde lors de l'achat vous est renvoyé ; l'achat lui-même n'est pas effectué
auto_renewal int — Renouvellement automatique. 1 — activé, 0 — désactivé. Par défaut : 1 — activé: 1/0
Réponse JSON
{
  "status": "ok",
  "proxy_id": [123, 124],
  "amount": 700.00,
  "message": "...",
  "proxy_data": [ ... ]
}

GET Récupérer le solde du compte

Requête Curl
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=get_balance' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Réponse JSON
{
  "status": "ok",
  "balance": 1500.00
}

GET Modifier les paramètres d'un proxy existant

Requête 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}'
Paramètres de la requête
proxy_id int, int list , *obligatoire — Identifiant du proxy ; pour modifier plusieurs proxys, séparez-les par des virgules, par exemple: 1,2,3,4
proxy_reboot_time int — Délai de changement d'adresse IP pour la minuterie en minutes ; pour annuler, transmettez 0
proxy_ipauth ip list — Liste d'adresses IP autorisées sans identifiant/mot de passe (IPv4 séparées par des virgules) ; pour annuler, transmettez '-1'. Les listes d'adresses et les sous-réseaux sont pris en charge. Par exemple : 192.168.34.76, 123.123.212.0/24
proxy_auto_renewal int — Renouvellement automatique. 1 — activé, 0 — désactivé. Par défaut : 1 — activé: 1/0
proxy_auto_change_equipment int — Configuration du changement automatique d'équipement : 0 — désactivé, 1 — sans restriction, 2 — pays, 3 — région, territoire, 4 — ville: 0,1,2,3,4
proxy_comment varchar(255) — Text proxy comment
Réponse JSON
{
  "status": "ok",
  "proxy_id": [123, 124],
  "message": ""
}

GET Statistiques actuelles des adresses IP des proxys mobiles par GEO au 20 мая 2026 20:10

Requête Curl
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=get_ipstat' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
Réponse JSON
{
  "status": "ok",
  "ipstat": [ ... ]
}

POST Récupérer le contenu d'une page depuis différentes IP

Cette commande permet de voir le contenu d'une page depuis différents GEO ; elle crée une tâche de vérification à partir des pays indiqués. Si aucun identifiant de pays n'est précisé, la page sera demandée depuis tous les pays disponibles. En réponse, vous recevrez l'identifiant de la tâche, et après son exécution, vous pourrez récupérer le contenu de la page via cet identifiant.

Requête 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}'
Paramètres de la requête
url url , *obligatoire — Adresse de la page à vérifier: https://mobileproxy.space
id_country int, int list — Liste d'identifiants de pays séparés par des virgules (obtenue via la commande get_id_country): 1,2,3,4
Réponse JSON
{
  "status": "ok",
  "message": "...",
  "tasks_id": 123,
  "task_check_url": "https://...",
  "approximate_end_time": "..."
}

GET Récupérer le résultat de l'exécution d'une tâche

Requête 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}'
Paramètres de la requête
tasks_id int — Identifiant de la tâche obtenu lors de sa création ; s'il n'est pas indiqué, toutes les tâches de l'utilisateur seront renvoyées
Réponse JSON
{
  "status": "ok",
  "tasks": {
    "tasks_id": 123,
    "tasks_start_time": "...",
    "tasks_end_time": "...",
    "tasks_status": 1,
    "tasks_result": "..."
  }
}

GET Vérifier la disponibilité d'un équipement

Vous pouvez vérifier si un équipement précis est disponible à la location

Requête 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}'
Paramètres de la requête
eid int, int list , *obligatoire — Identifiant de l'équipement ; vous pouvez en indiquer plusieurs séparés par des virgules, par exemple: 1,2,3,4
Réponse JSON
{
  "status": "ok",
  "eid": {
    "123": 1, (1 = free, 0 = busy)
    "124": 0
  }
}

GET Récupérer l'historique des mouvements de fonds

Requête 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}'
Réponse JSON
{
  "status": "ok",
  "history": [ ... ]
}