Skip to main content
GET
List proxy offers
Returns the full proxy catalog grouped by kind. Use query parameters to filter the results.

Query parameters

string
Filter by proxy type. One of: datacenter, residential, mobile.residential is the static ISP product — the one on sale. static and rotating are not kinds; they are values of mode, and passing either here matches nothing. See Proxy types.
string
Filter by ISO 3166-1 alpha-2 country code (e.g., US, GB, DE).
string
Filter by region or state, matched exactly against locations[].region (max 100 characters). Can be used alone or together with city — together they must match the same location. Offers with an empty locations are excluded.
string
Filter by city, matched exactly against locations[].city (max 100 characters, e.g. New York). Can be used alone or together with region — together they must match the same location. Offers with an empty locations are excluded.The same city name can appear under more than one region (e.g. New York in New York and in Vermont); pass region alongside city to pick one.
A location narrows the choice of ISP, not a delivery guarantee: locations lists every region/city the offer’s ISP is known to serve in that country, but the order is placed against that ISP’s whole pool, so a specific city is not guaranteed. locations itself is always present on every offer, filtered or not.While location filtering is not enabled for your platform, passing region or city returns 403 — check the isp.city.enable flag via GET /flags before relying on either parameter.
boolean
When true, returns only offers currently in stock.
string
default:"USD"
Price currency to render: USD (default) or STAR (Telegram Stars). Prices are returned only in the selected currency; the other currency’s fields are omitted.

Response

array
List of offer groups, one per proxy kind.
integer
Total number of offers across all kinds.

Example