API Referans

Tüm istekler JSON formatında gönderilir ve JSON formatında yanıt döner.

Base URL: https://api.proxyturk.com Authentication: Authorization: Bearer YOUR_API_KEY Content-Type: application/json

Tüm scraping endpoint'leri varsayılan olarak async çalışır. Sync mod için URL'ye ?wait=true parametresi ekleyin.

Web sayfalarından veri çekmek için kullanılır. HTML, markdown, screenshot ve daha fazla format destekler.

Parametreler: - url (string, zorunlu): Hedef URL - formats (string[], opsiyonel): Çıktı formatları ["html", "markdown", "text", "screenshot"] - js_render (boolean, opsiyonel): JavaScript render etme (default: false) - wait_for (string, opsiyonel): CSS selector - element yüklenene kadar bekle - proxy_country (string, opsiyonel): Proxy ülkesi (TR, US, DE, vb.) - webhook_url (string, opsiyonel): Sonuç webhook URL'si

Response (200 sync / 202 async): - success: boolean - data: { html?, markdown?, text?, screenshot_url? } - meta: { processing_time_ms, credits_used } - job_id: string (async modda)

AI destekli yapılandırılmış veri çıkarma. Doğal dil komutlarıyla HTML'den JSON çıkarır.

Parametreler: - url (string, zorunlu*): Hedef URL (*url veya html'den biri zorunlu) - html (string, zorunlu*): Direkt HTML içeriği - prompt (string, zorunlu): Ne çıkarılacağını tarif eden doğal dil komutu - schema (object, opsiyonel): Beklenen JSON schema - model (string, opsiyonel): AI model seçimi (gpt-4o, claude-3.5-sonnet) - webhook_url (string, opsiyonel): Sonuç webhook URL'si

Response (200 sync / 202 async): - success: boolean - data: object (schema'ya uygun yapılandırılmış veri) - meta: { processing_time_ms, credits_used, model_used }

Arama motoru sonuçlarını (SERP) almak için kullanılır.

Parametreler: - query (string, zorunlu): Arama sorgusu - engine (string, opsiyonel): Arama motoru ("google", "bing", "yandex") - default: "google" - location (string, opsiyonel): Lokasyon ("Turkey", "United States", vb.) - language (string, opsiyonel): Dil kodu ("tr", "en", vb.) - num_results (number, opsiyonel): Sonuç sayısı (default: 10, max: 100) - device (string, opsiyonel): Cihaz tipi ("desktop", "mobile") - webhook_url (string, opsiyonel): Sonuç webhook URL'si

Response (200 sync / 202 async): - success: boolean - data: { organic: [{ position, title, url, description, snippet }], total_results, search_time_ms } - meta: { processing_time_ms, credits_used }

Async job durumunu sorgulamak için kullanılır. Job tamamlanana kadar polling yapın.

URL Parametreleri: - id (string, zorunlu): Job ID

Response (200): - job_id: string - status: "queued" | "processing" | "completed" | "failed" - endpoint: "scrape" | "parse" | "serp" - result: object (sadece status=completed ise) - error: { code, message } (sadece status=failed ise) - created_at: ISO 8601 timestamp - completed_at: ISO 8601 timestamp (tamamlanmışsa)

Polling önerisi: İlk 5 saniye her 1 saniyede, sonra her 3 saniyede sorgulayın.

Job listesini filtreleme ve sayfalama ile almak için kullanılır.

Query Parametreleri: - status (string, opsiyonel): Filtre ("queued", "processing", "completed", "failed") - endpoint (string, opsiyonel): Endpoint filtresi ("scrape", "parse", "serp") - limit (number, opsiyonel): Sayfa başına sonuç (default: 20, max: 100) - offset (number, opsiyonel): Atlanacak kayıt sayısı

Response (200): - data: Job[] - pagination: { total, limit, offset, has_more }