प्रॉक्सी API दस्तावेज़: REST API से प्रॉक्सी सूची प्राप्त करना

API से क्या किया जा सकता है?

प्रोग्राम को सीधे नवीनतम सूची प्राप्त करने के लिए API उपयोग करें। क्रॉलर शुरू करते समय या प्लान बदलने पर स्वचालित अपडेट। API और डैशबोर्ड डाउनलोड एक ही डेटा है।

API केवल पढ़ने के लिए है। बैलेंस जांच, प्लान सूची, प्रॉक्सी सूची जांच का समर्थन करता है, और भुगतान और खरीद डैशबोर्ड में की जाती है। सभी प्रतिक्रियाएं UTF-8 में होती हैं और तिथियां ISO 8601 UTC प्रारूप में होती हैं।

API कुंजी कैसे बनाएं और भेजें?

डैशबोर्ड के API कुंजी पेज से कुंजी बनाएं। कुंजी spx_ से शुरू होकर 44 अक्षरों की होती है, और बनाते समय केवल एक बार दिखाई देती है। सर्वर पर केवल कुंजी का फिंगरप्रिंट (हैश) स्टोर रहता है, इसलिए खो जाने पर नई कुंजी बना सकते हैं। नई कुंजी बनाते ही पुरानी कुंजी काम करना बंद कर देती है।

प्रत्येक अनुरोध में Authorization हेडर के रूप में Bearer कुंजी जोड़ें। URL क्वेरी में कुंजी जोड़ने की विधि स्वीकार नहीं की जाती है। कुंजी के अभाव या गलत होने पर 401 unauthorized प्रतिक्रिया मिलेगी।

curl -H "Authorization: Bearer spx_your_api_key" https://socks5proxy.io/api/v1/account

बैलेंस और अकाउंट इंफो चेक करें: GET /account

खाता कोड, बैलेंस, सक्रिय प्लान की संख्या और प्रॉक्सी की संख्या लौटाता है। बैलेंस दशमलव के दूसरे स्थान तक (USD) में दिखाया जाता है।

curl -H "Authorization: Bearer spx_your_api_key" https://socks5proxy.io/api/v1/account

{
  "code": "S5-7KQ2-M8PX-4HDA",
  "balance": "125.40",
  "currency": "USD",
  "active_plans": 2,
  "proxies": 125,
  "created_at": "2026-10-22T08:15:02.114Z"
}

प्लान सूची प्राप्त करें: GET /plans

खरीदे गए प्लान को हाल के अनुसार दिखाया जाता है। स्थिति active (उपयोग में), expired (अवधि समाप्त), canceled (रद्द) में से एक हो सकती है। id प्लान कोड है (P- से शुरू) और /proxies में plan मान के रूप में उपयोग किया जा सकता है।

{
  "plans": [
    {
      "id": "P-8WQ4C-NM2KT",
      "product": "dc-private",
      "product_name": "Private Datacenter Proxy",
      "ips": 100,
      "months": 1,
      "country": "us",
      "status": "active",
      "amount": "49.40",
      "created_at": "2026-10-22T08:20:11.002Z",
      "expires_at": "2026-11-22T08:20:11.002Z"
    }
  ]
}

प्रॉक्सी सूची जांच: GET /proxies

आपके द्वारा उपयोग की जा रही योजना के प्रॉक्सी को JSON में वापस कर देता है। प्रत्येक प्रॉक्सी में पता, HTTP पोर्ट, SOCKS5 पोर्ट, यूज़रनेम, पासवर्ड, देश, शहर, योजना कोड और समाप्ति समय शामिल होता है।

country (दो अक्षर वाला देश कोड, जैसे: us) और plan (प्लान कोड) से फिल्टर किया जा सकता है। protocol वैल्यू रिस्पॉन्स में वैसे ही दिखाई देगी, और JSON में दोनों पोर्ट्स शामिल होंगे।

curl -H "Authorization: Bearer spx_your_api_key" \
  "https://socks5proxy.io/api/v1/proxies?country=us&protocol=socks5"

