ProxyTurk Developer API
Everything you need to integrate with the ProxyTurk API. Web Scraping, SERP, and AI Parser endpoints with comprehensive examples.
https://api.proxyturk.comThe ProxyTurk API is a RESTful API that allows you to scrape web pages, query search engine results, and extract structured data using AI. All requests and responses use JSON format.
Base URL
https://api.proxyturk.comAuthentication
Bearer TokenContent-Type
application/jsonAll scraping endpoints work asynchronously by default. Add ?wait=true to the URL for synchronous mode (waits up to 60 seconds).
All API requests require authentication via a Bearer token in the Authorization header.
Authorization: Bearer YOUR_API_KEYsk_live_Production key — performs real operations and consumes creditssk_test_Test key — returns mock data, does not consume credits| Plan | Limit |
|---|---|
| Free | 10 requests/minute |
| Pro | 100 requests/minute |
| Business | 500 requests/minute |
| Enterprise | Custom |
The API uses standard HTTP status codes. Errors return a JSON body with a machine-readable code and a human-readable message.
The request contains invalid or missing parameters.
Solution: Check request parameters against the API reference. Validate your JSON body.
Authentication failed.
Solution: Verify your API key in the Dashboard. Ensure header format: "Authorization: Bearer YOUR_KEY".
Insufficient credits or balance.
Solution: Top up your balance or upgrade your plan from the Dashboard.
Valid key but lacking required permissions.
Solution: Check your plan and key permissions in the Dashboard.
Requested resource was not found.
Solution: Ensure Base URL is https://api.proxyturk.com/v1/. Check the endpoint name and job ID.
Rate limit exceeded.
Solution: Wait for Retry-After seconds. SDKs handle automatic retries. Upgrade plan for higher limits.
An unexpected error occurred on the server.
Solution: Retry after a few seconds. Check status.proxyturk.com for system status.
Official SDKs for quick integration. Both include auto-retry, type safety, and webhook verification helpers.
Sync & async modes, httpx-based, automatic retries, custom exception classes.
pip install proxyturkTypeScript-ready, Promise-based API, auto-retry, Bun & Deno compatible.
npm install @proxyturk/sdkReceive async job results automatically via HTTP POST to your server. No polling needed.
job.completedJob completed successfully — result field contains datajob.failedJob failed — error field contains details{
"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"
}
}