API Documentation

API

Makale içeriği

API ile çalışma sınırlamaları

  • Aynı istekleri 5 saniyede 1’den sık gönderemezsiniz. Sıklık sınırını aşarsanız sunucu şu hatayı döndürür: "Too many lonely requests. Timeout 5 second"
  • API yöntemlerine saniyede en fazla 3*(aktif satın alınmış proxy sayısı) kez başvurabilirsiniz. Sıklık sınırını aşarsanız sunucu şu hatayı döndürür: "Too many requests per second". (10 proxy’niz varsa sınır saniyede 30 istektir, 100 proxy varsa saniyede 300 istek...)

SDK

PHP SDK
Node SDK
Python SDK
OpenAPI Spec

Quick Start

Bu istek, proxy’nizin şu anda hangi IP adresini verdiğini öğrenmenizi sağlar

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 Proxy’nizin IP adresini alma

Bu istek, proxy’nizin şu anda hangi IP adresini verdiğini öğrenmenizi sağlar

Curl isteği
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}'
İstek parametreleri
proxy_id int, int list , *zorunlu — Proxy tanımlayıcısı; birden fazla proxy alınacaksa, bunlar virgülle ayrılarak belirtilir, örneğin: 1,2,3,4
check_spam bool — Eğer check_spam=true parametresi belirtilirse, verilen proxy ip adresinin IPGuardian.net spam adres veri tabanına karşı kontrolü yapılacaktır.: true
JSON yanıtı
{
  "status": "ok",
  "ip": "123.45.67.89",
  "ipguardian.net": { ... }
}

GET Proxy IP adresini değiştirme

Bu istek için yetkilendirme başlığı belirtmeniz gerekmez; IP adresini değiştirme bağlantısını tarayıcıdan çağırmanız yeterlidir; programlı çağrı kullanıyorsanız mutlaka bir tarayıcı User-Agent’ı belirtmelisiniz. Bağlantının kendisini Proxy’lerim tablosunda IP Değiştirme sütununda bulabilirsiniz. Bu komut için saniyede 3 istek API sınırı yoktur.

Curl isteği
curl --request GET \
  --url 'https://changeip.mobileproxy.space/?proxy_key={proxy_key}&format={format}' \
  --header 'User-Agent: {user-Agent-Name-Here}'
İstek parametreleri
proxy_key varchar(32) , *zorunlu — Proxy anahtarı, proxy’lerim bölümünde IP değiştirme bağlantısında yer alır
User-Agent varchar(255) , *zorunlu — Bot olmayan bir User-Agent
format string — Yanıt biçimi: json veya 0
JSON yanıtı
{
  "status": "ok",
  "code": 0,
  "new_ip": "1.2.3.4",
  "rt": 1234,
  "message": "...",
  "proxy_id": 123
}

GET Fiyatların alınması

Curl isteği
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'
İstek parametreleri
id_country int, int list — Ülke kimliği (get_id_country komutuyla alınır): 1,2,3,4
currency string — usd, rub (default rub)
JSON yanıtı
{
  "status": "ok",
  "price": [
    {
      "id_country": 1,
      "iso": "RU",
      "amount": 700,
      "country_name": "..",
      "period": 30
    },
    ...
  ]
}

GET Ekipman ve operatör kara listesinin alınması

Curl isteği
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}'
İstek parametreleri
proxy_id int, int list — Proxy tanımlayıcısı; birden fazla proxy alınacaksa, bunlar virgülle ayrılarak belirtilir, örneğin: 1,2,3,4
JSON yanıtı
{
  "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 Operatörü kara listeye ekle

Curl isteği
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}'
İstek parametreleri
proxy_id int — Proxy tanımlayıcısı
operator_id int , *zorunlu — Operatör tanımlayıcısı
JSON yanıtı
{ "status": "ok" }

GET Operatörü kara listeden çıkar

Curl isteği
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}'
İstek parametreleri
proxy_id int, int list — Proxy tanımlayıcısı; birden fazla proxy değiştirilecekse, bunlar virgülle ayrılarak belirtilir, örneğin: 1,2,3,4
operator_id int , *zorunlu — Operatör tanımlayıcısı

