NovaProxy Docs

Products

Browse available proxy plans and locations

List Plans

Retrieve a list of available plans.

Endpoint: GET /plans

Parameters

  • plan_id (optional): Filter by plan ID.
  • plan_duration_id (optional): Filter by plan duration ID.

Get Plan

Retrieve details of a specific plan type.

Endpoint: GET /plans/{type}

Example: Residential Plan

GET /plans/residential

{
    "name": "Residential",
    "slug": "residential",
    "type": "bandwidth",
    "has_geo_targeting": true,
    "has_ip_whitelist": false,
    "rotations": [
        {
            "code": "rotating",
            "name": "Rotating"
        },
        {
            "code": "sticky",
            "name": "Sticky"
        }
    ],
    "protocols": [
        {
            "code": "http",
            "port": 12321
        },
        {
            "code": "socks5",
            "port": 32325
        }
    ],
    "bandwidths": [
        {
            "id": 1,
            "bandwidth": 1,
            "bandwidth_unit": "gb",
            "bandwidth_in_bytes": 1000000000,
            "price_per_gb": 1.89
        },
        // ... more bandwidth options
    ]
}

Example: Static ISP Plan

GET /plans/static-isp (inferred from Postman context, strictly it might be by ID or slug)

{
    "id": 10,
    "name": "Static ISP",
    "slug": "static-isp",
    "type": "duration",
    "has_geo_targeting": false,
    "has_ip_whitelist": false,
    "rotations": [],
    "protocols": [
        {
            "code": "http",
            "port": 59100
        },
        {
            "code": "socks5",
            "port": 59101
        }
    ],
    "durations": [
        {
            "id": 13,
            "duration": 1,
            "duration_unit": "month",
            "duration_in_minutes": 43800,
            "price": 6.99,
            "threads": null
        },
        {
            "id": 14,
            "duration": 3,
            "duration_unit": "month",
            "duration_in_minutes": 131400,
            "price": 16.99,
            "threads": null
        },
        {
            "id": 15,
            "duration": 6,
            "duration_unit": "month",
            "duration_in_minutes": 262800,
            "price": 29.99,
            "threads": null
        },
        {
            "id": 16,
            "duration": 1,
            "duration_unit": "year",
            "duration_in_minutes": 525600,
            "price": 49.99,
            "threads": null
        }
    ],
    "options": [
        {
            "name": "country",
            "is_required": true,
            "metadata": {
                "options": [
                    {
                        "key": 3346861,
                        "value": "Austria"
                    },
                    {
                        "key": 3282428,
                        "value": "Brazil"
                    },
                    {
                        "key": 3282610,
                        "value": "Canada"
                    },
                    {
                        "key": 3282338,
                        "value": "England"
                    },
                    {
                        "key": 3283069,
                        "value": "France"
                    },
                    {
                        "key": 3346950,
                        "value": "Germany"
                    },
                    {
                        "key": 4361460,
                        "value": "Hong Kong"
                    },
                    {
                        "key": 4018673,
                        "value": "India"
                    },
                    {
                        "key": 6233675,
                        "value": "Israel"
                    },
                    {
                        "key": 4200941,
                        "value": "Italy"
                    },
                    {
                        "key": 3347226,
                        "value": "Japan"
                    },
                    {
                        "key": 3347315,
                        "value": "Latvia"
                    },
                    {
                        "key": 3282699,
                        "value": "Netherlands"
                    },
                    {
                        "key": 3282789,
                        "value": "Poland"
                    },
                    {
                        "key": 3347046,
                        "value": "Romania"
                    },
                    {
                        "key": 3468194,
                        "value": "Singapore"
                    },
                    {
                        "key": 3468483,
                        "value": "Korea"
                    },
                    {
                        "key": 3282518,
                        "value": "Spain"
                    },
                    {
                        "key": 3468292,
                        "value": "Taiwan"
                    },
                    {
                        "key": 3651532,
                        "value": "Thailand"
                    },
                    {
                        "key": 3468434,
                        "value": "Turkey"
                    },
                    {
                        "key": 3282980,
                        "value": "Ukraine"
                    },
                    {
                        "key": 3282888,
                        "value": "USA"
                    }
                ]
            },
        }
    ]
}

Example: Datacenter Plan

{
    "id": 7,
    "name": "Datacenter",
    "slug": "datacenter",
    "type": "threads",
    "has_geo_targeting": false,
    "has_ip_whitelist": false,
    "rotations": [
        {
            "code": "rotating",
            "name": "Rotating"
        },
        {
            "code": "sticky",
            "name": "Sticky"
        }
    ],
    "protocols": [
        {
            "code": "http",
            "port": 777
        },
        {
            "code": "socks5",
            "port": 666
        }
    ],
    "threads": [
        {
            "id": 2,
            "duration": 1,
            "duration_unit": "day",
            "duration_in_minutes": 1440,
            "base_price": 5,
            "price_per_thread": 0.01,
            "starting_from": 5,
            "min_threads": 500,
            "max_threads": 2000,
            "step_threads": 50
        },
        // ... more thread options
    ]
}

Get Locations

Retrieve available locations for a plan.

Endpoint: GET /plans/{type}/locations

On this page