API Integration in 5 Steps
This guide walks you through creating an account to sending your first API request. You will have a working integration in under 5 minutes.
Start by creating a ProxyTurk account. You automatically receive 500 free credits upon registration. Use these credits to test all API features.
Go to the registration page and create an account with your email. After completing email verification, you can access the dashboard.
After logging into the dashboard, navigate to the "API Keys" section. Click "Create New API Key" to generate a key.
IMPORTANT: Store your API key securely. We recommend using it as an environment variable. Never commit it to git.
Once you have your API key, you can send your first request. The examples below send a simple web scraping request in sync mode (waiting for the result).
Base URL: https://api.proxyturk.com Authentication: Send your API key as a Bearer token.
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", "formats": ["markdown"] }'A successful request returns a JSON response containing:
- success: Whether the request succeeded (boolean) - data: The extracted data (varies by endpoint) - meta: Additional info like processing time and credit cost - job_id: ID used to track the job in async mode
After successfully sending your first request:
- Install the Python or Node.js SDK to speed up development - Set up webhooks to automatically receive async results - Check the Code Examples page for real-world scenarios - Read the API Reference for rate limits and error handling
You can revoke the existing key and create a new one from the dashboard. The old key is immediately disabled.
The 500 free credits never expire. They only decrease as you use them. There is no time limit.
Sync mode (?wait=true) keeps the connection open until the result is ready (max 60s). Async mode immediately returns a job_id, and you get the result via polling or webhook.