API توسعه‌دهندگان

API لیست پروکسی

پروکسی‌های فیلترشده و تازه‌بررسی‌شده را مستقیماً به‌صورت JSON یا متن ساده وارد کد خود کنید. همه اشتراک‌های پولی شامل دسترسی API تا ۱۰,۰۰۰ درخواست در روز هستند.

GET https://www.proxydocker.com/proxylist/api

احراز هویت

احراز هویت از طریق ایمیل حساب انجام می‌شود — نیازی به کلید مجزا نیست. ایمیل اشتراک فعال خود را در هر درخواست ارسال کنید.

email باید متعلق به یک پلن فعال باشد. هنوز حسابی ندارید؟ Get proxies →

شروع سریع

درخواست ۵۰ پروکسی SOCKS5 الیت از آمریکا یا فرانسه، به فرمت JSON.

curl "https://www.proxydocker.com/proxylist/api?email=you@example.com&format=json\
&country=us,fr&type=socks5&anonymity=elite&limit=50"

پارامترها

تمام پارامترها به جز ایمیل اختیاری هستند و می‌توانند به صورت دلخواه ترکیب شوند.

پارامترمقادیرتوضیحات
emailالزامیایمیل حساب کاربریباید متعلق به یک اشتراک فعال باشد.
formattext · jsonفرمت خروجی. پیش‌فرض متنی است.
countryus,frفیلتر بر اساس کشور (جداشده با کاما).
cityنام شهرفیلتر بر اساس شهر.
typehttp · https · socks4 · socks5پروتکل (جداشده با کاما).
portشماره پورتفیلتر بر اساس پورت.
anonymitytransparent · anonymous · eliteسطح ناشناسی.
stateمنطقه / استانفیلتر بر اساس منطقه.
timeoutمیلی‌ثانیهفقط پروکسی‌هایی با این زمان پاسخ‌دهی یا کمتر.
limit1 – 10000تعداد پروکسی‌های درخواستی برای بازگشت. مقدار پیش‌فرض 10000 است.

پاسخ

با format=json یک آرایه از Proxies دریافت می‌کنید. با format=text در هر سطر یک ip:port دریافت می‌کنید.

{
  "Proxies": [
    {
      "ip": "188.34.22.10",
      "port": 1080,
      "type": "SOCKS5",
      "country": "United States",
      "code": "US",
      "city": "Ashburn",
      "anonymity": "elite",
      "timeout": 420
    }
  ]
}

تنها پروکسی‌هایی که ظرف ۷ روز گذشته بررسی شده‌اند بازگردانده می‌شوند، جدیدترین‌ها در ابتدا.

خطاها

در صورت نامعتبر/موجود نبودن ایمیل یا منقضی شدن پلن، خطای HTTP 200 همراه با یک Notice و یک لیست خالی بازگردانده می‌شود:

{ "Notice": "Your package is already expired.", "Proxies": [] }
  • حداکثر ۱۰,۰۰۰ درخواست در روز برای هر حساب کاربری.
  • همین داده‌ها در آدرس زیر نیز در دسترس هستند: /proxylist/download و /proxylist/v2/api.

Copyright © 2026 Proxydocker.com, all rights reserved. · سیاست حفظ حریم خصوصی