Proxy API Docs: Order, Balance at Username

Paano magsimula?

1Mag-sign up at mag-log in sa dashboard.
2Buksan ang Connect at gumawa ng API key. Isang beses lang ipapakita ang buong key, kaya kopyahin ito sa ligtas na lugar.
3Ipadala ang key sa Authorization header sa bawat request na nangangailangan nito.
4Tawagan ang /account para malaman kung gumagana ang key, tapos mag-order gamit ang /orders.

Paano gumagana ang authentication?

Kailangan ng API key ang mga request para sa sarili mong account (account, orders, proxy-user). Ipadala ito bilang Bearer token sa Authorization header. Pampubliko ang presyo, mga bansa at quote at hindi kailangan ng key.

Hash lang ng key ang itinatago namin. Kapag nawala mo ito, gumawa ng bago sa dashboard at agad hihinto sa paggana ang lumang key. Huwag ilagay ang key sa browser code at pampublikong repository.

HTTP header

Authorization: Bearer pdk_your_api_key

Base URL at format

Base URL: https://proxyday.shop/api/v1
Body ng request at response: application/json
Pera: Numero sa USD, halimbawa 807.90
Oras: ISO 8601 (UTC)

May rate limit ba?

Hanggang 60 request kada minuto ang puwedeng ipadala ng bawat API key. Ang pampublikong endpoint ay 60 request kada minuto bawat IP. Kapag lumampas, HTTP 429 ang makukuha mo, kaya maghintay ng isang minuto at subukan ulit.

Ano ang itsura ng error?

Gumagamit ang error ng HTTP status code at JSON body na may maikling code at mensahe.

Halimbawa

{
  "error": {
    "code": "insufficient_balance",
    "message": "Your balance is too low for this order. Top up in the dashboard."
  }
}

HTTP	code	Ibig sabihin
400	bad_request	May value na kulang o hindi puwede sa produktong ito.
401	unauthorized	Walang API key o hindi ito valid.
402	insufficient_balance	Mas mababa ang balance kaysa sa kabuuan ng order. Walang siningil.
404	not_found	Walang order na may ganitong id sa account mo.
429	rate_limited	Sobrang daming request sa loob ng isang minuto.
500	server_error	Hindi natapos ang request. Walang siningil.

Mga endpoint

Kunin ang account mo

GET/api/v1/accountAPI key

Ibinabalik ang balance mo, proxy host, mga port, username at password, at mga allowed IP.

Request

curl https://proxyday.shop/api/v1/account \
  -H "Authorization: Bearer pdk_your_api_key"

Response

{
  "email": "you@example.com",
  "balance_usd": 1300,
  "proxy": {
    "host": "gate.proxyday.shop",
    "http_port": 6100,
    "socks5_port": 6200,
    "username": "pdexample1",
    "password": "your_password"
  },
  "allowed_ips": [
    "203.0.113.10"
  ]
}

Listahan ng produkto at presyo

GET/api/v1/productsHindi kailangan ng key

Ibinabalik ang bawat produkto kasama ang limit, price tier at discount nito. Galing sa parehong table ng pricing page ang mga presyo.

Request

curl https://proxyday.shop/api/v1/products

Response

{
  "currency": "USD",
  "prices_as_of": "2026-10-31",
  "products": [
    {
      "id": "unlimited",
      "unit": "day",
      "quantity": {
        "meaning": "days",
        "min": 1,
        "max": 365
      },
      "...": "..."
    },
    {
      "id": "residential",
      "unit": "gb",
      "...": "..."
    }
  ]
}

Listahan ng bansa at lungsod

GET/api/v1/countriesHindi kailangan ng key

Ibinabalik ang mga bansang available para sa isang produkto, kasama ang city value na puwedeng ilagay sa proxy username.

Field	Uri	Ibig sabihin
`product`Opsyonal	string	unlimited, residential, isp o datacenter. Default ang residential.

Request

curl "https://proxyday.shop/api/v1/countries?product=datacenter"

Response

{
  "product": "datacenter",
  "countries": [
    {
      "code": "us",
      "name": "United States",
      "region": "americas",
      "datacenter": true,
      "cities": [
        {
          "name": "New York",
          "value": "new_york"
        },
        {
          "name": "Los Angeles",
          "value": "los_angeles"
        }
      ]
    }
  ]
}

