API Documentation | Proxy REST API

Setup Base URL

All requests go to the API host below:

BASHbase-url

https://api.fusionproxy.net/api/v1

Security Authentication

Authenticate with your owner API key (stored in users.api). Send it in any of the following (preferred listed first):

Authorization: Bearer <API_KEY>
X-API-Key: <API_KEY>
?api_key=<API_KEY> (query param)

BASH

curl -s https://api.fusionproxy.net/api/v1/me   -H 'Authorization: Bearer YOUR_API_KEY'

Tip — Rotate keys regularly and scope access per environment.

Start Quick Start

Generate (or copy) your API key in the dashboard.
Ping the API to verify connectivity.
Create a sub-user and start using its credentials.

BASH

curl -s https://api.fusionproxy.net/api/v1/ping   -H 'Authorization: Bearer YOUR_API_KEY'
# => { "ok": true, "user_id": 123, "time": "2025-01-01T12:00:00Z" }

Reference Endpoints

GET/ping

Health check and (if authenticated) returns your user_id and server time.

BASH

curl -s https://api.fusionproxy.net/api/v1/ping -H 'Authorization: Bearer YOUR_API_KEY'

GET/me

BASH

curl -s https://api.fusionproxy.net/api/v1/me   -H 'Authorization: Bearer YOUR_API_KEY'

GET/sub-users

List your sub-users.

BASH

curl -s https://api.fusionproxy.net/api/v1/sub-users -H 'Authorization: Bearer YOUR_API_KEY'

POST/sub-users

BASH

curl -sX POST https://api.fusionproxy.net/api/v1/sub-users   -H 'Authorization: BearER YOUR_API_KEY'   -H 'Content-Type: application/json'   -d '{
    "label": "Crawler #2",
    "proxy_username": "crawler_2",
    "proxy_password": "AnotherStrongP@ss",
    "gb4": 5
  }'

PATCH/sub-users/{id}

Update label, username, password, gb4, and is_active. Username uniqueness is enforced.

BASH

curl -sX PATCH https://api.fusionproxy.net/api/v1/sub-users/123   -H 'Authorization: Bearer YOUR_API_KEY'   -H 'Content-Type: application/json'   -d '{"label":"Crawler #2 (EU)","gb4":8}'

DELETE/sub-users/{id}

Soft-deactivate the sub-user (is_active = 0).

BASH

curl -sX DELETE https://api.fusionproxy.net/api/v1/sub-users/123 -H 'Authorization: Bearer YOUR_API_KEY'

POST/sub-users/{id}/rotate-password

Generate a new secure password for the sub-user.

BASH

curl -sX POST https://api.fusionproxy.net/api/v1/sub-users/123/rotate-password -H 'Authorization: Bearer YOUR_API_KEY'

Guidance Errors

We return concise, toaster-friendly messages in message. Validation errors may include an errors map.

JSON

{ "message": "Proxy username already exists (owner account)." }

Fair Use Rate Limits & Best Practices

Default: 60 requests/minute per API key (contact support to raise).
Use GET /me sparingly; cache values for 60s if polling.
Handle 429 with exponential backoff.
Always store and rotate sub-user passwords securely.

FusionProxy API

Setup Base URL

Security Authentication

Start Quick Start

Reference Endpoints

Guidance Errors

Fair Use Rate Limits & Best Practices

Have a Large Project?