RedScrapeRedScrapeDocs

Quick Start

Get up and running with the RedScrape API in under 5 minutes.

Prerequisites

  • A RedScrape account sign up here
  • An API key generate one from Dashboard → Settings → API Keys
  • Wallet balance deposit funds via the dashboard or API

Step 1: Get Your API Key

Navigate to Settings → API Keys in your dashboard and create a new key. Copy the key immediately it won't be shown again.

# Test your API key
curl -H "X-API-Key: your_api_key" \
  https://api.redscrape.com/api/public/account/me

You should see your account details:

{
  "id": 5,
  "email": "[email protected]",
  "username": "yourname",
  "wallet_balance": "100.00",
  "region": "US",
  "created_at": "2025-01-01T00:00:00Z"
}

Step 2: Browse Products

List available proxy products to find the one you need:

curl https://api.redscrape.com/api/public/products/

Note the slug of the product you want for example datacenter-proxy.

Step 3: Check Pricing

Before purchasing, calculate exact pricing:

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "product_slug": "datacenter-proxy",
    "billing_period": "monthly",
    "threads": 100,
    "data_gb": 50
  }' \
  https://api.redscrape.com/api/public/payments/calculate-price

Step 4: Purchase a Plan

Make the purchase using your wallet balance:

curl -X POST -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "product_slug": "datacenter-proxy",
    "billing_period": "monthly",
    "payment_method": "wallet",
    "threads": 100,
    "data_gb": 50
  }' \
  https://api.redscrape.com/api/public/payments/purchase

Step 5: Get Proxy Credentials

Once purchased, retrieve your subscription to get the proxy connection details:

curl -H "X-API-Key: your_api_key" \
  https://api.redscrape.com/api/public/subscriptions/

The response includes everything you need under proxy_config:

{
  "proxy_config": {
    "proxy_host": "us.proxy.redscrape.com",
    "proxy_port": 10000,
    "proxy_username": "user_abc123",
    "proxy_password": "p4ssw0rd",
    "max_threads": 100,
    "max_data_bytes": 53687091200,
    "data_used_bytes": 0,
    "whitelisted_ips": []
  }
}

Step 6: Use Your Proxies

Use the credentials with any HTTP client:

# Using curl
curl -x http://user_abc123:[email protected]:10000 \
  https://httpbin.org/ip
# Using Python requests
import requests

proxies = {
    "http": "http://user_abc123:[email protected]:10000",
    "https": "http://user_abc123:[email protected]:10000",
}

response = requests.get("https://httpbin.org/ip", proxies=proxies)
print(response.json())
// Using Node.js with node-fetch + https-proxy-agent
import fetch from 'node-fetch';
import { HttpsProxyAgent } from 'https-proxy-agent';

const agent = new HttpsProxyAgent(
  'http://user_abc123:[email protected]:10000'
);

const res = await fetch('https://httpbin.org/ip', { agent });
console.log(await res.json());

Next Steps

On this page