Quick Start Guide
Get started with your first proxy request in under 5 minutes
Note: You must first sign up and receive your authentication credentials before using the proxy service. All examples use placeholder credentials - replace with your actual username and password.
import requests
proxies = {
"http": "socks5://username:[email protected]:1080",
"https": "socks5://username:[email protected]:1080"
}
response = requests.get("https://api.ipify.org", proxies=proxies)
print(f"Your proxy IP: {response.text}")
Prerequisites
- Active Swift Proxy Network account
- Authentication credentials (username/password)
- Python 3.6+ or Node.js 14+ installed
- Required libraries (requests, axios, etc.)
First Steps
- Sign up and verify your account
- Receive your credentials via email
- Choose your target location (country/city)
- Test with the IP verification endpoint
- Integrate into your application
Authentication Methods
Multiple authentication options to suit different security requirements
Username/Password
Standard SOCKS5 authentication with username and password credentials
socks5://username:[email protected]:1080
IP Whitelisting
Restrict proxy access to specific IP addresses for enhanced security
Only requests from whitelisted IPs are accepted
API Key
Programmatic access using unique API keys with rate limiting
X-API-Key: your-api-key-here
OAuth 2.0
Token-based authentication (coming in Q3 2026)
Bearer
Targeting Options
Granular control over proxy location and behavior
Country Targeting
Route traffic through specific countries
proxy.gatewaypay.online:1080?country=US
City Targeting
Pinpoint specific cities for geo-localized testing
proxy.gatewaypay.online:1080?city=new_york
ISP Targeting
Select specific Internet Service Providers
proxy.gatewaypay.online:1080?isp=comcast
Session Management
Choose between sticky sessions or rotating IPs
proxy.gatewaypay.online:1080?session=sticky&ttl=300
Code Examples
Implementation examples in multiple programming languages
Basic Example
import requests
proxies = {
"http": "socks5://username:[email protected]:1080",
"https": "socks5://username:[email protected]:1080"
}
response = requests.get("https://api.ipify.org", proxies=proxies)
print(f"Your proxy IP: {response.text}")
Advanced Example
import aiohttp
import asyncio
async def fetch_with_proxy():
proxy = "socks5://username:[email protected]:1080"
connector = aiohttp.TCPConnector()
async with aiohttp.ClientSession(connector=connector) as session:
async with session.get("https://api.ipify.org", proxy=proxy) as response:
return await response.text()
# Run the async function
print(asyncio.run(fetch_with_proxy()))
Supported Libraries
API Reference
Complete REST API documentation for programmatic access
/api/v1/auth/token
Generate authentication token
username, password
{"token": "xyz", "expires": "2026-01-01T00:00:00Z"}
/api/v1/proxies
Retrieve available proxy list
country, city, isp, limit, offset
{"proxies": [{"host": "...", "port": 1080, "location": "..."}]}
/api/v1/usage
Get usage statistics
start_date, end_date, granularity
{"total_requests": 1000, "bandwidth_mb": 50, "countries": ["US", "GB"]}
/api/v1/account
Account information and balance
none
{"plan": "enterprise", "balance": 1000, "expires": "..."}
Error Codes
Rate Limits
- Free Tier: 100 req/min
- Business: 1,000 req/min
- Enterprise: 10,000 req/min
- Custom: Contact sales
MCP Integration (Model Context Protocol)
Use our SOCKS5 proxy pool with AI agents and MCP‑compatible clients like Claude Desktop, OpenClaw, and NanoClaw.
Agent Credentials
API Key: Use_your_assigned_API_Key
MCP Manifest: https://gatewaypay.online/api/v1/mcp
Base URL: https://gatewaypay.online/api/v1
MCP Tool Calls (JSON)
{"name": "proxy_info", "parameters": {}}
{"name": "proxy_countries", "parameters": {}}
{"name": "proxy_list", "parameters": {"limit": 50, "country": "US"}}
{"name": "proxy_fetch_one", "parameters": {"id": "1"}}
{"name": "proxy_my_key", "parameters": {}}
Direct HTTP (cURL)
curl -s "https://gatewaypay.online/api/v1/proxy/info" -H "Authorization: Bearer Use_your_assigned_API_Key"
# Pool stats
curl -s "https://gatewaypay.online/api/v1/proxy/countries" -H "Authorization: Bearer Use_your_assigned_API_Key"
# Countries list
curl -s "https://gatewaypay.online/api/v1/proxy/list?limit=50&country=US" -H "Authorization: Bearer Use_your_assigned_API_Key"
# 50 US proxies
curl -s "https://gatewaypay.online/api/v1/proxy/list?limit=50&country=NL" -H "Authorization: Bearer Use_your_assigned_API_Key"
# 50 NL proxies
curl -s "https://gatewaypay.online/api/v1/proxy/list?limit=100" -H "Authorization: Bearer Use_your_assigned_API_Key"
# Any 100 proxies
Response Format
{
"proxies": [
{
"id": "1",
"host": "206.123.156.225",
"ip_port": "206.123.156.225:5133",
"country_code": "US",
"protocol": "socks5",
"type": "smtp25"
}
],
"count": 50,
"charged": 0.05
}
Usage: Use ip_port directly: socks5h://206.123.156.225:5133
Pricing & Billing
$0.001 per proxy fetched – deducted from wallet automatically. Top up: POST /api/v1/stripe/topup {"amount": 10}
Filter by Proxy Type: Currently the pool is smtp25 and socks5 type. Filter by country is live. City/state filtering requires checking what columns are populated.
curl -s "https://gatewaypay.online/api/v1/proxy/countries" -H "Authorization: Bearer Use_your_assigned_API_Key" | python3 -c "
import sys,json; d=json.load(sys.stdin)
for c in d.get('countries',[])[:10]:
print(c)
"
Use Case Tutorials
Step-by-step guides for common proxy use cases
Ad Verification in 10 Minutes
- Setup proxy with US residential IP
- Visit ad network in incognito mode
- Capture ad creatives and placements
- Verify geo-targeting accuracy
- Check for ad fraud indicators
SERP Tracking Setup Guide
- Configure proxies for target countries
- Implement rate limiting (1 req/2s)
- Parse and store SERP data
- Monitor for blocks/captchas
- Analyze ranking trends over time
Ethical Web Scraping Best Practices
- Respect robots.txt and crawl-delay
- Implement exponential backoff
- Use user-agent rotation
- Cache responses when possible
- Monitor and respect site load
Additional Resources
Need Help?
Our technical support team is ready to assist with your integration.