API | ProxyMania.su

GET /api/get_proxies/{apikey}/?filter=&extended=0|1

Parameters:

filter (optional) — filter by the comment field value
extended (optional) — 0 or 1, whether to return extended information

Successful response:

[
    {
        "id": 12345,
        "ipv6": "2a00:1234:5678:90ab::1",
        "http": "192.168.1.1:8080",
        "socks": "192.168.1.1:1080",
        "username": "user123",
        "password": "pass456",
        "comment": "my proxy",
        // with extended=1:
        "expire": "2025-12-31 23:59:59",
        "ip_auth": 0,
        "ip_auth_addr": "",
        "status": 0,
        "country": "ru"
    }
]

Possible errors:

code: 1 — invalid API key

GET /api/get_countries/{apikey}?type=ipv4|ipv6

Parameters:

type (optional) — ipv4 or ipv6. If not specified, returns all types available for purchase

Successful response (type=ipv4):

[
    {
        "alpha2": "r4",
        "name": "Russia IPv4",
        "price_ipv4": 119,
        "price_ipv4_2": 99
    }
]

IPv4 prices (per 1 proxy/month):

price_ipv4 — when purchasing 1 to 99 proxies
price_ipv4_2 — when purchasing 100 or more proxies

Notes:

For IPv4, alpha2 is the country code (r4 — Russia, dedicated proxies; s4 — Russia, shared proxies)

Successful response (type=ipv6):

[
    {
        "alpha2": "ru",
        "name": "Russia",
        "price_ipv6": 7,
        "price_ipv6_2": 6,
        "price_ipv6_3": 5,
        "price_ipv6_4": 4.5,
        "price_ipv6_5": 4,
        "price_ipv6_6": 3.5,
        "price_ipv6_7": 3
    }
]

IPv6 prices (per 1 proxy/month):

price_ipv6 — when purchasing 1 to 9 proxies
price_ipv6_2 — when purchasing 10 to 99 proxies
price_ipv6_3 — when purchasing 100 to 199 proxies
price_ipv6_4 — when purchasing 200 to 299 proxies
price_ipv6_5 — when purchasing 300 to 399 proxies
price_ipv6_6 — when purchasing 400 to 499 proxies
price_ipv6_7 — when purchasing 500 or more proxies

Possible errors:

code: 1 — invalid API key

GET /api/get_freeproxys/{apikey}?country={countrycode}

Parameters:

country — country code (r4 — dedicated, s4 — shared)

Successful response:

150

Returns a number — the count of available proxies

Possible errors:

code: 1 — invalid API key

GET /api/buy_proxies/{apikey}?country=&count=&type=&period=&protocol=

Parameters:

country — country code from the list of available countries
count — number of proxies to purchase
type — ipv4 or ipv6 (default: ipv6)
period (optional) — rental period (default: 30). Allowed values for IPv6: 3, 7, 14, 30, 60, 90, 180 days. For IPv4: 30, 60, 90, 180 days
protocol (optional) — https or socks5 (default: https)

Example request:

GET https://proxymania.su/api/buy_proxies/12b4493473dcd1c70d8f4b1c7a5ffc3c?country=s4&count=10&type=ipv4&period=30

Successful response:

{
    "status": "ok",
    "purchase_id": "a1b2c3d4e5f6...",
    "sum": 300
}

Possible errors:

code: 1 — invalid API key
code: "error count" — invalid quantity
code: "country not set" — country not specified
code: "country not found" — country not found
code: "country not active" — country is not active for purchase
code: "invalid period" — invalid period (see minimum)
code: "insufficient funds" — insufficient funds (returns required and balance)
code: "no available proxies" — no available proxies
code: "not enough proxies" — not enough proxies (returns available and requested)

Notes:

purchase_id — is set as the comment on purchased proxies
sum — amount deducted from balance
IPv4 proxies are delivered immediately and activate within 1 minute.
IPv6 proxies: poll get_proxies with filter=purchase_id every 30 seconds

Warning: Do not integrate the purchase API directly into desktop software with a hardcoded key — use a server-side proxy layer instead.

POST /api/renew/{apikey}?type=ipv4|ipv6&country=
proxy_ids=13582,17371,17282

GET parameters:

type — ipv4 or ipv6
country (optional for IPv6) — country code

POST parameters:

proxy_ids — comma-separated list of proxy IDs to renew

Successful response:

{
    "status": "ok",
    "transaction_id": 12345,
    "sum": 300
}

Possible errors:

code: 1 — invalid API key
code: 2 — invalid proxy count
code: 3 — insufficient funds (returns required and balance)
code: 4 — proxy IDs not specified
code: "invalid type" — type not specified or invalid
code: "country not found" — country not found
msg: "user check fail" — proxy does not belong to the user
msg: "country check fail" — proxy country does not match the specified one

Note: You can renew proxies from different countries in a single request — the price is calculated automatically.

POST /api/set_comment/{apikey}?type=ipv4|ipv6&comment=example
proxy_ids=13582,17371,17282

GET parameters:

type — ipv4 or ipv6
comment — comment text

POST parameters:

proxy_ids — comma-separated list of proxy IDs

Successful response:

{
    "status": "ok"
}

Possible errors:

code: 1 — invalid API key
code: 2 — invalid proxy count
code: 4 — proxy IDs not specified
msg: "user check fail" — proxy does not belong to the user
msg: "comment not set" — error setting comment

POST /api/replace_proxies/{apikey}
proxy_ids=13582,17371,17282

Parameters (POST body):

proxy_ids — comma-separated list of proxy IDs to replace

Successful response:

{
    "status": "ok"
}

Possible errors:

code: 1 — invalid API key
code: 4 — replacement limit per request exceeded
code: 5 — daily replacement limit exceeded
code: 6 — replacement was already performed recently (timeout)
code: 7 — proxy with the specified ID not found

Notes:

Overall limit is 1,000 proxies per hour; each individual proxy also has a 1-hour cooldown for replacement
Only the external IPv6 address changes; the ip:port:login:password for connection remain the same

POST /api/set_ipauth/{apikey}?type=ipv4|ipv6&status=on|off
proxy_ids=13582,17371,17282&ip=185.33.22.11

GET parameters:

type — ipv4 or ipv6
status — on (enable IP binding) or off (remove)

POST parameters:

proxy_ids — comma-separated list of proxy IDs
ip — IP address for authorization (when status=on)

Successful response:

{
    "status": "ok"
}

Possible errors:

code: 1 — invalid API key
code: 2 — invalid proxy count
code: 4 — proxy IDs not specified
msg: "user check fail" — proxy does not belong to the user
msg: "wrong ip for auth" — invalid IP address (0.0.0.0, 255.255.255.255, or malformed)
msg: "ip not set" — error setting IP authorization

ProxyMania API