ProxyTurk Developer API
ProxyTurk API ile entegrasyon için ihtiyacınız olan her şey. Web Scraping, SERP ve AI Parser endpoint'leri kapsamlı örneklerle.
https://api.proxyturk.comProxyTurk API, web sayfalarını scrape etmenizi, arama motoru sonuçlarını sorgulamanızı ve AI kullanarak yapılandırılmış veri çıkarmanızı sağlayan RESTful bir API'dir. Tüm istek ve yanıtlar JSON formatındadır.
Base URL
https://api.proxyturk.comKimlik Doğrulama
Bearer TokenContent-Type
application/jsonTüm scraping endpoint'leri varsayılan olarak asenkron çalışır. Senkron mod için URL'ye ?wait=true ekleyin (en fazla 60 saniye bekler).
Tüm API istekleri, Authorization header'ında Bearer token ile kimlik doğrulama gerektirir.
Authorization: Bearer YOUR_API_KEYsk_live_Production key — gerçek işlem yapar ve kredi harcarsk_test_Test key — mock veri döner, kredi harcamaz| Plan | Limit |
|---|---|
| Free | 10 istek/dakika |
| Pro | 100 istek/dakika |
| Business | 500 istek/dakika |
| Enterprise | Özel |
API, standart HTTP durum kodlarını kullanır. Hatalar, makine tarafından okunabilir bir kod ve insan tarafından okunabilir bir mesaj içeren JSON gövdesi döner.
İstek geçersiz veya eksik parametreler içeriyor.
Solution: İstek parametrelerini API referansı ile karşılaştırın. JSON gövdenizi doğrulayın.
Kimlik doğrulama başarısız.
Solution: Dashboard'dan API key'inizi kontrol edin. Header formatı: "Authorization: Bearer YOUR_KEY".
Yetersiz kredi veya bakiye.
Solution: Dashboard'dan bakiyenizi yükleyin veya planınızı yükseltin.
Geçerli key ama gerekli izinler yok.
Solution: Dashboard'dan plan ve key izinlerinizi kontrol edin.
İstenen kaynak bulunamadı.
Solution: Base URL'nin https://api.proxyturk.com/v1/ olduğundan emin olun. Endpoint adını ve job ID'yi kontrol edin.
Rate limit aşıldı.
Solution: Retry-After saniyesi kadar bekleyin. SDK'lar otomatik retry yapar. Daha yüksek limitler için plan yükseltin.
Sunucuda beklenmeyen bir hata oluştu.
Solution: Birkaç saniye bekleyip tekrar deneyin. status.proxyturk.com'dan sistem durumunu kontrol edin.
Hızlı entegrasyon için resmi SDK'lar. Her ikisi de otomatik retry, tip güvenliği ve webhook doğrulama yardımcıları içerir.
Sync & async modlar, httpx tabanlı, otomatik retry, özel exception sınıfları.
pip install proxyturkTypeScript uyumlu, Promise tabanlı API, otomatik retry, Bun & Deno uyumlu.
npm install @proxyturk/sdkAsync job sonuçlarını sunucunuza HTTP POST ile otomatik olarak alın. Polling yapmaya gerek yok.
job.completedJob başarıyla tamamlandı — result alanı veriyi içerirjob.failedJob başarısız oldu — error alanı detayları içerir{
"event": "job.completed",
"job_id": "job_abc123",
"status": "completed",
"endpoint": "scrape",
"result": { ... },
"meta": {
"processing_time_ms": 823,
"credits_used": 1,
"created_at": "2026-08-12T15:30:00Z",
"completed_at": "2026-08-12T15:30:01Z"
}
}