BuyProxy API
Introduction
The base URL for every endpoint below is:
https://www.buyproxy.org/v1This is the same self-service API that powers your dashboard, exposed for programmatic use. Sign up, verify your email, create a key, and you can top up and generate proxies without ever opening a browser again.
Authentication
Every request needs an X-API-Key header. Create a key from Personal API keys once you have an account — see Authentication for the full signup-to-key flow, including the two calls needed to create an account by API alone.
curl https://www.buyproxy.org/v1/account \
-H "X-API-Key: bp_key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# {"plan":"free","balanceGb":4.2}Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /v1/account | Your plan and GB balance. |
| GET | /v1/plans | Your active plans and how much data is left on each. |
| POST | /v1/plans/{planId}/generate | Generate one or more proxy connection lines against a plan. |
| POST | /v1/topup/card | Start a card top-up or plan purchase — returns a payment link. |
| POST | /v1/topup/crypto | Start a crypto top-up — returns an invoice URL. |
Reselling to your own customers instead of using proxies yourself? See the Reseller API — a separate key type for managing sub-customers.
Errors
Every error response is {"error": "message"} with one of these status codes:
400 — malformed or invalid request body
401 — missing or invalid X-API-Key
404 — account or plan not found
429 — rate limit exceeded (see Rate limits)
502 / 503 — a payment or proxy provider is unavailable right now
Was this page helpful?