Where can I get my API key?

Log in to the Dashboard and create a new key in the API Keys section. You can start with the free plan.

What is the difference between sync and async requests?

Synchronous requests (wait=true) return results directly. Async requests return a job_id and you track results via polling or webhooks. Async is preferred for long-running operations.

What is the rate limit?

The free plan allows 10 requests per minute, paid plans allow 100-1000 requests per minute. When exceeded, HTTP 429 is returned.

Which programming languages do you support?

Official SDKs are available for Python and Node.js. Since the API is REST-based, it can be used with cURL, Go, PHP, Ruby, Java, and any language that can make HTTP requests.

Should I use webhooks or polling?

Webhooks are ideal if you want your server to receive notifications — no polling required and it's real-time. Polling is easier for simple scripts and one-off jobs.

When should I use JavaScript rendering?

Use javascript_rendering: true for SPA (Single Page Application) pages, dynamically loaded content, or pages rendered with JavaScript.

Quick Integration

API Code Examples

Integrate with the ProxyTurk Scraping API in minutes. Choose your favorite language and get started with ready-to-use code examples.

AI Parse

AI-powered content parsing. Extract structured data from any web page.

Synchronous Request— Get results instantly with the wait=true parameter.

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"
  }'

Async Request + Polling— Submit the job, then poll for results.

bash

# Submit the job
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"
  }'

# Poll for results
curl "https://api.proxyturk.com/v1/jobs/job_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

SERP API

Get search engine result pages (SERP) as structured data. Google, Bing, and more.

Synchronous SERP Request— Get search results instantly.

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
  }'

SERP with Location— Search from a specific location.

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 services",
    "engine": "google",
    "country": "US",
    "language": "en",
    "num_results": 10
  }'

Web Scraping

Get HTML, Markdown, or screenshots of web pages. JavaScript rendering and custom actions support.

Synchronous Scraping— Get page HTML content instantly.

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"
  }'

Scraping with Actions— Define actions like button clicks and scrolling.

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
  }'

Async Scraping

bash

# Submit the job
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
  }'

# Poll for results
curl "https://api.proxyturk.com/v1/jobs/job_xyz789" \
  -H "Authorization: Bearer YOUR_API_KEY"

Job Polling

Poll async job status. Applicable to all endpoints.

Check Job Status

bash

# Check job status
curl "https://api.proxyturk.com/v1/jobs/job_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response 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-Commerce Scraping

Extract product data from e-commerce platforms. Returns structured product information including price, availability, ratings and images.

Extract Product Data

bash

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

Social Media Scraping

Extract profile and content data from social media platforms. Returns structured data including followers, engagement metrics and post content.

Extract Profile Data

bash

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

Webhook Verification

Receive webhook notifications and verify signatures. Get automatic notifications when jobs complete.

Submit Job with Webhook

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 Reference Summary

Quick reference for all endpoints

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

All requests require the Authorization: Bearer YOUR_API_KEY header.

POST/v1/parseAI-powered content parsing

POST/v1/serpSearch engine results

POST/v1/scrapeWeb page scraping

POST/v1/e-commerceE-commerce product extraction

POST/v1/social-mediaSocial media data extraction

GET/v1/jobs/:idJob status polling

Frequently Asked Questions

Common questions about API integration

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" }'

# Submit the job 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" }' # Poll for results 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": "best proxy services", "engine": "google", "country": "US", "language": "en", "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 }'

# Submit the job 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 }' # Poll for results curl "https://api.proxyturk.com/v1/jobs/job_xyz789" \ -H "Authorization: Bearer YOUR_API_KEY"

# Check job status curl "https://api.proxyturk.com/v1/jobs/job_abc123" \ -H "Authorization: Bearer YOUR_API_KEY" # Response 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 YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://www.amazon.com/dp/B0BSHF7WHW", "platform": "amazon", "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" }'