Proxy guide

Server-Side Proxy Rotation API

The rotation endpoint selects one proxy that matches your filters. Your application still needs to configure that address as its outbound proxy; this API returns a proxy and does not tunnel your application traffic.

SDKs

Example

GET https://proxy11.com/api/rotate?key=YOUR_API_KEY&strategy=random
# Random: selects a matching proxy each call; repeats are possible
GET /api/rotate?key=YOUR_API_KEY&country=us&type=anonymous

# Sticky: same proxy for 10 minutes per session
GET /api/rotate?key=YOUR_API_KEY&strategy=sticky&session=scraper-1&sticky_seconds=600

# Example JSON response
{"ip":"62.255.12.3","port":"80","country":"United States",
 "country_code":"us","time":0.31,"type":1,
 "strategy":"random","session":"a1b2...","pool_size":412}

Practical Tips

  • Random makes a new selection on each call, but may select the same address again.
  • Sticky sessions use the same session label within a time window; the address may change when that window rolls over.
  • The TXT variant (/api/rotate.txt) returns only ip:port. Because API keys are query parameters, avoid sharing full request URLs and restrict access to request logs.

Random and sticky are selection strategies

random selects from the matching candidate pool on each API call; it does not promise a unique address every time. sticky selects deterministically for a session and time bucket. sticky_seconds defaults to 600 and is clamped by the service to 60–3600 seconds.

The application makes the proxied request

The JSON response includes the selected ip and port along with country, check time, anonymity type, strategy, and pool size. Configure the returned address in your HTTP client's proxy option. Use a stable, non-sensitive session label when you need sticky behavior; do not put personal information in it.

Proxy API

Fetch proxy lists in TXT, JSON, CSV, or XML formats.

API documentation

Python SDK

Install with pip and use rotators or requests sessions.

Python GitHub repo

Node.js SDK

Install with npm and use async proxy helpers.

Node.js GitHub repo