Proxy API

Manage proxy pools and generate proxy URLs.

Proxy URL Format

Proxy URLs follow this format for direct HTTP/SOCKS connections:

http://{username}:{password}@gateway.scrayle.com:{port}

Geo-targeting is encoded in the username. The SDK handles this automatically.

Create Proxy Pool

POST /api/v1/proxies/pool
Content-Type: application/json
x-api-key: YOUR_API_KEY

{
  "name": "My Proxy Pool",
  "proxies": [
    { "url": "http://user1:[email protected]:8080" },
    { "url": "socks5://user2:[email protected]:1080" }
  ]
}

List Proxy Pools

GET /api/v1/proxies/pool
x-api-key: YOUR_API_KEY

Delete Proxy Pool

DELETE /api/v1/proxies/pool/:id
x-api-key: YOUR_API_KEY

Supported Protocols

Protocol	Description
`http`	HTTP proxy
`https`	HTTPS proxy
`socks4`	SOCKS4 proxy
`socks5`	SOCKS5 proxy

Geo-Targeting

Target specific locations when using Scrayle's proxy network:

Parameter	Example	Description
Country	`US`	2-letter country code
State	`california`	State or region name
City	`los-angeles`	City name

Session Stickiness

Use the session parameter to maintain the same IP for a duration:

// SDK usage
const proxyUrl = client.proxies.createProxy({
  country: 'US',
  session: 'my-session-id',
  sessionDuration: 600, // 10 minutes
});