Kumuha ng price quote

POST/api/v1/quoteHindi kailangan ng key

Kinukuwenta ang kabuuan ng order nang walang sinisingil. Gamitin ang parehong body na gamit sa pag-order.

Field	Uri	Ibig sabihin
`product`Kailangan	string	unlimited, residential, isp o datacenter.
`quantity`Kailangan	integer	Araw para sa unlimited (1~365), GB para sa residential (5~5,000), IP para sa isp (1~1,000) o datacenter (5~5,000).
`concurrency`Opsyonal	integer	Para sa unlimited lang: 200, 500, 1000 o 2000.
`bandwidth`Opsyonal	integer	Para sa unlimited lang, sa Mbps: 100, 200, 500 o 1000.
`months`Opsyonal	integer	Para sa isp at datacenter lang: 1, 3, 6 o 12.
`country`Opsyonal	string	Para sa isp at datacenter lang: country code na dalawang letra, halimbawa jp. Tingnan ang /countries.

Request

curl -X POST https://proxyday.shop/api/v1/quote \
  -H "Content-Type: application/json" \
  -d '{"product":"unlimited","quantity":30,"concurrency":1000,"bandwidth":200}'

Response

{
  "product": "unlimited",
  "quantity": 30,
  "unit_price_usd": 8.6,
  "unit": "day",
  "total_usd": 258
}

Mag-order

POST/api/v1/ordersAPI key

Kinukuha ang kabuuan mula sa balance mo at ginagawa ang order. Nagsisimula ang bagong order bilang pending (activating) at nagiging active kapag handa na. Kapag hindi ma-activate ang order, nagiging refunded ito at babalik sa balance mo ang buong halaga. Ibinabalik ang 402 kapag kulang ang balance.

Field	Uri	Ibig sabihin
`product`Kailangan	string	unlimited, residential, isp o datacenter.
`quantity`Kailangan	integer	Araw para sa unlimited (1~365), GB para sa residential (5~5,000), IP para sa isp (1~1,000) o datacenter (5~5,000).
`concurrency`Opsyonal	integer	Para sa unlimited lang: 200, 500, 1000 o 2000.
`bandwidth`Opsyonal	integer	Para sa unlimited lang, sa Mbps: 100, 200, 500 o 1000.
`months`Opsyonal	integer	Para sa isp at datacenter lang: 1, 3, 6 o 12.
`country`Opsyonal	string	Para sa isp at datacenter lang: country code na dalawang letra, halimbawa jp. Tingnan ang /countries.

Request

curl -X POST https://proxyday.shop/api/v1/orders \
  -H "Authorization: Bearer pdk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"product":"unlimited","quantity":30,"concurrency":1000,"bandwidth":200}'

Response

{
  "order": {
    "id": "PD-7KQ2M-X4HTD",
    "product": "unlimited",
    "quantity": 30,
    "months": null,
    "concurrency": 1000,
    "bandwidth_mbps": 200,
    "country": null,
    "unit_price_usd": 8.6,
    "total_usd": 258,
    "status": "pending",
    "created_at": "2026-10-31T09:12:44.120Z",
    "updated_at": "2026-10-31T09:12:44.120Z"
  },
  "balance_usd": 1042
}

Listahan ng mga order mo

GET/api/v1/ordersAPI key

Ibinabalik ang huling 100 order mo, pinakabago muna.

Field	Uri	Ibig sabihin
`status`Opsyonal	string	pending, active o refunded. Huwag ilagay para makuha lahat.

Request

curl "https://proxyday.shop/api/v1/orders?status=pending" \
  -H "Authorization: Bearer pdk_your_api_key"

Response

{
  "orders": [
    {
      "id": "PD-7KQ2M-X4HTD",
      "product": "unlimited",
      "quantity": 30,
      "months": null,
      "concurrency": 1000,
      "bandwidth_mbps": 200,
      "country": null,
      "unit_price_usd": 8.6,
      "total_usd": 258,
      "status": "pending",
      "created_at": "2026-10-31T09:12:44.120Z",
      "updated_at": "2026-10-31T09:12:44.120Z"
    }
  ]
}

Kunin ang isang order

GET/api/v1/orders/{id}API key

Ibinabalik ang isang order ayon sa id nito, halimbawa para malaman kung active na ito.