{
  "count": 1,
  "protocol": "socks5",
  "proxies": [
    {
      "host": "198.51.100.23",
      "http_port": 8231,
      "socks5_port": 1080,
      "username": "spx_k2m8qa",
      "password": "q7rbx2wd9n",
      "country": "us",
      "city": "New York",
      "plan": "P-8WQ4C-NM2KT",
      "product": "dc-private",
      "product_name": "Private Datacenter Proxy",
      "expires_at": "2026-11-22T08:20:11.002Z"
    }
  ]
}

सूची डाउनलोड करें: GET /proxies/download

प्रोग्राम को सीधे पढ़ने के लिए प्रत्येक पंक्ति में एक प्रॉक्सी लौटाएं। protocol socks5 होने पर SOCKS5 पोर्ट और http होने पर HTTP पोर्ट शामिल करें। format=url होने पर protocol के अनुसार पता प्रारंभिक भाग (socks5:// या http://) जोड़ा जाता है।

IP प्राधिकरण सक्षम सर्वर पर ip:port प्रारूप में प्राप्त कर उपयोगकर्ता नाम के बिना सीधे कनेक्ट किया जा सकता है। CSV में पहली पंक्ति में कॉलम नाम होते हैं और दोनों पोर्ट शामिल होते हैं।

curl -H "Authorization: Bearer spx_your_api_key" \
  "https://socks5proxy.io/api/v1/proxies/download?format=url&protocol=socks5" -o proxies.txt

कोड उदाहरण: Python, Node.js, PHP

नीचे दिया गया उदाहरण सूची प्राप्त करके पहले प्रॉक्सी पर अनुरोध भेजता है। Python में SOCKS5 का उपयोग करने के लिए requests[socks] पैकेज की आवश्यकता होती है, और socks5h का उपयोग करने पर डोमेन नाम का समाधान भी प्रॉक्सी द्वारा किया जाता है।

import requests

API = "https://socks5proxy.io/api/v1"
H = {"Authorization": "Bearer spx_your_api_key"}

proxies = requests.get(f"{API}/proxies", headers=H, params={"country": "us"}).json()["proxies"]
p = proxies[0]
url = f"socks5h://{p['username']}:{p['password']}@{p['host']}:{p['socks5_port']}"
r = requests.get("https://api.ipify.org?format=json", proxies={"http": url, "https": url}, timeout=30)
print(r.json())

import { ProxyAgent, fetch } from "undici";

const API = "https://socks5proxy.io/api/v1";
const H = { Authorization: "Bearer spx_your_api_key" };

const { proxies } = await (await fetch(`${API}/proxies?country=us`, { headers: H })).json();
const p = proxies[0];
const agent = new ProxyAgent(`http://${p.username}:${p.password}@${p.host}:${p.http_port}`);
const r = await fetch("https://api.ipify.org?format=json", { dispatcher: agent });
console.log(await r.json());

<?php
$ch = curl_init("https://socks5proxy.io/api/v1/proxies/download?format=ip:port:user:pass&protocol=http");
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER => ["Authorization: Bearer spx_your_api_key"],
  CURLOPT_RETURNTRANSFER => true,
]);
$lines = explode("\n", trim(curl_exec($ch)));
[$host, $port, $user, $pass] = explode(":", $lines[0]);
echo "$host:$port\n";

त्रुटि कोड और कॉल सीमा

त्रुटियाँ HTTP स्टेटस कोड के साथ { "error": { "code", "message" } } फॉर्मेट में लौटाई जाती हैं। प्रति कुंजी 300 कॉल प्रति मिनट की सीमा है, और इससे अधिक होने पर 1 मिनट के लिए 429 रिस्पॉन्स मिलता है। सूची केवल खरीद या एक्सपायर होने पर बदलती है, इसलिए कुछ मिनटों में एक बार डाउनलोड करके प्रोग्राम में पुन: उपयोग करने की सलाह दी जाती है।

API कॉल में कोई शुल्क नहीं है। बैलेंस से केवल डैशबोर्ड में प्लान खरीदने पर कटौती होती है।