proxy.spider.cloud · HTTP · HTTPS · SOCKS5

Proxy API reference

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 pipeline and native browser as the REST API. No SDK needed.

Get an API key

Connection

proxy.spider.cloud

http://YOUR-API-KEY:@proxy.spider.cloud:8888

Country

Trackers

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

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

What you get

Residential proxies
Automatic IP rotation and session management on every request.
Geo-routing 199+ countries
Per-request geo-routing with the country_code param.
Throughput 1 GB/s peak
Residential proxies push up to 1 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 browser engine as the REST API. Compatible with Crawl, Scrape, Screenshot, Search, Links.

Pricing

Every request goes through residential proxies. Use country_code to geo-route.

Pool	Price	Multiplier	Description
residential	$2.00/GB	×2–×4	Real-user IPs, 199+ countries, up to 1 GB/s

With zero data retention on, a self-serve account pays 2.5x the request cost after the proxy multiplier, bandwidth included.

Request parameters

country_code string password field optional

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

trackers_disabled boolean password field default 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')}:country_code=us@proxy.spider.cloud:8888",
    'https': f"https://{os.getenv('SPIDER_API_KEY')}:country_code=us@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.