Документация · 14 руководств · обновлено 25 сентября 2026 г.

Всё необходимое, чтобы направить свой первый запрос.

Два имени хоста, шесть параметров имени пользователя, стандартные HTTP и SOCKS5. На этих страницах точно описана работа шлюза для тех, кто будет вставлять конечную точку в файл конфигурации.

Попробуйте

Быстрый старт Справочник API

2протоколаHTTP(S) на порту 9000 и SOCKS5 на порту 9001 во всех сетях
6параметровСтрана, штат США, город, ASN, идентификатор и срок действия сессии
24 чмакс. срок сессииУдерживайте один выходной узел с помощью -sid- от одной минуты до суток
57примеровГотовый для копирования код: 14 руководств и 84 раздела

01 — Начните здесь

Четыре страницы — и вы сможете запустить что угодно.

В первый раз прочитайте их по порядку. На все вместе уйдёт примерно столько же времени, сколько на чашку кофе, а остальные страницы предполагают, что вы уже с ними знакомы.

01 · 4 мин Быстрый старт Пять шагов, не нужно устанавливать SDK, подойдёт любой HTTP-клиент. Десять минут, если у вас уже есть криптовалюта. 02 · 3 мин Аутентификация Оба способа работают во всех сетях и с обоими протоколами. Выбирайте способ отдельно для каждого сервера и свободно сочетайте их. 03 · 3 мин Эндпоинты и порты Локация никогда не указывается в доменном имени. Общие шлюзы считывают её из логина; у выделенных прокси она фиксируется при заказе. 04 · 4 мин Таргетинг и сессии Страна, штат США, город, провайдер, идентификатор и срок действия сессии. Шесть параметров в любом порядке на обоих общих шлюзах.

02 — По типу сети

Единые правила шлюза, четыре разных варианта работы.

Ротация, тарификация, выдача и особенности каждой сети описаны на отдельных страницах. Цены указаны на страницах продуктов, а документация объясняет, что именно вы за них получаете.

Резидентские прокси res.hodlproxy.com:9000 · 9001 Ротация или закреплённая сессия, оплата за ГБ, 199 стран ISP ваш IP :8000 · 8001 Статические IP-адреса интернет-провайдеров, безлимитный трафик Серверные прокси ваш IP :8000 · 8001 100 ГБ на IP-адрес в месяц в общем пуле Мобильные прокси mob.hodlproxy.com:9000 · 9001 Пул мобильных IP-адресов с оплатой за ГБ или выделенное устройство

03 — Ваш первый запрос

Одна строка на любом языке.

URL прокси содержит всё необходимое: учётные данные, шлюз и параметры. Указанный ниже адрес просто возвращает видимый ему IP, чтобы вы могли проверить выходной узел, прежде чем использовать тот же код в реальной задаче.

-cc-us запрашивает домашнее подключение из США; запустите дважды и получите два адреса
Для пула мобильных прокси на mob.hodlproxy.com используется тот же синтаксис
Выделенным адресам параметры не нужны: ip:8000 и собственные учётные данные
HTTPS-запросы проходят через туннель CONNECT; TLS-шифрование сохраняется от начала до конца

Все примеры кода

cURL

curl -x http://USER-cc-us:[email protected]:9000 https://api.ipify.org

Python

import requests

proxy = "http://USER-cc-us:[email protected]:9000"
r = requests.get("https://api.ipify.org",
                 proxies={"http": proxy, "https": proxy}, timeout=30)
print(r.text)

Node.js

import { fetch, ProxyAgent } from "undici";

const dispatcher = new ProxyAgent("http://USER-cc-us:[email protected]:9000");
const res = await fetch("https://api.ipify.org", { dispatcher });
console.log(await res.text());

PHP

$ch = curl_init("https://api.ipify.org");
curl_setopt_array($ch, [
    CURLOPT_PROXY          => "http://res.hodlproxy.com:9000",
    CURLOPT_PROXYUSERPWD   => "USER-cc-us:PASS",
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);

proxyURL, _ := url.Parse("http://USER-cc-us:[email protected]:9000")
client := &http.Client{Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)}}
resp, err := client.Get("https://api.ipify.org")

04 — Интеграция и эксплуатация

Протоколы, рабочий код, все ошибки и API.

Всё, что понадобится при подключении HodlProxy к реальному проекту: что происходит на уровне сети, что означает каждый статус, как списываются средства с кошелька и как управлять всем этим из кода.

