Dokümantasyon — Mobil Proxy API

Hızlı Başlangıç

İlk proxy isteğinizi bir dakikadan kısa sürede çalıştırın. İhtiyacınız olan: hesabınızda aktif bir proxy ve kontrol panelinizden bir API tokeni.

mobileproxy.space'de kayıt olun.
Proxy satın alın — satın alma sayfasında ülke ve operatör seçin.
Giriş yapmışken API sayfasından API tokeninizi kopyalayın.
İlk isteğinizi yapın — aşağıdan bir dil seçin.

curl --request GET \
 --url 'https://mobileproxy.space/api.html?command=get_my_proxy' \
 --header 'Authorization: Bearer YOUR_API_TOKEN'

import requests
r = requests.get(
"https://mobileproxy.space/api.html",
params={"command": "get_my_proxy"},
headers={"Authorization": "Bearer YOUR_API_TOKEN"},
timeout=10,
)
print(r.json())

const res = await fetch(
"https://mobileproxy.space/api.html?command=get_my_proxy",
{ headers: { Authorization: "Bearer YOUR_API_TOKEN" } }
);
console.log(await res.json());

req, _ := http.NewRequest("GET",
"https://mobileproxy.space/api.html?command=get_my_proxy", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))

Hız limiti: 3 istek/sn × N aktif proxy. Aynı istek cooldown'u: 3 sn. Aşıldığında HTTP 429.

Kimlik Doğrulama

Tüm API çağrıları kişisel Bearer token ile kimlik doğrulaması yapar. Token, tek bir proxy'ye değil hesabınıza bağlıdır.

Tokeninizi nereden alırsınız

Kontrol panelinize giriş yapın ve API sayfasını açın. Token alanı en üsttedir. Tokeni istediğiniz zaman değiştirebilirsiniz — eski token anında geçersiz olur.

Tokeni gönderme

Authorization: Bearer YOUR_API_TOKEN

IP allowlist (isteğe bağlı)

Ek güvenlik için API çağrılarını tek bir IP ile sınırlayabilirsiniz. API sayfasındaki İzin Verilen IP alanından ayarlayın. Geçerli bir tokenle bile başka IP'lerden gelen istekler reddedilir.

Proxy kimlik doğrulaması

Proxy'lerin kendisi kullanıcı adı/şifre (varsayılan) veya IP yetkilendirme kullanır. Kontrol panelinde proxy başına ayarlanır. IP yetkilendirme ile proxy bağlantısında kimlik bilgileri gönderilmez.

Temel Kavramlar

Mobil operatör IP'leri

Ağdaki her proxy, gerçek bir mobil operatöre (MTS, Beeline, T-Mobile, Vodafone vb.) bağlı gerçek bir 4G/5G modemdir. Hedef siteler trafiği veri merkezinden değil, hücresel ağdaki normal bir akıllı telefondan geliyormuş gibi görür.

CGNAT — mobil IP'ler neden "paylaşımlı"

Mobil operatörler binlerce aboneyi Carrier-Grade NAT ile aynı genel IP üzerinden yönlendirir. Tek bir IP'yi yasaklamak gerçek müşterileri engellerdi, bu yüzden anti-dolandırıcılık sistemleri mobil IP'leri konut veya veri merkezi IP'lerinden daha hoşgörülü değerlendirir. Mobil proxy'lerin daha yüksek güven puanlarına sahip olmasının yapısal nedeni budur.

Rotasyon

Modem yeniden bağlantısı tetikleyerek talep üzerine harici IP'yi değiştirin:

Bağlantı ile — benzersiz bir URL'ye GET isteği (changeip.host/?proxy_key=…) rotasyonu başlatır. Yeni IP'yi JSON olarak döndürür.
Zamanlayıcı ile — her N dakikada bir otomatik rotasyon (proxy başına yapılandırılabilir).
Yok (sticky) — siz isteyene kadar aynı IP korunur.

Sticky oturumlar

"Sticky" oturum sadece rotasyon devre dışı (veya uzun zamanlayıcılı) bir proxy'dir. Bu proxy üzerinden tüm istekler oturum süresince tek IP paylaşır. Çok adımlı akışlar (giriş → ödeme, bir oturumun birden fazla sayfasının parse edilmesi) için kullanışlıdır.

Rotasyonlar arasında oturum kalıcılığı

Cookies, localStorage ve TLS oturumları proxy'de değil istemcide yaşar. Rotasyondan sonra tarayıcı/kütüphanedeki mevcut oturumunuz hayatta kalır; sadece kaynak IP değişir.

Entegrasyonlar

En yaygın stackler için hazır snippet'ler. PROXY_HOST, PROXY_PORT, LOGIN, PASSWORD değerlerini get_my_proxy yanıtından gelen değerlerle değiştirin.

import requests
proxy = "http://LOGIN:PASSWORD@PROXY_HOST:PROXY_PORT"
r = requests.get("https://httpbin.org/ip",
 proxies={"http": proxy, "https": proxy},
 timeout=15)
print(r.json())

import { HttpsProxyAgent } from "https-proxy-agent";
const agent = new HttpsProxyAgent("http://LOGIN:PASSWORD@PROXY_HOST:PROXY_PORT");
const res = await fetch("https://httpbin.org/ip", { agent });
console.log(await res.json());

proxyURL, _ := url.Parse("http://LOGIN:PASSWORD@PROXY_HOST:PROXY_PORT")
client := &http.Client{Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)}}
resp, _ := client.Get("https://httpbin.org/ip")
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))

curl -x http://LOGIN:PASSWORD@PROXY_HOST:PROXY_PORT https://httpbin.org/ip
# SOCKS5
curl --socks5 LOGIN:PASSWORD@PROXY_HOST:SOCKS_PORT https://httpbin.org/ip

