# Overview

### Welcome

Welcome to the SpeedProxies documentation.&#x20;

Here you will find everything you need to get started using our proxies.

If there is something you can't find or don't understand, contact us at [**support@speedproxies.net**](mailto:undefined) or [**our discord server**](https://speedproxies.net/discord).

***

### What can I find here?

Our documentation is split up in **three main sections**. The first is **Proxies**, the second **Tools** and third **SpeedProxies API**.

**Proxies**

In the Proxies section, you will find an in-depth technical documentation on each type of proxies we offer. You will also find a guides to help you integrate our proxies with code examples, and suggested 3rd party tools.

* **Residential Proxies**
* **Datacenter Proxies**
* **Static Residential Proxies (ISP)**
* **Mobile Proxies**

**Tools**

* **Adblocking DNS**
* **Proxy Formatter**
* **Proxy Tester**

**Extras**

* **Public API**
* **Reseller API**


# Integration Guides

SpeedProxies proxies are compatible with many browser add-ons, software platforms and tools.

Explore our integration guides and learn how to set up your proxies for your use case.


# FoxyProxy

FoxyProxy is a simple and reliable proxy manager that works on many popular browsers.

Follow these steps to integrate SpeedProxies [**Residential Proxies**](https://speedproxies.net/residential-proxies/):

**Step 1.** Get the extension and install it. ([**Chrome Install**](https://chromewebstore.google.com/detail/foxyproxy/gcknhkkoolaabfmlnjonogaaifnjlfnp)) ([**Firefox Install**](https://addons.mozilla.org/en-GB/firefox/addon/foxyproxy-standard/))

**Step 2.** Open FoxyProxy **Options**.

<figure><img src="/files/d4iCJrt9lEzDeh3dZvbm" alt=""><figcaption></figcaption></figure>

**Step 3.** Click **Add**.

<figure><img src="/files/gGllRLpcamthysOesuzp" alt=""><figcaption></figcaption></figure>

**Step 4.** Give the proxy a name (used to easily differentiate between multiple proxies).

<figure><img src="/files/KSaXHpReNwXW7mL5tgxQ" alt=""><figcaption></figcaption></figure>

**Step 5.** Change the type to HTTP.

{% hint style="warning" %}
If you want to use SOCKS5, please use the correct port as the port for HTTP and SOCKS5 is always different.
{% endhint %}

<figure><img src="/files/aXa4vpOKGHblsOKGG2ph" alt=""><figcaption></figcaption></figure>

**Step 6.** Add your proxy details:

{% hint style="info" %}
Hostname and port will change depending on the proxy product you are using, so please be aware of that.
{% endhint %}

**Hostname:** `budget.speedproxies.net`

**Port:** `11000`

**Username:** *(provided on your dashboard page)*

**Password:** *(provided on your dashboard page)*

<figure><img src="/files/8A02hHhkaxRihk9ZkOLH" alt=""><figcaption><p>(Example of proxy details from budget residential proxies page)</p></figcaption></figure>

**Step 7.** Save your proxy.

<figure><img src="/files/Aw4QvIh7IMVA9m7tcV2S" alt=""><figcaption></figcaption></figure>

**Step 8.** Click on your newly made proxy profile to use it.

<figure><img src="/files/dP1ND2tk7WiIuQVaCcqN" alt=""><figcaption></figcaption></figure>

**Step 9.** Test your new proxy and you are ready to go.

<figure><img src="/files/1idZ7GwR11OjzS72rFyd" alt=""><figcaption><p>(Testing for the IP change <a href="https://whatsmyip.speedshare.workers.dev/"><strong>here</strong></a>)</p></figcaption></figure>


# iOS / iPhone

The following guide has been tested to work on until iOS/iPadOS 17.3.

Currently the use of proxies is limited on iOS for the following reasons:

* no proxy support for mobile data&#x20;
* no SOCKS5 support

If you want to use your [**Residential Proxies**](https://speedproxies.net/residential-proxies/) on your iOS based device on Wi-Fi then follow the guide:

**Step 1.** Navigate to **Settings > Wi-Fi > Current Wi-Fi Network**.

<img src="/files/DcpnCZbLd5YqkEJfLaHa" alt="" data-size="original">![](/files/eEmdWeHTPVEGLMWMEUrQ)

**Step 2.** Select the info icon and scroll down to **HTTP Proxy** and select **Configure Poxy** and **Manual**.

![](/files/Hr1ikOHApicLwvfTXZMh)![](/files/Sp0lAjeS5zNnUEbPwrYX)

**Step 3.** Edit each section by tapping on the label with your **proxy settings**:

{% hint style="info" %}
Hostname and port will change depending on the proxy product you are using, so please be aware of that.
{% endhint %}

**Hostname:** `budget.speedproxies.net`

**Port:** `11000`

**Username:** *(provided on your dashboard page)*

**Password:** *(provided on your dashboard page)*

<figure><img src="/files/8A02hHhkaxRihk9ZkOLH" alt=""><figcaption><p>(Example of proxy details from budget residential proxies page)</p></figcaption></figure>

**Step 4.** Tap **Save**.

&#x20;![](/files/wYsHMIT9YxOb8pCbdHzY)

**Step 5.** Open your web browser and enter the **same username & password** used if asked to **Sign in**.

**Step 6.** Test your proxy to see if your proxy is working correctly.

![](/files/AP1YlEQ4EirEYVf1mzYO)![](/files/frHrMxf2TPBslP1aJhbx)


# Residential Proxies


# Important


# Authentication

Authentication is needed to access any of our proxies.

At the moment we offer the following methods of authentication:

* credentials
* IP address (coming soon)

Different methods will have different advantages and disadvantages:

<table><thead><tr><th width="184">Method</th><th>Advantages</th><th>Disadvantages</th></tr></thead><tbody><tr><td>Credentials</td><td>Dynamic control over proxy settings</td><td>Not compatible with every tool</td></tr><tr><td>IP address</td><td>Compatibility with certain tools</td><td>Proxy settings changes aren't instant</td></tr></tbody></table>


# Response Codes

Here is the list of response codes that you may get when using our residential proxies.

<table><thead><tr><th width="142">Status Code</th><th width="259">Response</th><th>Description</th></tr></thead><tbody><tr><td>402</td><td>Payment Required</td><td>Proxy bandwidth has run out</td></tr><tr><td>407</td><td>Proxy Authentication Required</td><td>Proxy authentication info missing or wrong</td></tr><tr><td>451</td><td>Unavailable For Legal Reasons</td><td>Target host not whitelisted </td></tr><tr><td>451</td><td>Target Email/SMTP Not Available</td><td>Blocked host</td></tr><tr><td>451</td><td>Target Subnets Not Available</td><td>Blocked host</td></tr><tr><td>512</td><td>No Exit Route Found</td><td>We could not find an IP to satisfy your request</td></tr></tbody></table>


# Restricted Targets

Some websites and ports are restricted on our residential proxies to avoid abuse, prevent unethical activities and protect our proxy network.

{% hint style="success" %}
**Some targets can be unlocked** by asking customer support for permission by explaining your use case. (Depending on the use case & target it may require KYC to pass).
{% endhint %}

The list includes but isn't limited to the following target types:

* Government
* Social Networks (e.g., Facebook, LinkedIn)
* Streaming (e.g., Netflix, HBO Max)
* Mailing


# Location Settings

If you want your proxies to be from a specific location, you will have to either add the a **country** or **region** flag so that we can process the request. \
The value of the country/region paratemere is case insensitive but it follows the 2 letter country code using the [**ISO 3166 Alpha 2**](https://www.iban.com/country-codes) format.

Full Region List: <https://speedproxies.net/docs/regions.json>

Full Country List: <https://speedproxies.net/docs/countries.json>

Here are a few examples of using a country or region parameters:

`country-US`

`region-EU`

***

**Code Example**

{% tabs %}
{% tab title="cURL" %}

```bash
curl -x budget.speedproxies.net:11000 -U "USERNAME:PASSWORD_country-us" https://whatsmyip.speedshare.workers.dev/
```

{% endtab %}

{% tab title="Go" %}

<pre class="language-go"><code class="lang-go">package main

import (
	"fmt"
	"io/ioutil"
	"net/http"
	"net/url"
)

<strong>func main() {
</strong>	proxyURL, _ := url.Parse("http://USERNAME:PASSWORD_country-us@budget.speedproxies.net:11000")
	proxyClient := &#x26;http.Client{
		Transport: &#x26;http.Transport{
			DialContext: (&#x26;net.Dialer{
				KeepAlive: time.Duration(-1),
			}).DialContext,
			DisableKeepAlives: true,
			Proxy:             http.ProxyURL(proxyURL),
		},
	}

	resp, err := proxyClient.Get("https://whatsmyip.speedshare.workers.dev/")
	if err != nil {
		fmt.Println("Error:", err)
		return
	}
	
	defer resp.Body.Close()

	if body, err := io.ReadAll(resp.Body); err == nil {
		fmt.Println(string(body))
	} else {
		fmt.Println("Error:", err)
	}
}
</code></pre>

{% endtab %}

{% tab title="Python" %}

```python
import urllib.request
import random
username = 'USERNAME'
password = 'PASSWORD_country-us'
entry = ('http://customer-%s:%s@budget.speedproxies.net:11000' %
    (username, password))
query = urllib.request.ProxyHandler({
    'http': entry,
    'https': entry,
})
execute = urllib.request.build_opener(query)
print(execute.open('https://whatsmyip.speedshare.workers.dev/').read())
```

{% endtab %}
{% endtabs %}


# Other Settings

There are many other settings available for our residential proxies. Here we will explain how they work and how to add them:

{% tabs %}
{% tab title="Standard Residential" %}

| Feature                   | Description                                                                                                                                 | Possible Issues?                                           |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| Stable & Latency Priority | Allows you to prioritise stable & low latency IPs when using your residential proxies                                                       | Will lower your IP pool for the country/region selected    |
| Adblocker                 | Disables most known ad networks and trackers from being able to track your sessions, improving your privacy and saving your proxy bandwidth | You can't view ads on most sites                           |
| No Static IP Priority     | Prioritise the proxy to not use static or CGNAT IPs                                                                                         | Will lower your IP pool for the country/region selected    |
| Sticky IP                 | Proxy will try to keep the same IP for the set time                                                                                         | Small chance of IP rotating (if the IP  peer goes offline) |

**Adblocker:**

Add `_dns` to the proxy password after the selected country/region.

**Stable & Latency Priority:**

Add `_stream` to the proxy password after the selected country/region.

**No Static IP Priority:**

Add `_skipstatic` to the proxy password after the selected country/region.

**Sticky IP:**

Add `_session-ID-TIME` to the proxy password after the selected country/region (replace ID with a value between 1-10000, replace TIME (seconds) with a value between 5-3600).
{% endtab %}

{% tab title="Budget Residential" %}

<table><thead><tr><th width="168">Feature</th><th width="349">Description</th><th>Possible Issues?</th></tr></thead><tbody><tr><td>Adblocker</td><td>Disables most known ad networks and trackers from being able to track your sessions, improving your privacy and saving your proxy bandwidth</td><td>You can't view ads on most sites</td></tr><tr><td>Latency Priority</td><td>Allows you to prioritise low latency IPs when using your residential proxies</td><td>Will lower the IP Pool available for the country/region selected</td></tr><tr><td>Stable Priority</td><td>Allows you to prioritise stable connections that have minimum fluctuation in latency</td><td>None</td></tr><tr><td>Forced Rotation</td><td>Forcefully changes the IP of the proxy after a set timer without disconnecting. (useful in browser environments that don't disconnect from the proxy even when trying to switch manually)</td><td>None</td></tr></tbody></table>

**Adblocker:**

Add `_dns` to the proxy password after the selected country/region.

**Latency Priority:**

Add `_latency` to the proxy password after the selected country/region.

**Stable Priority:**

Add `_stable` to the proxy password after the selected country/region.

**Forced Rotation:**

Add `_rotate-NUMBER` to the proxy password after the selected country/region (replace NUMBER with how many seconds you want, allowed values: 5-120).
{% endtab %}
{% endtabs %}


# Datacenter Proxies


# Authentication

Authentication is needed to access any of our proxies.

At the moment we offer the following methods of authentication:

* credentials
* IP address (coming soon)

Different methods will have different advantages and disadvantages:

<table><thead><tr><th width="184">Method</th><th>Advantages</th><th>Disadvantages</th></tr></thead><tbody><tr><td>Credentials</td><td>Dynamic control over proxy settings</td><td>Not compatible with every tool</td></tr><tr><td>IP address</td><td>Compatibility with certain tools</td><td>Proxy settings changes aren't instant</td></tr></tbody></table>


# Static ISP Proxies


# Authentication

Authentication is needed to access any of our proxies.

At the moment we offer the following methods of authentication:

* credentials
* IP address (coming soon)

Different methods will have different advantages and disadvantages:

<table><thead><tr><th width="184">Method</th><th>Advantages</th><th>Disadvantages</th></tr></thead><tbody><tr><td>Credentials</td><td>Dynamic control over proxy settings</td><td>Not compatible with every tool</td></tr><tr><td>IP address</td><td>Compatibility with certain tools</td><td>Proxy settings changes aren't instant</td></tr></tbody></table>


# Mobile Proxies


# Authentication

Authentication is needed to access any of our proxies.

At the moment we offer the following methods of authentication:

* credentials
* IP address (coming soon)

Different methods will have different advantages and disadvantages:

<table><thead><tr><th width="184">Method</th><th>Advantages</th><th>Disadvantages</th></tr></thead><tbody><tr><td>Credentials</td><td>Dynamic control over proxy settings</td><td>Not compatible with every tool</td></tr><tr><td>IP address</td><td>Compatibility with certain tools</td><td>Proxy settings changes aren't instant</td></tr></tbody></table>


# Adblocking DNS

We currently offer the use of an adblocking DNS on our residential proxies for the following reasons:

* **Improved Performance:** Advertisements can slow down the loading of web pages. By using an adblocker during web scraping, you can eliminate the extra content and scripts associated with ads, resulting in faster page loading times and more efficient scraping.
* **Reduced Noise in Data:** Ads can introduce additional elements and noise into the HTML structure of a webpage. If you are scraping data from a website, removing ads helps streamline the extraction process, ensuring that you focus on the relevant content and avoid unnecessary distractions.
* **Minimized Disturbances:** Ads often pop up or overlay content, which can interfere with the scraping process. By blocking ads, you reduce the likelihood of encountering disruptive elements that might hinder the proper functioning of your web scraping script.
* **Bandwidth/Data Usage:** Advertisements contribute to your overall bandwidth usage when loading a webpage. By blocking ads, you can reduce the amount of data used during the scraping process, which can be beneficial if you are concerned about bandwidth usage and save money.

Currently we only offer the Adblocking DNS feature on our residential proxies and can't customise the filters, but you can toggle the Adblocking feature on (default) or off.


# Proxy Formatter

This [free tool](https://speedproxies.net/proxy-formatter/) will allow you to change the format of your proxy, so that you can use your proxies in your required tool, these are the formats supported:

* username:password:ip:port
* username:password\@ip:port
* ip:port:username:password
* ip:port\@username:password
* ip:port

{% embed url="<https://speedproxies.net/proxy-formatter/>" %}
Proxy Formatter Tool
{% endembed %}


# Proxy Tester

Our proxy tester is free to be used by anybody, to use it you need to do the following:

**Step 1:** Input your proxy list

**Step 2:** Choose the correct proxy format & type

**Step 3:** Choose the location to test from

**Step 4:** Run the tester and view the results


# Public API


# Reseller API


