Generate proxy lists, read your balance and manage your IP whitelist from code, from a proxy manager, or from an AI assistant over MCP.
| Base URL | https://www.proxare.com/v1/ — keep the trailing slash |
|---|---|
| Auth | Authorization: Bearer pxr_live_... (made in the dashboard) |
| MCP server | https://www.proxare.com/mcp/ |
| Machine-readable | OpenAPI 3.1 · llms-full.txt · llms.txt |
| Rate limit | 120 requests a minute per account |
| Cost | Generating proxy lines is free. You pay for traffic, never for lines. |
1. Make an API key
Sign in to the dashboard, open Settings and press Create key. It is shown once:
pxr_live_7Kq2xR4mNvB8cTfW1yZp6LdJhA3sEgU9nQ0rXiOk
Send it as a bearer token on every call:
Authorization: Bearer pxr_live_...
A key can read your account, generate proxy lines and change your whitelist, so treat it like a password and revoke it in the dashboard if it leaks. Keys carry three scopes — read, generate, manage — and new keys get all three. The key is not tied to an IP, so desktop software can use it directly. Nothing in the API can spend money: buying stays in the browser.
2. Your first call
What the account owns, and how much is left:
curl -s https://www.proxare.com/v1/subaccounts/ -H 'Authorization: Bearer pxr_live_...'
{
"subaccounts": [
{ "id": "private", "name": "Proxare Premium", "type": "residential",
"username": "px_alice", "leftGb": 43.812, "usedGb": 6.188, "limitGb": 50 }
]
}
The id is what every other call means by product.
3. Generate a proxy list
One call returns ready-to-paste lines, built from your own proxy login:
curl -s https://www.proxare.com/v1/proxies/ \
-H 'Authorization: Bearer pxr_live_...' \
-H 'Content-Type: application/json' \
-d '{"product":"private","count":100,"country":"de","sticky":true,"format":"hpup"}'
{
"product": "private",
"name": "Proxare Premium",
"count": 100,
"host": "premium.proxare.com",
"port": 6011,
"username": "px_alice",
"rotating": false,
"countries": ["de"],
"leftGb": 43.812,
"proxies": ["premium.proxare.com:6011:px_alice:k7Qm2x-country-de_session-ab12cd34_lifetime-30m", "..."]
}
Write proxies straight into your proxy list file. Every line gets its own session id, so 100 lines mean 100 different IPs. Generating costs no GB, so there is no reason to cache or ration lines.
Parameters
| Field | Type | Meaning |
|---|---|---|
product | string | Required. Product id from /subaccounts/, e.g. private. |
count | number | 1–1000. Default 10. |
country | string | Two-letter code, e.g. de. Leave it out for any country. |
countries | array | Several codes: the list is spread evenly over them. |
mixed | boolean | Spread the list over the standard country pool. |
city | string | Optional, together with a country, e.g. new_york. |
carrier | string | Mobile only: carrier code from /countries/. |
sticky | boolean | Default true: one IP per line for the session lifetime. false rotates on every request. |
lifetime | string | 10m, 30m (default) or 1h. |
protocol | string | http (default) or socks. |
format | string | hpup host:port:user:pass (default), uphp user:pass@host:port, uphp2 user:pass:host:port, url http://user:pass@host:port |
region | string | auto (default), eu or asia: which gateway to connect to. |
Sticky or rotating? sticky: true (the default) gives each line one IP for the lifetime — right for accounts, profiles and sessions. sticky: false gives one endpoint that changes IP on every request — right for scraping. Country or region? country picks where the IP comes out; region only picks which gateway you connect to, for latency.
Line formats
| format | Shape | Example |
|---|---|---|
hpup | host:port:user:pass What most proxy managers import. The default. | premium.proxare.com:6011:px_alice:k7Qm2x-country-us_session-ab12cd34_lifetime-30m |
uphp | user:pass@host:port Common in browser tools and bots. | px_alice:k7Qm2x-country-us_session-ab12cd34_lifetime-30m@premium.proxare.com:6011 |
uphp2 | user:pass:host:port Same fields, colons only. | px_alice:k7Qm2x-country-us_session-ab12cd34_lifetime-30m:premium.proxare.com:6011 |
url | scheme://user:pass@host:port For curl, requests, Scrapy, Puppeteer. | http://px_alice:k7Qm2x-country-us_session-ab12cd34_lifetime-30m@premium.proxare.com:6011 |
Targeting lives in the credentials, not the host: the part after the password (after the username for Geonode) carries country, session and lifetime. Ask the API for lines rather than building these strings yourself.
4. Every endpoint
| Method | Path | What it does |
|---|---|---|
GET | /v1/products/ | Products, pack sizes and prices. No key needed. |
GET | /v1/account/ | Your account: every product, GB used and GB left, proxy username, whitelisted IPs. |
GET | /v1/subaccounts/ | Short list for a sub-account dropdown. |
GET | /v1/countries/?product=mobile | Countries you can target (and mobile carriers). |
GET | /v1/orders/ | Your paid orders. |
POST | /v1/proxies/ | Generate a proxy list. |
POST | /v1/whitelist/ | Replace your IP whitelist. |
POST | /v1/password/ | Reset a product’s proxy password. |
/v1/products/ and /v1/openapi/ need no key. /v1/proxies/ also accepts a GET with the same parameters in the query string, for tools that cannot POST.
Errors
Every failure is JSON with a human-readable error you can show as it is, and a short code to branch on:
| code | HTTP | Meaning |
|---|---|---|
no_key | 401 | Missing, unknown or revoked API key. |
scope | 403 | The key does not carry the scope this call needs. |
product | 400 | Unknown product id. |
country | 400 | Not a two-letter country code. |
not_owned | 404 | You do not own that product. |
no_password | 409 | No proxy password yet — call /v1/password/ first. |
upstream | 502 | The proxy network could not be reached. Retry. |
not_found | 404 | No such endpoint. |
5. MCP server (Claude, Cursor, ChatGPT)
Proxare runs a Model Context Protocol server, so an AI assistant can look up prices, read your balance and hand you a proxy list without you leaving the chat.
https://www.proxare.com/mcp/
The trailing slash avoids a redirect; /mcp works too, for clients that follow one.
Claude Code:
claude mcp add --transport http proxare https://www.proxare.com/mcp/ \
--header "Authorization: Bearer pxr_live_..."
Claude Desktop, Cursor and anything else that reads an mcpServers block:
{
"mcpServers": {
"proxare": {
"type": "http",
"url": "https://www.proxare.com/mcp/",
"headers": { "Authorization": "Bearer pxr_live_..." }
}
}
}
Without a key the server still answers the public tools, so an assistant can compare products and prices before anyone signs up.
| Tool | What it does | Needs |
|---|---|---|
list_products | Products and prices. | no key |
price_quote | What a pack costs. | no key |
buy_link | A checkout link to open. Nothing is ever paid for you. | no key |
setup_guide | The setup guide for AdsPower, Dolphin Anty, ScrapeBox, Scrapy or Puppeteer. | no key |
my_account | Products owned, GB used and GB left. | read |
list_orders | Paid orders. | read |
list_countries | Countries and mobile carriers. | read |
generate_proxies | Build a proxy list from your own login. | generate |
whitelist_ips | Replace the IP whitelist. | manage |
reset_proxy_password | Make a new proxy password. | manage |
The server never pays for anything. buy_link returns a checkout URL for you to open yourself.
6. Letting an AI write the integration
Point your assistant at these and it has everything without crawling the site:
| /llms-full.txt | The whole integration guide as plain text: every endpoint, every parameter, worked Python and Node examples, and the mistakes that are easy to make. Paste it into a chat or let the model fetch it. |
|---|---|
| /v1/openapi/ | OpenAPI 3.1. Feed it to a code generator, or to any tool that speaks OpenAPI. |
| /llms.txt | Short index of the site in the llms.txt format. |
https://www.proxare.com/mcp/ | Or skip the code: connect the MCP server and let the assistant call the tools itself. |
A prompt that works: “Read https://www.proxare.com/llms-full.txt and write me a Python function that returns 50 sticky German proxies as a list of strings.”
7. Building a Proxare tab into your software
If you make a proxy manager, bot or scraper and want a built-in Proxare tab, three calls are enough:
GET /v1/subaccounts/— fill the sub-account dropdown and show GB left.GET /v1/countries/— fill the country dropdown.POST /v1/proxies/— writeproxiesstraight into your proxy list file.
The API sends Access-Control-Allow-Origin: * and has no IP restrictions, so a desktop app or an extension can call it directly. Want a partner link, a revenue share or a sandbox key to build against? Contact us.
Questions
Does generating proxies cost GB?
No. You are billed for the traffic you push through the proxies, never for making a list. Generate as many lines as you like.
What happens when I run out of GB?
The proxy stops connecting; the API keeps answering and shows leftGb: 0. Generating still works, so you can prepare a list and top up after. The same username and password keep working after a top-up.
Can I use one key on several machines?
Yes. Keys are not tied to an IP. Make one key per app so you can revoke them separately.
How do I get a different IP?
Ask for more lines. One line is one session, so count: 100 is 100 IPs. With sticky: false a single line changes IP on every request instead.
Is there a sandbox?
Not yet. The public endpoints need no key, and a 1 GB pack is enough to test a real integration end to end.