API anahtarımı nereden alabilirim?

Dashboard'a giriş yaparak API Anahtarları bölümünden yeni bir anahtar oluşturabilirsiniz. Ücretsiz plan ile başlayabilirsiniz.

Senkron ve asenkron istekler arasındaki fark nedir?

Senkron isteklerde (wait=true) sonuç doğrudan döner. Asenkron isteklerde bir job_id alırsınız ve sonucu polling veya webhook ile takip edersiniz. Uzun süren işlemler için asenkron tercih edilir.

Ücretsiz planda dakikada 10 istek, ücretli planlarda dakikada 100-1000 istek yapabilirsiniz. Rate limit aşıldığında 429 HTTP kodu döner.

Hangi programlama dillerini destekliyorsunuz?

Resmi SDK'larımız Python ve Node.js için mevcuttur. API REST tabanlı olduğu için cURL, Go, PHP, Ruby, Java ve HTTP isteği yapabilen herhangi bir dil ile kullanılabilir.

Webhook ile polling arasında hangisini kullanmalıyım?

Webhook, sunucunuzun bildirim almasını istiyorsanız idealdir — polling gerektirmez ve gerçek zamanlıdır. Polling ise basit script'ler ve tek seferlik işler için daha kolaydır.

JavaScript rendering ne zaman kullanmalıyım?

SPA (Single Page Application) sayfaları, dinamik olarak yüklenen içerikler veya JavaScript ile render edilen sayfalar için javascript_rendering: true parametresini kullanın.

Hızlı Entegrasyon

API Kod Örnekleri

ProxyTurk Scraping API ile dakikalar içinde entegrasyon yapın. Favori dilinizi seçin ve hazır kod örnekleriyle hemen başlayın.

AI Parse

Yapay zeka destekli içerik ayrıştırma. Herhangi bir web sayfasından yapılandırılmış veri çıkarın.

Senkron İstek— wait=true parametresi ile sonucu anında alın.

bash

curl -X POST "https://api.proxyturk.com/v1/parse?wait=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product",
    "prompt": "Extract product name and price"
  }'

Asenkron İstek + Polling— İşi gönderin, ardından durumunu sorgulayın.

bash

# İşi gönder
curl -X POST "https://api.proxyturk.com/v1/parse" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product",
    "prompt": "Extract product name and price"
  }'

# Sonucu sorgula
curl "https://api.proxyturk.com/v1/jobs/job_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

SERP API

Arama motoru sonuç sayfalarını (SERP) yapılandırılmış veri olarak alın. Google, Bing ve daha fazlası.

Senkron SERP İsteği— Arama sonuçlarını anında alın.

bash

curl -X POST "https://api.proxyturk.com/v1/serp?wait=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "best proxy providers 2025",
    "engine": "google",
    "num_results": 10
  }'

Lokasyon ile SERP— Belirli bir lokasyondan arama yapın.

bash

curl -X POST "https://api.proxyturk.com/v1/serp?wait=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "en iyi proxy servisleri",
    "engine": "google",
    "country": "TR",
    "language": "tr",
    "num_results": 10
  }'

Web Scraping

Web sayfalarının HTML, Markdown veya ekran görüntüsünü alın. JavaScript rendering ve özel aksiyonlar desteği.

Senkron Scraping— Sayfanın HTML içeriğini anında alın.

bash

curl -X POST "https://api.proxyturk.com/v1/scrape?wait=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/products",
    "format": "markdown"
  }'

Aksiyonlu Scraping— Butona tıklama, scroll gibi aksiyonlar tanımlayın.

bash

curl -X POST "https://api.proxyturk.com/v1/scrape?wait=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/products",
    "format": "html",
    "actions": [
      { "type": "click", "selector": ".load-more-btn" },
      { "type": "wait", "duration": 2000 },
      { "type": "scroll", "direction": "down", "amount": 500 }
    ],
    "javascript_rendering": true
  }'

Asenkron Scraping

bash

# İşi gönder
curl -X POST "https://api.proxyturk.com/v1/scrape" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/products",
    "format": "markdown",
    "javascript_rendering": true
  }'

# Sonucu sorgula
curl "https://api.proxyturk.com/v1/jobs/job_xyz789" \
  -H "Authorization: Bearer YOUR_API_KEY"

Job Polling

Asenkron işlerin durumunu sorgulayın. Tüm endpoint'ler için geçerlidir.

İş Durumu Sorgulama

bash

