Python ile Hızlı Entegrasyon
ProxyTurk Python SDK, API'yi Python projelerinizde kolayca kullanmanızı sağlar. Sync ve async modlar, otomatik retry, webhook desteği ve tip güvenliği sunar.
import osfrom proxyturk import Clientclient = Client(api_key=os.environ["PROXYTURK_API_KEY"])# Web Scraping (sync)result = client.scrape( url="https://example.com", formats=["markdown", "screenshot"], wait=True)print(result.data.markdown)# AI Parser (sync)data = client.parse( url="https://example.com/product", prompt="Ürün adı, fiyat ve stok durumunu çek", schema={"name": "str", "price": "float", "in_stock": "bool"}, wait=True)print(data.data)# SERP API (sync)serp = client.serp( query="en iyi proxy sağlayıcı", engine="google", location="Turkey", language="tr", wait=True)for item in serp.data.organic: print(f"{item.position}. {item.title} - {item.url}")Python 3.8+ gerektirir. pip ile kurulum:
pip install proxyturk
Async özellikler için ek bağımlılık gerekmez, httpx dahili olarak kullanılır.
Client oluşturun ve ilk isteğinizi gönderin. API key'inizi environment variable olarak saklayın.
wait=True parametresi ile sonuç hazır olana kadar bekler. Basit scriptler ve küçük projeler için idealdir.
wait parametresi olmadan istek gönderdiğinizde job_id döner. wait_for_job() ile sonucu bekleyebilir veya webhook kullanabilirsiniz.
AsyncClient sınıfı ile Python asyncio desteği de mevcuttur.
Webhook sonuçlarının gerçekten ProxyTurk'ten geldiğini doğrulamak için signature kontrolü yapın.
SDK özel exception sınıfları fırlatır:
- ApiError: Genel API hatası - AuthError: 401/403 authentication hatası - RateLimitError: 429 rate limit aşımı - InsufficientCreditsError: 402 yetersiz kredi - ValidationError: 400 geçersiz parametre - JobTimeoutError: Async job zaman aşımı
Python SDK hakkında sorular
Python 3.8 ve üzeri desteklenir. Async özellikler için Python 3.9+ önerilir.
Evet, 429 (rate limit) ve 5xx (sunucu hatası) durumlarında exponential backoff ile 3 kez retry yapar.
Evet, Client oluşturulurken timeout parametresi verilebilir: Client(api_key="...", timeout=120). Default 60 saniyedir.