import { chromium } from "playwright";
const browser = await chromium.launch({
proxy: {
server: "http://PROXY_HOST:PROXY_PORT",
username: "LOGIN",
password: "PASSWORD",
},
});
const page = await browser.newPage();
await page.goto("https://httpbin.org/ip");
console.log(await page.content());
await browser.close();

from seleniumwire import webdriver
opts = {"proxy": {
"http": "http://LOGIN:PASSWORD@PROXY_HOST:PROXY_PORT",
"https": "http://LOGIN:PASSWORD@PROXY_HOST:PROXY_PORT",
"no_proxy": "localhost,127.0.0.1",
}}
driver = webdriver.Chrome(seleniumwire_options=opts)
driver.get("https://httpbin.org/ip")
print(driver.page_source)
driver.quit()

Resmi SDK'lar ve tam örnekler GitHub'da: Python · Node · PHP · OpenAPI spec.

Kullanım Senaryoları

Geliştiricilerin mobil proxy'lerle gerçekten ne inşa ettiği. Her kart tipik bir desendir.

Web scraping

İstek başına veya oturum başına IP rotasyonu, tarayıcı fingerprint araçlarıyla birlikte.

Tarayıcı otomasyonu

Playwright / Selenium worker başına bir proxy, stateful akışlar için sticky oturumlar.

Doğrulama ve QA

Gerçek operatör ağlarından coğrafi hedefli içerik, fiyatlandırma, A/B varyantlarını kontrol edin.

Reklam/SERP kontrolü

SERP scraping, reklam yerleşim doğrulaması, mobile özel creative kontrolleri.

SMM ve çoklu hesap

Hesap başına bir mobil proxy — carrier-grade IP profili gerçek bir kullanıcıya en çok benzeyenidir.

Veri pipeline'ları

Rotasyon havuzu arkasındaki arka plan worker'ları, rotasyonda yeniden denemeler, yapılandırılmış hata loglama.

API Referansı

Tam REST referansı — her endpoint, parametre ve yanıt şekli — özel API sayfasında bulunur. Giriş yaptığınızda tokeninizle otomatik kişiselleştirilir.

Tam REST API dokümantasyonu

~15 endpoint: proxy yönetimi, IP rotasyonu, kara listeler, coğrafi/operatör araması, bakiye.

API Referansını Aç

En çok kullanılan endpoint'ler

GET /api.html?command=get_my_proxy
GET CHANGEIP_HOST/?proxy_key=…
GET /api.html?command=proxy_ip&proxy_id=…
GET /api.html?command=change_equipment&…
GET /api.html?command=get_geo_operator_list

Sorun Giderme

Geliştiricilerin karşılaştığı en yaygın sorunlar ve standart çözümleri. Tam FAQ FAQ sayfasında.

Bağlantı zaman aşımına uğruyor / reddediliyor

Proxy'nin panelde aktif olduğunu, IP allowlist'in makinenizin çıkış IP'siyle eşleştiğini ve HTTP vs SOCKS5 için doğru portu kullandığınızı kontrol edin.

Rotasyon aynı IP'yi döndürüyor

Operatör aynı adresi yeniden atayabilir — küçük havuzlarda normaldir. Rotasyonu tekrar tetikleyin veya change_equipment ile operatörü değiştirin.

Hedef site captcha gösteriyor

Captcha'lar sadece IP ile değil fingerprint ile de ilişkilidir. Mobil IP'yi mobil User-Agent, mobil viewport ve tutarlı TLS profili ile eşleştirin. Bkz. Fingerprint generator.

Oturum beklenmedik şekilde sona eriyor

Oturumunuzun ortasında otomatik rotasyon devreye giriyor. Zamanlayıcı rotasyonunu devre dışı bırakın veya rotasyondan önce cookies/tokenları yakalayın.

Coğrafya uyuşmuyor / yanlış ülke

Mobil operatörler bazen yabancı düğümler üzerinden yönlendirir. proxy_ip ile doğrulayın ve gerekirse change_equipment ile yeniden yönlendirin.

API'den HTTP 429

Hız limitine ulaştınız. Exponential backoff ekleyin, get_my_proxy yanıtlarını önbelleğe alın, destekleniyorsa proxy_id listelerini toplu gönderin.

En İyi Uygulamalar

Yeniden deneme stratejisi

Her proxy isteğini jitter'lı yeniden denemeyle sarın (3 deneme, 500ms–3s). 429'da exponential backoff. Bağlantı hatalarında, yeniden denemeden önce rotasyon yapın.

Oturum yönetimi

Mantıksal oturum başına bir proxy. Worker başına cookies/localStorage kalıcı tutun. Rotasyonlar arasında HTTP keep-alive havuzu asla paylaşmayın.

Rotasyon aralıkları

Scraping için — istek başına veya her 30–120 saniyede bir rotasyon. Hesap çalışması için — uzun sticky oturumlar (saatler), yalnızca açık logout/error'da rotasyon.

Tarayıcı tutarlılığı

User-Agent'ı operatörle eşleştirin (4G → mobil UA). Saat dilimi ve locale'i proxy bölgesine ayarlayın. WebRTC IP sızıntısını devre dışı bırakın.

Banlardan kaçınma

İstek hızlarını insani makul aralıklarda tutun. İstek zamanlamasını rastgeleleştirin. Mobil IP'yi masaüstü değil, mobil fingerprint ile eşleştirin.

Gözlemlenebilirlik

proxy_id, mevcut IP, yanıt kodu ve rotasyon olaylarını birlikte loglayın. Bir şey bozulduğunda IP, fingerprint veya hedeften hangisi olduğunu bilirsiniz.

Geliştirici Dokümantasyonu