Skip to main content
Docs API Ref
proxy.spider.cloud · HTTP · HTTPS · SOCKS5

Proxy

Spider works as a standard HTTP proxy. Set proxy.spider.cloud as your proxy address, put your API key in the username, and pass parameters in the password field. Every request goes through the same rendering and stealth pipeline as the REST API. No SDK needed.

Connection

proxy.spider.cloud
http://YOUR-API-KEY:proxy=residential@proxy.spider.cloud:8888
Pool
Trackers

Username carries your API key. Password carries parameters. Endpoints: HTTP :8888, HTTPS :8889, SOCKS5 :8887.

curl -x "http://YOUR-API-KEY:proxy=residential@proxy.spider.cloud:8888" \
  https://example.com

What you get

  • Two pools

    Residential and ISP, with automatic IP rotation and session management.

  • Geo-routing199+ countries

    Per-request geo-routing with the country_code param.

  • Throughput10 GB/s peak

    The ISP pool pushes up to 10 GB/s.

  • Tracker blocking

    Analytics scripts, ad networks and malicious domains are skipped by default.

  • Any HTTP client

    Works with curl, requests, axios, or anything that supports proxy config.

  • Full pipeline

    Same rendering and stealth as the REST API. Compatible with Crawl, Scrape, Screenshot, Search, Links.

Pools and pricing

Set the proxy parameter to pick a pool. Use country_code to geo-route.

PoolPriceMultiplierDescription
residential$2.00/GB×2–×4Real-user IPs, 199+ countries, up to 1 GB/s
isp$1.00/GB×1ISP-grade routing, highest throughput, up to 10 GB/s

Request parameters

proxyresidential | isppassword fielddefault residential

Picks the proxy pool for the request.

country_codestringpassword fieldoptional

Two-letter country code for per-request geo-routing.

trackers_disabledbooleanpassword fielddefault true

Blocks trackers and ad networks. Set false to allow all traffic through, for example for ad verification or full-page archiving.

Tip

Pass parameters in the password field after your API key, for example YOUR-API-KEY:trackers_disabled=false

Example

Python example
import requests, os


# Proxy configuration
proxies = {
    'http': f"http://{os.getenv('SPIDER_API_KEY')}:proxy=residential@proxy.spider.cloud:8888",
    'https': f"https://{os.getenv('SPIDER_API_KEY')}:proxy=residential@proxy.spider.cloud:8889"
}

# Function to make a request through the proxy
def get_via_proxy(url):
    try:
        response = requests.get(url, proxies=proxies)
        response.raise_for_status()
        print('Response HTTP Status Code: ', response.status_code)
        print('Response HTTP Response Body: ', response.content)
        return response.text
    except requests.exceptions.RequestException as e:
        print(f"Error: {e}")
        return None

# Example usage
if __name__ == "__main__":
     get_via_proxy("https://www.example.com")
     get_via_proxy("https://www.example.com/community")

The proxy front-end works with Crawl, Scrape, Screenshot, Search, and Links. See all proxy locations.