API Documentation
Automate your IP address rotation from your own scraping scripts.
Authentication
All requests to the API require a valid API key. You can generate a key from your customer portal (under the "API Keys" tab). Authentication is done via the HTTP Authorization header with the Bearer schema.
Authorization: Bearer ps_live_xxxxxxxxx
IP Rotation (Force Renewal)
POSTThis endpoint allows you to force your dedicated router to disconnect and then reconnect to the mobile tower, obtaining a fresh new IP address. The process usually takes between 3 and 8 seconds.
URL Parameters
| Parameter | Type | Description |
|---|---|---|
| assignment_id | String (UUID) | The unique identifier of your proxy (can be found on the dashboard). |
Request Example (cURL)
curl -X POST https://api.proxym.io/v1/proxies/550e8400-e29b-41d4-a716-446655440000/rotate \
-H "Authorization: Bearer ps_live_abc123..." \
-H "Content-Type: application/json"Response (Success - 200 OK)
{
"success": true,
"message": "IP rotated successfully. It may take up to 10 seconds to stabilize."
}