Hiçbir parametre belirtilmezse, listenin tamamı temizlenir

JSON yanıtı
{ "status": "ok" }

GET Ekipman kara listesinden kayıtları sil

Curl isteği
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}'
İstek parametreleri
proxy_id int, int list — Proxy tanımlayıcısı; birden fazla proxy değiştirilecekse, bunlar virgülle ayrılarak belirtilir, örneğin: 1,2,3,4
black_list_id int — Kayıt kimliği
eid int — Ekipman kimliği

Hiçbir parametre belirtilmezse, listenin tamamı temizlenir

JSON yanıtı
{ "status": "ok" }

GET Aktif proxylerinizin listesini alma

Curl isteği
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}'
İstek parametreleri
proxy_id int, int list — Proxy tanımlayıcısı; birden fazla proxy alınacaksa, bunlar virgülle ayrılarak belirtilir, örneğin: 1,2,3,4
JSON yanıtı
[
  {
    "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 Proxy'nin giriş ve parolasını değiştirme

Curl isteği
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}'
İstek parametreleri
proxy_id int, int list , *zorunlu — Proxy tanımlayıcısı
proxy_login text , *zorunlu — Kullanıcı adı (yalnızca rakamlar ve Latin harfleri), belirtilmezse otomatik olarak oluşturulur
proxy_pass text , *zorunlu — Şifre (yalnızca rakamlar ve Latin harfleri), belirtilmezse otomatik olarak oluşturulur
JSON yanıtı
{
  "status": "ok",
  "proxy_id": 123,
  "proxy_login": "new",
  "proxy_pass": "pass"
}

GET Proxy'yi yeniden başlatma

Curl isteği
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}'
İstek parametreleri
proxy_id int , *zorunlu — Proxy tanımlayıcısı
JSON yanıtı
{
  "status": "ok",
  "message": "..."
}

GET Yalnızca mevcut ekipmanın GEO ve operatöre göre gruplanmış olarak alınması

Curl isteği
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}'
İstek parametreleri
equipments_back_list isset — Listeden ekipman kara listesindeki içerikleri hariç tut
operators_back_list isset — Listeden operatör kara listesindeki içerikleri hariç tut
proxy_id int — Proxy tanımlayıcısı; belirtilirse, yanıtta GEO’nun değiştirilebileceği sunucular yer alır
show_count_null bool — Show null count, default false
JSON yanıtı
{
  "status": "ok",
  "geo_operator_list": {
    "10": {
      "geoid": 10,
      "geo_caption": "Moscow",
      "id_city": 1,
      "id_country": 1,
      "count_free": {
        "MTS": 15,
        "Beeline": 8
      }
    },
    ...
  }
}

GET Operatör listesini alma

Curl isteği
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}'
İstek parametreleri
geoid int, int list — GEO tanımlayıcıları; belirtilirse, bu GEO için operatörlere göre mevcut port sayısı gösterilir; birden fazla tanımlayıcıyı virgülle ayırarak belirtebilirsiniz: 1,2,3,4
JSON yanıtı
[
  {
    "operator": "MTS",
    "id_country": 1,
    "count_free": 15
  },
  ...
]

GET Ülke listesinin alınması

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'
İstek parametreleri
only_avaliable bool — Bu parametreyi belirtirseniz, yalnızca kiralanabilir ekipmanın bulunduğu ülkeler ve adetleri döner , zorunlu değil
JSON yanıtı
{
  "status": "ok",
  "id_country": { ... }
}

GET Şehir listesinin alınması

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

GET Mevcut GEO listesini alma

Curl isteği
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}'
İstek parametreleri
proxy_id int — Proxy tanımlayıcısı; belirtilirse, yanıtta GEO’nun değiştirilebileceği sunucular yer alır
geoid int, int list — GEO tanımlayıcıları; belirtilirse, bu GEO için operatörlere göre mevcut port sayısı gösterilir; birden fazla tanımlayıcıyı virgülle ayırarak belirtebilirsiniz: 1,2,3,4
JSON yanıtı
[
  {
    "geoid": 10,
    "geo_caption": "Moscow",
    "count_free": 15,
    "iso": "RU",
    "id_city": 1
  },
  ...
]

