Working with our API

If you are a reseller, you must:

Notify users about proxy usage rules. That proxies are only suitable for legal purposes.

Store verified email and IP addresses of users. IP of payments made. In case of violation of the rules, the account will be blocked.

Text that you must show to users before ordering:

Our proxies are only suitable for white hat purposes

Authorization

Your API-key
yourapikeyyourapikey
For authorization, you need to pass your api-key in each request. You can do this by adding a parameter api_key equal to your key to the request , or you can pass a headerAPI-KEY.

Restrictions

The maximum number of requests per minute is 50.

Country

  • ru - Russia
  • de - Germany
  • us - USA
  • nl - Netherland
  • gb - United Kingdom
  • ca - Canada
  • es - Spain
  • it - Italy
  • id - Indonesia
  • fr - France
  • ch - Switzerland
  • pt - Portugal
  • ua - Ukraine
  • kz - Kazakhstan
  • cn - China
  • pl - Poland
  • in - India
  • jp - Japan
  • ab - Abkhazia
  • al - Albania
  • dz - Algeria
  • ar - Argentina
  • am - Armenia
  • au - Australia
  • at - Austria
  • az - Azerbaijan
  • bd - Bangladesh
  • by - Belarus
  • be - Belgium
  • bo - Bolivia
  • ba - Bosnia and Herzegovina
  • br - Brazil
  • bg - Bulgaria
  • kh - Cambodia
  • cm - Cameroon
  • cl - Chile
  • co - Colombia
  • cr - Costa Rica
  • hr - Croatia
  • cu - Cuba
  • cy - Cyprus
  • cz - Czech Republic
  • dk - Denmark
  • eg - Egypt
  • ee - Estonia
  • et - Ethiopia
  • fi - Finland
  • ge - Georgia
  • gr - Greece
  • hk - Hong Kong
  • hu - Hungary
  • is - Iceland
  • ir - Iran
  • iq - Iraq
  • ie - Ireland
  • il - Israel
  • ci - Ivory Coast
  • jm - Jamaica
  • jo - Jordan
  • ke - Kenya
  • kg - Kyrgyzstan
  • lv - Latvia
  • lb - Lebanon
  • ly - Libya
  • lt - Lithuania
  • lu - Luxembourg
  • my - Malaysia
  • mv - Maldives
  • mt - Malta
  • mx - Mexico
  • md - Moldova
  • mc - Monaco
  • mn - Mongolia
  • me - Montenegro
  • ma - Morocco
  • np - Nepal
  • nz - New Zealand
  • ng - Nigeria
  • no - Norway
  • pk - Pakistan
  • py - Paraguay
  • pe - Peru
  • ph - Philippines
  • qa - Qatar
  • ro - Romania
  • sa - Saudi Arabia
  • rs - Serbia
  • sc - Seychelles
  • sg - Singapore
  • sk - Slovakia
  • si - Slovenia
  • za - South Africa
  • kr - South Korea
  • sd - South Sudan
  • lk - Sri Lanka
  • se - Sweden
  • tw - Taiwan
  • tj - Tajikistan
  • tz - Tanzania
  • th - Thailand
  • tn - Tunisia
  • tr - Turkey
  • tm - Turkmenistan
  • ae - United Arab Emirates
  • uy - Uruguay
  • uz - Uzbekistan
  • ve - Venezuela
  • vn - Vietnam
  • zm - Zambia

Methods

proxies

A method to get a proxy list.
https://my.onlyproxy.com/api/proxies/?api_key=yourapikeyyourapikey

Options:

  • status — proxy status: active, expired, deleted. By default , all are shown.
  • type — proxy type: dedicated or shared
  • ip_version - IP version: 4 or 6
  • country – country code, country code. You can specify it several times. country=en&country=ru
  • date_after, date_before is the date of purchase, lower and upper bounds. Format 2018-10-25. Includes the specified day.
  • date_end_after, is the date_end_before end date of the order, the lower and upper bounds. Format 2018-10-25. Includes the specified day.
  • orders - Order ID. You can specify it several times.
  • format — Format for receiving a response. You can specify txt-http or txt-socks5 to get a list of proxies in text form. Or custom-http or custom-socks5 to use an arbitrary format from the settings.
  • limit is the proxy limit in the list. The default is 500. Maximum 2000.
  • offset — Shift of pagination.

orders

A method to get a list of orders.
https://my.onlyproxy.com/api/orders/?api_key=yourapikeyyourapikey

Options:

  • date_after, date_before is the date of purchase, lower and upper bounds. Format 2018-10-25. Includes the specified day.

renew

Proxy renewal. Payment from the account. The POST method.
https://my.onlyproxy.com/api/renew/?api_key=yourapikeyyourapikey

Options:

  • proxies is the proxy ID that needs to be renewed. Multiple values under the same key (proxies=1&proxies=2&proxies=3).
  • period — 5, 10, 20, 30, 60, 90, 120, 150, 180, 210, 240, 270, 300, 330, 360
  • coupon – discount coupon code

new-order

Create a new order. Payment from the account. The POST method.
https://my.onlyproxy.com/api/new-order/?api_key=yourapikeyyourapikey

Options:

  • type – proxy type: dedicated or shared (if IPv6, then only dedicated)
  • ip_version - IP version: 4 or 6
  • country – country code, country code
  • quantity – quantity
  • period — 5, 10, 20, 30, 60, 90, 120, 150, 180, 210, 240, 270, 300, 330, 360
  • coupon – discount coupon code
  • ip_list - The id of the ipsIP you want to order can be obtained in the . You can specify it multiple times.

countries

Get a list of countries with nested cities. Country code and city ID can be used for filtering
https://my.onlyproxy.com/api/countries/?api_key=yourapikeyyourapikey

ips

Get a list of IPs by parameters. IDs are used in order creation and renewal methods.
https://my.onlyproxy.com/api/ips/?api_key=yourapikeyyourapikey&ip_version=4&type=dedicated&country=ru

Options:

type, ip_version, country — required
  • type – proxy type: dedicated or shared (if IPv6, then only dedicated)
  • ip_version - IP version: 4 or 6
  • country – country code, country code
  • city - City ID. Can be obtained in the countries

ips-count

Get the number of IPs by parameters. If the count is greater than 1000, it will be shown as 1000.
https://my.onlyproxy.com/api/ips-count/?api_key=yourapikeyyourapikey&ip_version=4&type=dedicated&country=ru

Options:

Same as in the ips. All parameters are required

new-order-amount

Receiving the order amount before payment. The POST method.
https://my.onlyproxy.com/api/new-order-amount/?api_key=yourapikeyyourapikey
Same as in the new-order.

balance

Receiving the balance on the balance. Regular and partner.
https://my.onlyproxy.com/api/balance/?api_key=yourapikeyyourapikey