# İş durumunu kontrol et
curl "https://api.proxyturk.com/v1/jobs/job_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Yanıt formatı:
# {
#   "job_id": "job_abc123",
#   "status": "completed",   // pending | processing | completed | failed
#   "result": { ... },
#   "created_at": "2025-01-15T10:30:00Z",
#   "completed_at": "2025-01-15T10:30:05Z"
# }

E-Ticaret Scraping

E-ticaret platformlarından ürün verisi çıkarın. Fiyat, stok durumu, puan ve görseller dahil yapısal ürün bilgisi döndürür.

Ürün Verisi Çıkarma

bash

curl -X POST https://api.proxyturk.com/v1/scraping/e-commerce \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.trendyol.com/p-123456",
    "platform": "trendyol",
    "wait": true
  }'

Sosyal Medya Scraping

Sosyal medya platformlarından profil ve içerik verisi çıkarın. Takipçi, etkileşim metrikleri ve gönderi içerikleri dahil yapısal veri döndürür.

Profil Verisi Çıkarma

bash

curl -X POST https://api.proxyturk.com/v1/scraping/social-media \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.instagram.com/proxyturk",
    "platform": "instagram",
    "extract_type": "profile",
    "wait": true
  }'

Webhook Doğrulama

Webhook bildirimlerini alın ve imzayı doğrulayın. İş tamamlandığında otomatik bildirim alın.

Webhook ile İş Gönderme

bash

curl -X POST "https://api.proxyturk.com/v1/scrape" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/products",
    "format": "markdown",
    "webhook_url": "https://your-app.com/webhooks/proxyturk",
    "webhook_secret": "whsec_your_secret_key"
  }'

API Referans Özeti

Tüm endpoint'lerin hızlı referansı

Base URL: https://api.proxyturk.com/v1

Tüm istekler Authorization: Bearer YOUR_API_KEY header'ı gerektirir.

POST/v1/parseAI destekli içerik ayrıştırma

POST/v1/serpArama motoru sonuçları

POST/v1/scrapeWeb sayfası scraping

POST/v1/e-commerceE-ticaret ürün verisi çıkarma

POST/v1/social-mediaSosyal medya veri çıkarma

GET/v1/jobs/:idİş durumu sorgulama

Sık Sorulan Sorular

API entegrasyonu hakkında merak edilenler

curl -X POST "https://api.proxyturk.com/v1/parse?wait=true" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com/product", "prompt": "Extract product name and price" }'

# İşi gönder curl -X POST "https://api.proxyturk.com/v1/parse" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com/product", "prompt": "Extract product name and price" }' # Sonucu sorgula curl "https://api.proxyturk.com/v1/jobs/job_abc123" \ -H "Authorization: Bearer YOUR_API_KEY"

curl -X POST "https://api.proxyturk.com/v1/serp?wait=true" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "best proxy providers 2025", "engine": "google", "num_results": 10 }'

curl -X POST "https://api.proxyturk.com/v1/serp?wait=true" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "en iyi proxy servisleri", "engine": "google", "country": "TR", "language": "tr", "num_results": 10 }'

curl -X POST "https://api.proxyturk.com/v1/scrape?wait=true" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com/products", "format": "html", "actions": [ { "type": "click", "selector": ".load-more-btn" }, { "type": "wait", "duration": 2000 }, { "type": "scroll", "direction": "down", "amount": 500 } ], "javascript_rendering": true }'

# İşi gönder curl -X POST "https://api.proxyturk.com/v1/scrape" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com/products", "format": "markdown", "javascript_rendering": true }' # Sonucu sorgula curl "https://api.proxyturk.com/v1/jobs/job_xyz789" \ -H "Authorization: Bearer YOUR_API_KEY"

# İş durumunu kontrol et curl "https://api.proxyturk.com/v1/jobs/job_abc123" \ -H "Authorization: Bearer YOUR_API_KEY" # Yanıt formatı: # { # "job_id": "job_abc123", # "status": "completed", // pending | processing | completed | failed # "result": { ... }, # "created_at": "2025-01-15T10:30:00Z", # "completed_at": "2025-01-15T10:30:05Z" # }

curl -X POST https://api.proxyturk.com/v1/scraping/e-commerce \ -H "Authorization: Bearer API_ANAHTARINIZ" \ -H "Content-Type: application/json" \ -d '{ "url": "https://www.trendyol.com/p-123456", "platform": "trendyol", "wait": true }'

curl -X POST "https://api.proxyturk.com/v1/scrape" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com/products", "format": "markdown", "webhook_url": "https://your-app.com/webhooks/proxyturk", "webhook_secret": "whsec_your_secret_key" }'