GET Donanım değişimi

Curl isteği
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}'
İstek parametreleri
proxy_id int, int list , *zorunlu — Proxy tanımlayıcısı; birden fazla proxy değiştirilecekse, bunlar virgülle ayrılarak belirtilir, örneğin: 1,2,3,4
operator varchar — Operatör tanımlayıcısı (zorunlu değil), "Operatör listesini alma" (get_operators_list) fonksiyonundan alınır
geoid int — GEO tanımlayıcısı (zorunlu değil), "Mevcut GEO listesini alma" (get_geo_list) fonksiyonundan alınır
id_country int — Ülke kimliği (get_id_country komutuyla alınır)
id_city int — Şehir kimliği (get_id_city komutuyla alınır)
eid int — Ekipman kimliği
add_to_black_list int — Kullandığınız donanımı kara listeye ekleyin; böylece değişim sırasında bir daha karşınıza çıkmaz. Bu ne işe yarar?: 1/0
check_after_change bool — Bu parametre true olarak ayarlanırsa, ekipman değişikliğinden sonra istek, yeni ekipmandan yeni bir IP adresi talep edecek ve yanıtında döndürecektir
check_spam bool — Eğer check_spam=true parametresi belirtilirse, verilen proxy ip adresinin IPGuardian.net spam adres veri tabanına karşı kontrolü yapılacaktır.: true
JSON yanıtı
{
  "status": "ok",
  "message": { ... },
  "error": { ... },
  "checked": { ... },
  "ipguardian.net": { ... }
}

GET Browser fingerprint oluştur

Curl isteği
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}'
İstek parametreleri
proxy_id int — Aktif proxy ID'niz (öncelikli). Hesaba aitlik doğrulanır. Belirtilirse, sunucu IP'yi ve ülkeyi proxy'niz aracılığıyla otomatik olarak algılar
proxy varchar — proxy_id belirtilmediğinde rastgele bir proxy. Formatlar: host:port:login:pass, login:pass@host:port, host:port
os varchar — Profilin işletim sistemi: windows | macos | android | ios (varsayılan: windows)
seed varchar — Profilin tekrar üretilebilirliği için isteğe bağlı dize. Aynı ip + country + os + seed aynı profili döndürür
JSON yanıtı
{
  "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", ... ]
  }
}
Olası hatalar
proxy_or_proxy_id_required — ne proxy_id ne de proxy verildi
proxy_not_found — proxy_id hesaba ait değil veya proxy aktif değil
proxy_invalid — proxy dizesi ayrıştırılamadı
proxy_connect_failed — sunucu proxy üzerinden bağlanamadı (yanıttaki details alanına bakın)

GET Proxy satın alma

Curl isteği
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}'
İstek parametreleri
operator varchar — Operatör tanımlayıcısı (zorunlu değil), "Operatör listesini alma" (get_operators_list) fonksiyonundan alınır
geoid int — GEO tanımlayıcısı (zorunlu değil), "Mevcut GEO listesini alma" (get_geo_list) fonksiyonundan alınır
proxy_id int, int list — Proxy tanımlayıcısı; yalnızca belirli proxy'nin uzatılması durumunda belirtilir; birden fazla proxy uzatılacaksa virgülle ayırarak belirtin, örn.: 1,2,3,4
period int — Proxy'nin satın alınacağı/uzatılacağı süre (varsayılan 30). Olası değerler: 1,7,30,90,365
num int — Satın alma halinde gerekli proxy sayısı (varsayılan 1)
coupons_code varchar — Varsa kupon kodu
id_country int — Ülke kimliği (get_id_country komutuyla alınır)
id_city int — Şehir kimliği (get_id_city komutuyla alınır)
amount_only bool — Bu parametreyi geçirirseniz, satın alma yapılmadan, bakiyeden düşülecek tutar döner
auto_renewal int — Otomatik uzatma. 1 - açık, 0 - kapalı. Varsayılan 1 - açık: 1/0
JSON yanıtı
{
  "status": "ok",
  "proxy_id": [123, 124],
  "amount": 700.00,
  "message": "...",
  "proxy_data": [ ... ]
}