Field	Uri	Ibig sabihin
`id`Kailangan	string	Ang order id, halimbawa PD-7KQ2M-X4HTD.

Request

curl https://proxyday.shop/api/v1/orders/PD-7KQ2M-X4HTD \
  -H "Authorization: Bearer pdk_your_api_key"

Response

{
  "order": {
    "id": "PD-7KQ2M-X4HTD",
    "product": "unlimited",
    "quantity": 30,
    "months": null,
    "concurrency": 1000,
    "bandwidth_mbps": 200,
    "country": null,
    "unit_price_usd": 8.6,
    "total_usd": 258,
    "status": "active",
    "created_at": "2026-10-31T09:12:44.120Z",
    "updated_at": "2026-10-31T09:40:02.511Z"
  }
}

Bumuo ng proxy username

GET/api/v1/proxy-userAPI key

Ibinabalik ang proxy username na may options mo, kasama ang handang HTTP at SOCKS5 proxy URL. Kapag walang session, umiikot ang IP sa bawat request.

Field	Uri	Ibig sabihin
`product`Opsyonal	string	unlimited, residential, isp o datacenter. Default ang unlimited.
`country`Opsyonal	string	Country code na dalawang letra, halimbawa jp.
`city`Opsyonal	string	City value mula sa /countries, halimbawa tokyo. Kailangan ng country.
`session`Opsyonal	string	Kahit anong 1~32 letra o numero. Parehong IP ang hawak ng mga request na may parehong session.
`ttl`Opsyonal	integer	Ilang minuto hahawakan ang session IP, 1~60. Default ang 30.

Request

curl "https://proxyday.shop/api/v1/proxy-user?product=residential&country=jp&city=tokyo&session=job42&ttl=30" \
  -H "Authorization: Bearer pdk_your_api_key"

Response

{
  "username": "pdexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30",
  "password": "your_password",
  "http": "http://pdexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30:your_password@gate.proxyday.shop:6100",
  "socks5": "socks5h://pdexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30:your_password@gate.proxyday.shop:6200"
}

Buong halimbawa

Tinitingnan ng mga halimbawang ito ang presyo, nag-o-order mula sa balance at kumokonekta gamit ang IP sa Japan.

Python (requests)

import requests

API = "https://proxyday.shop/api/v1"
HEAD = {"Authorization": "Bearer pdk_your_api_key"}

# 1) Check the price first
plan = {"product": "residential", "quantity": 100}
print(requests.post(f"{API}/quote", json=plan).json())

# 2) Order from your balance
r = requests.post(f"{API}/orders", json=plan, headers=HEAD)
order = r.json()["order"]
print(order["id"], order["status"])

# 3) Get a username for Japanese IPs
u = requests.get(f"{API}/proxy-user", headers=HEAD,
                 params={"product": "residential", "country": "jp"}).json()
proxies = {"http": u["http"], "https": u["http"]}
print(requests.get("https://ipinfo.io/json", proxies=proxies, timeout=30).json())

Node.js 18+

const API = "https://proxyday.shop/api/v1";
const HEAD = { Authorization: "Bearer pdk_your_api_key", "Content-Type": "application/json" };

// Check the balance
const acc = await fetch(`${API}/account`, { headers: HEAD }).then((r) => r.json());
console.log(acc.balance_usd);

// Order 7 days of unlimited
const res = await fetch(`${API}/orders`, {
  method: "POST",
  headers: HEAD,
  body: JSON.stringify({ product: "unlimited", quantity: 7, concurrency: 500, bandwidth: 100 }),
});
if (res.status === 402) console.log("Top up first");
else console.log((await res.json()).order.id);

Pareho ang order na ginawa sa API at ang order mula sa dashboard, at lumalabas ito sa History. Palitan ang pdk_your_api_key ng sarili mong key.

Dokumentasyon ng proxy API

Paano magsimula?

Paano gumagana ang authentication?

Base URL at format

May rate limit ba?

Ano ang itsura ng error?

Kunin ang account mo

Listahan ng produkto at presyo

Listahan ng bansa at lungsod

Kumuha ng price quote

Mag-order

Listahan ng mga order mo

Kunin ang isang order

Bumuo ng proxy username

Buong halimbawa

Ikonekta ang ProxyDay sa sarili mong system