Интеграция · 2 мин Протоколы Стандартные протоколы без специального клиента. На этой странице точно описано поведение системы для тех, кому важно знать, что происходит на сетевом уровне. Интеграция · 4 мин Примеры кода Каждый фрагмент запрашивает https://api.ipify.org через резидентский прокси в США и выводит IP. Замените параметры имени пользователя и целевой адрес — всё остальное останется без изменений. Интеграция · 4 мин Ошибки и устранение неполадок Ошибки шлюза сопровождаются кратким описанием причины в теле ответа. Ошибки целевого сервера передаются без изменений. Большая часть диагностики сводится к тому, чтобы различить эти два вида ошибок. Аккаунт · 3 мин Кошелёк и оплата Пополняйте кошелёк на сумму от $20, покупайте трафик или арендуйте адреса за средства с баланса. Срок действия средств не истекает, а без вашего согласия ничего не продлевается. Аккаунт · 6 мин Справочник по API Все функции панели управления в формате JSON через HTTPS. Базовый URL: https://api.hodlproxy.com/v1, аутентификация Bearer, пагинация с курсором. Аккаунт · 2 мин Ограничения и добросовестное использование Эта страница намеренно краткая. Технические ограничения помещаются в одну таблицу, а правила использования — в один список.

05 — За пределами справочника

Руководства по вашим инструментам и словарь терминов.

Справочник описывает работу шлюза. Руководства показывают её в Python, Node.js, Playwright, Scrapy, браузерах и агентах; словарь даёт краткое определение каждому термину; на странице оплаты объясняется, как пополнить кошелёк криптовалютой.

Руководства · 17 Интеграции, методика, покупка Готовые к копированию настройки для requests, undici, cURL, Go, PHP, Playwright, Puppeteer, Selenium, Scrapy, браузеров, антидетект-профилей и ИИ-агентов; сессии, тестирование, бюджеты и устранение неполадок. Словарь · 73 терминов Все термины о прокси с чёткими определениями Резидентские, серверные, ISP- и мобильные прокси; ротация и закреплённые сессии; таргетинг; CONNECT и SOCKS5; обнаружение; тарификация; ошибки. На каждой странице сначала приведено краткое определение, затем объясняется его применение здесь. Платежи · только криптовалюта Как пополнить кошелёк Поддерживаемые монеты, сроки подтверждения и комиссии, зачисление пополнения на баланс в USD, шкала бонусов, данные, которые никогда не запрашиваются при регистрации, и возвраты.

06 — Вопросы

Перед тем как открыть первую страницу.

Где найти учётные данные?

После пополнения аккаунта откройте раздел «Учётные данные» в панели управления: там указаны единые имя пользователя и пароль для шлюзов резидентских и мобильных прокси. Заказы выделенных ISP-прокси, серверных прокси и мобильных устройств предоставляются с собственными строками ip:port:user:pass. Те же данные возвращают GET /v1/credentials и GET /v1/proxies.

Нужны ли отдельные учётные данные для каждой сети?

Нет. Общие шлюзы res.hodlproxy.com и mob.hodlproxy.com используют одинаковые имя пользователя и пароль; меняется только имя хоста. У каждого выделенного адреса есть собственная пара учётных данных, указанная в вашем списке, а белый список IP-адресов действует сразу для всех конечных точек.

Нужно ли устанавливать SDK?

Нет, в нём нет необходимости. Прокси HodlProxy работают по стандартным протоколам HTTP(S) и SOCKS5, поэтому подходят для любого языка, библиотеки, браузера и инструмента с поддержкой прокси. На странице примеров кода рассмотрены наиболее популярные клиенты.

Можно ли использовать те же параметры имени пользователя для мобильных прокси?

Да. Параметры -cc-, -asn-, -sid- и -ttl- одинаково работают на mob.hodlproxy.com; параметры -state- и -city- доступны для пула резидентских прокси. В пуле мобильных прокси оператор выбирается с помощью -asn-.

Как учитывается трафик в сетях с общим пулом?

Учитывается каждый байт, проходящий через шлюз в обоих направлениях: запросы и ответы, включая заголовки и записи TLS. Соединения, прерванные до достижения целевого ресурса, не тарифицируются. Трафик ISP-прокси и выделенных мобильных устройств не учитывается; для заказов серверных прокси предусмотрен месячный пул.

Сколько стоит тестирование?

Минимальное пополнение составляет $20; средства остаются на вашем балансе, пока вы их не потратите. Купите несколько ГБ резидентских прокси либо арендуйте один ISP-адрес или мобильное устройство на 24 часа, выполните инструкции из краткого руководства на реальном целевом ресурсе, а затем масштабируйте использование.

Начните, когда будете готовы

Прочитайте краткое руководство и переходите к работе.

Создайте аккаунт, пополните баланс на $20 и отправьте первый запрос к собственному целевому ресурсу. Неизрасходованные средства останутся на балансе.

Создать аккаунт Быстрый старт