GET Hesap bakiyesini alma

Curl isteği
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=get_balance' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
JSON yanıtı
{
  "status": "ok",
  "balance": 1500.00
}

GET Mevcut proxy ayarlarını değiştirme

Curl isteği
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}'
İstek parametreleri
proxy_id int, int list , *zorunlu — Proxy tanımlayıcısı; birden fazla proxy değiştirilecekse, bunlar virgülle ayrılarak belirtilir, örneğin: 1,2,3,4
proxy_reboot_time int — Zamanlayıcı için IP değişim süresi (dakika); iptal etmek için 0 gönderin
proxy_ipauth ip list — Kullanıcı adı ve şifre olmadan yetkilendirmeye izin verilen IP adresleri listesi; IPv4'leri virgülle ayırın; iptal için '-1' gönderin. Hem IP listesi hem de alt ağ belirtilmesi desteklenir. Örneğin: 192.168.34.76,123.123.212.0/24
proxy_auto_renewal int — Otomatik uzatma. 1 - açık, 0 - kapalı. Varsayılan 1 - açık: 1/0
proxy_auto_change_equipment int — Otomatik donanım değişimi ayarı; 0 - kapalı, 1 - sınırlama yok, 2 - ülke, 3 - bölge/eyalet/il, 4 - şehir: 0,1,2,3,4
proxy_comment varchar(255) — Text proxy comment
JSON yanıtı
{
  "status": "ok",
  "proxy_id": [123, 124],
  "message": ""
}

GET GEO'ya göre mobil proxy IP adresi istatistikleri 15 мая 2026 08:45

Curl isteği
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=get_ipstat' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
JSON yanıtı
{
  "status": "ok",
  "ipstat": [ ... ]
}

POST Sayfa içeriğini farklı IP’lerden alma

Bu komut, farklı GEO’lar kullanarak bir sayfanın içeriğini görmenizi sağlar; belirtilen ülkelerden sayfayı kontrol etmek için bir görev oluşturur. Ülke kimlikleri belirtilmezse sayfa tüm mevcut ülkelerden istenir. Yanıt olarak bir görev kimliği alırsınız ve tamamlandıktan sonra bu kimlikle sayfanın içeriğini alabilirsiniz.

Curl isteği
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}'
İstek parametreleri
url url , *zorunlu — Kontrol edilecek sayfanın adresi: https://mobileproxy.space
id_country int, int list — Virgülle ayrılmış ülke kimlikleri listesi (get_id_country komutuyla alınır): 1,2,3,4
JSON yanıtı
{
  "status": "ok",
  "message": "...",
  "tasks_id": 123,
  "task_check_url": "https://...",
  "approximate_end_time": "..."
}

GET Görev sonucunu alma

Curl isteği
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}'
İstek parametreleri
tasks_id int — Oluşturma sırasında alınan görev kimliği; belirtilmezse kullanıcının tüm görevlerini döndürür
JSON yanıtı
{
  "status": "ok",
  "tasks": {
    "tasks_id": 123,
    "tasks_start_time": "...",
    "tasks_end_time": "...",
    "tasks_status": 1,
    "tasks_result": "..."
  }
}

GET Ekipmanın müsaitliğini öğrenme

Belirli bir ekipmanın kiralamaya uygun olup olmadığını öğrenebilirsiniz

Curl isteği
curl --request GET \
  --url 'https://mobileproxy.space/api.html?command=eid_avaliable&eid={eid}' \
  --header 'Authorization: Bearer {do_not_working_token_only_for_preview}'
İstek parametreleri
eid int, int list , *zorunlu — Ekipman kimliği; bir liste de belirtebilirsiniz, bu durumda kimlikler virgülle ayrılır, örneğin: 1,2,3,4
JSON yanıtı
{
  "status": "ok",
  "eid": {
    "123": 1, (1 = free, 0 = busy)
    "124": 0
  }
}

GET Fon hareket geçmişini al

Curl isteği
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 yanıtı
{
  "status": "ok",
  "history": [ ... ]
}