# Welcome

Welcome to the DataImpulse documentation.

Here, you’ll find everything you need to get started with our proxies.

If you need assistance or can’t find what you’re looking for, don’t hesitate to contact us at <support@dataimpulse.com> or through our 24/7 live chat on the [website.](https://dataimpulse.com/)

**Getting Started with DataImpulse**

This video will guide you to everything you need about using DataImpulse.

{% embed url="<https://www.youtube.com/watch?t=2s&v=8P52Sbh7RB8>" %}

For more details, check out our comprehensive blog post  [Step-by-Step Guide to Getting Started with DataImpulse](https://dataimpulse.com/blog/step-by-step-guide-to-getting-started-with-dataimpulse/).

### Jump right in

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Auto-recharge</strong> </td><td>Don't worry about balance</td><td></td><td></td><td><a href="/billing/auto-recharge">Auto-recharge</a></td></tr><tr><td><strong>Parameteres</strong></td><td>Examples of requests</td><td></td><td></td><td><a href="/proxies/parameters">Parameters</a></td></tr><tr><td><strong>Whitelist Ips</strong></td><td>Make requests without login and password<br></td><td></td><td></td><td><a href="/authentication-methods/whitelist-ips">Whitelist IPs</a></td></tr></tbody></table>


# Proxies

Complete DataImpulse proxy documentation. Explore proxy types, connection methods, and best practices for residential, mobile, and datacenter IP configurations.

We provide:

* [Residential Proxies](https://dataimpulse.com/residential-proxies/)
* [Mobile Proxies](https://dataimpulse.com/mobile-proxies/)
* [Datacenter Proxies](https://dataimpulse.com/datacenter-proxies/)
* [Premium Residential Proxies](https://dataimpulse.com/premium-residential-proxies/)


# Types of connections

We offer two types of proxy connections: Rotating and Sticky.

### Rotating

The IP address changes automatically with each new request.

You should use:

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td>For HTTP/HTTPS</td><td><strong>823</strong> PORT</td><td></td><td></td></tr><tr><td>For SOCKS5</td><td><strong>824</strong> PORT</td><td></td><td></td></tr></tbody></table>

<figure><img src="https://2032935727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2PNbkVMJTPjkWGv2Kbvj%2Fuploads%2FxaFpg37IOci7ozuGfNj5%2FGoogle%20Chrome%202024-11-06%20%D0%B2%2009.46.33.png?alt=media&amp;token=34a3a197-8c87-475c-8452-14e3653cdf61" alt=""><figcaption></figcaption></figure>

***

### **Sticky**

Sticky proxies are port-based. IP addresses are bound to a specific port for a period of time.&#x20;

The rotation interval for sticky proxies can range from 1 to 120 minutes, with the average duration being 30 minutes.

For sticky connections, you can use ports from **10000** to **20000**.

An example of the HTTP sticky proxy:

```
curl -x "http://login:password@gw.dataimpulse.com:10000" https://api.ipify.org/
```

An example of the SOCKS5 sticky proxy:

```
curl -x "socks5://login:password@gw.dataimpulse.com:10000" https://api.ipify.org/
```

{% hint style="info" %}
If no Rotation Interval is specified for a Sticky connection or is set to "0", the default interval will be 30 minutes.
{% endhint %}

***

<figure><img src="https://2032935727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2PNbkVMJTPjkWGv2Kbvj%2Fuploads%2FmF8SUohvv3OVtohiCfiv%2FGoogle%20Chrome%202024-11-06%20%D0%B2%2009.36.29.png?alt=media&amp;token=c0d5f2c6-8f79-4634-9e85-79fc17f98e19" alt=""><figcaption></figcaption></figure>

Blog article on selecting the best proxy type:

[Rotating or Sticky Proxies: How to Choose the Right Option](https://dataimpulse.com/blog/rotating-or-sticky-proxies-how-to-make-the-right-choice/)

<br>


# Protocols

The proxies support HTTP, HTTPS, and SOCKS5 protocols.

### HTTP/ HTTPS

An example of the HTTP rotating proxy:

```
curl -x "http://login:password@gw.dataimpulse.com:823" https://api.ipify.org/
```

An example of the HTTP sticky proxy:

```
curl -x "http://login:password@gw.dataimpulse.com:10000" https://api.ipify.org/
```

{% hint style="info" %}
For sticky connections, you can use ports from 10000 to 20000
{% endhint %}

### SOCKS5

An example of the SOCKS5 rotating proxy:

```
curl -x "socks5://login:password@gw.dataimpulse.com:824" https://api.ipify.org/
```

An example of the SOCKS5 sticky proxy:

```
curl -x "socks5://login:password@gw.dataimpulse.com:10000" https://api.ipify.org/
```

Blog article on choosing the best proxy protocol:

[Choosing Between HTTP and SOCKS Proxies: How to Make the Right Decision](https://dataimpulse.com/blog/choosing-between-http-and-socks-proxies-how-to-make-the-right-decision/)


# Connection Hosts

To connect proxies, you have two options for hostnames:

### DNS Hostname

`gw.dataimpulse.com` - Using the DNS hostname for connection, the host closest to you will automatically execute your requests.&#x20;

### IP Hostname

You can also connect using the IP address - `74.81.81.81` . In this case, your connection will be automatically routed through the best available server based on your selected country.

{% hint style="info" %}
We recommend using the DNS format for better stability, as IP addresses can change, requiring you to monitor and update them regularly.
{% endhint %}

<figure><img src="https://2032935727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2PNbkVMJTPjkWGv2Kbvj%2Fuploads%2Fi94ZjY8wS6SKhG0FPSWv%2Fimage-2.webp?alt=media&amp;token=51794e05-2fa7-41b6-a159-edaa4b08cbf9" alt="IP Hostname - DataImpulse Dashboard"><figcaption></figcaption></figure>


# Targeting

Master DataImpulse proxy targeting options. Configure country, city, ASN, session type, and more parameters to target the exact location you need.

We offer two types of targeting options for DataImpulse’s proxy network:

1. [**Default Targeting**: ](/proxies/targeting/default-targeting)\
   This includes country selection/exclusion and ASN exclusion. These options are already included in the base proxy price and are not billed additionally.
2. [**Target Filters**: ](/proxies/targeting/target-filters)\
   This advanced targeting option includes selection by state, city, ZIP code, and ASN. \
   Traffic routed through these filters is billed at double the standard rate.

{% hint style="info" %}
Traffic routed through the Target Filter (state, city, ZIP code, and ASN) is billed at double the standard rate.
{% endhint %}

<table data-column-title-hidden data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Default Targeting</strong></td><td>Country (select/exclude)</td><td>exclude ASN</td></tr><tr><td><strong>Target Filters</strong></td><td>State<br>City<br>ZIP<br>ASN</td><td></td></tr></tbody></table>

If no IPs are currently available for a specific city/state/ZIP/ASN, you will receive a `400 NO_RAY` response code. Please try another city/state/ZIP/ASN in such cases.


# Default Targeting

Understand DataImpulse default proxy targeting behavior. Learn what location and parameters are used when no specific targeting is set in your proxy request.

This targeting includes Country selection/exclusion and ASN exclusion.&#x20;

{% hint style="info" %}
Default Targeting is already included in the base proxy price and is not billed additionally.
{% endhint %}

<figure><img src="https://2032935727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2PNbkVMJTPjkWGv2Kbvj%2Fuploads%2Fwcq7hed6vDHYFaLU36DS%2FGoogle%20Chrome%202024-11-06%20%D0%B2%2010.27.13.png?alt=media&amp;token=a576f4a1-7b55-4255-a693-4552bc8f49a1" alt=""><figcaption></figcaption></figure>

If you set parameters through the Dashboard, please click the **`Save Configuration`** button. The selected parameters will not be applied if you don’t click this button.

If you want to set the parameters manually in the code,  you need to use special parameters after the username:

* `__cr` — used to **select the country** from which the request should be sent.
* `__noasn` — used to **exclude specific ASN** .

**For example:**

If you want to select **Germany** as the country, your code would look like this:

```bash
curl -x "http://login__cr.de:password@gw.dataimpulse.com:823" https://api.ipify.org/
```


# Target Filters

Configure advanced target filters for DataImpulse proxies. Refine your proxy selection by country, city, ASN, and more for precise geo-targeting results.

This advanced targeting option includes State, City, ZIP code, and ASN selection.&#x20;

* [State](/proxies/parameters/state)
* [City](/proxies/parameters/city)
* [ZIP](/proxies/parameters/zip)
* [ASN](/proxies/parameters/asn)

{% hint style="info" %}
Traffic routed through these filters is billed at double the standard rate.
{% endhint %}

<figure><img src="https://2032935727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2PNbkVMJTPjkWGv2Kbvj%2Fuploads%2F1NdncAbySvQuppWl3Kda%2FGoogle%20Chrome%202024-11-06%20%D0%B2%2011.42.45.png?alt=media&amp;token=9883c991-f36e-456f-bd28-8c7c53987185" alt=""><figcaption></figcaption></figure>


# Parameters

Full reference of DataImpulse proxy parameters. Learn how to configure country, session, anonymity, ASN exclusion, and other targeting options via URL.

Parameters can be set either through the Dashboard or manually.

1. **Setting in the Dashboard**: Go to the "Proxy Configuration" section on the plan page to specify the desired parameters for your requests.
2. **Manual Configuration**: You can add parameters directly after your login information using the delimiter “\_\_”. \
   Each key and its values should be separated by a dot, and a semicolon should separate different parameters.

The format should look like this: `key1.value1,value2;key2.value1,value2`.

**For example:**

If you want to select **Germany** as the country, your code would look like this:

```bash
curl -x "http://login__cr.de:password@gw.dataimpulse.com:823" https://api.ipify.org/
```

If you want to select **two countries**, such as Germany and Australia, use the following code:

```bash
curl -x "http://login__cr.de,au:password@gw.dataimpulse.com:823" https://api.ipify.org/
```


# Country

Use the country parameter with DataImpulse proxies to target a specific country. Full documentation on country codes, usage examples, and targeting behavior.

`cr` - Specify the country from which the request should be sent.<br>

**For example:**

If you want to select **Germany** as the country, your code would look like this:

```bash
curl -x "http://login__cr.de:password@gw.dataimpulse.com:823" https://api.ipify.org/
```

If you want to select **two countries**, such as Germany and Australia, use the following code:

```bash
curl -x "http://login__cr.de,au:password@gw.dataimpulse.com:823" https://api.ipify.org/
```


# Exclude Country

Learn how to use the exclude-country parameter in DataImpulse proxies to filter out specific countries from your proxy pool for more targeted IP selection.

`nocr` - exclude specific countries from your proxy configurations when "All Countries" is selected.

If you want to exclude **Germany** as the country, your code would look like this:

<pre><code><strong>curl -x "http://login__nocr.de:password@gw.dataimpulse.com:823" https://api.ipify.org/
</strong></code></pre>


# Exclude ASN

Learn how to use the exclude-ASN parameter in DataImpulse proxies. Filter out specific autonomous systems from your proxy pool for better IP quality control.

`noasn` - Exclude the ASN proxy IPs from the response.<br>

**For example:**

If you want to exclude `AS20947`, your code would look like this:

```bash
curl -x "http://login__noasn.20947:password@gw.dataimpulse.com:823" https://api.ipify.org/
```


# State

Traffic routed through this parameter is billed at double the standard rate

To specify a proxy from a particular US state, including the `state` in the authorization string. For example, `__cr.us;state.arizona`.

Click [here](https://docs.google.com/spreadsheets/d/17vybtGjgb83uGLTFzuXIYEvuP0_LD95wwPAQCRScERg) for a full list of US states.

**Code example**

In this example, a query to gw\.dataimpulse.com is performed from an IP address from Arizona, USA:

```
curl -x "http://login__cr.us;state.arizona:password@gw.dataimpulse.com:823" https://api.ipify.org/
```

{% hint style="info" %}
It's important to note that selecting a country is mandatory to specify city, state, ZIP code, and ASN targeting.
{% endhint %}

***

You can now exclude specific states using the `nostate` parameter.

**Example:** To target the USA but exclude California, use:

`cr.us;nostate.california`

{% hint style="info" %}
Traffic routed through the `nostate` parameter, as well as `state` parameter is billed at double the standard rate.
{% endhint %}


# ASN

Traffic routed through this parameter is billed at double the standard rate

\
Our proxies support targeting by ASN number, meaning you can choose proxies from specific carriers. You have to enter the required `asn` parameter in your request, combined with the `cr` country code parameter.

Below is the example for Play, its ASN number in Poland being 39603:

`cr.pl;asn.39603`

```
curl -x "http://login__cr.pl;asn.39603:password@gw.dataimpulse.com:823" https://api.ipify.org/
```

{% hint style="info" %}
It's important to note that selecting a country is mandatory to specify city, state, ZIP code, and ASN targeting.
{% endhint %}


# ZIP

Traffic routed through this parameter is billed at double the standard rate

To connect to a proxy using a ZIP code, add and specify the `zip` parameter with a five-digit ZIP code in the username, combined with the `cr` country code parameter.

Here are a few examples of valid combinations of country and zip parameters:

`cr.us;zip.85032`

`cr.fr;zip.75001`

**Code example**

In this example, a query to gw\.dataimpulse.com is performed from an IP address from New York, USA:

```
curl -x "http://login__cr.us;zip.10001:password@gw.dataimpulse.com:823" https://api.ipify.org/
```

{% hint style="info" %}
It's important to note that selecting a country is mandatory to specify city, state, ZIP code, and ASN targeting.
{% endhint %}

***

You can now exclude specific ZIP codes using the `nozip` parameter.

**Example:** To target Germany but exclude ZIP code 10115, use:

`cr.de;nozip.10115`

{% hint style="info" %}
Traffic routed through the `nozip` parameter, as well as `zip` parameter is billed at double the standard rate.
{% endhint %}


# City

Traffic routed through this parameter is billed at double the standard rate

Add a `city` parameter to narrow down to city-level targeting.&#x20;

For example, `cr.es;city.madrid,barcelona` means that a proxy from Madrid, Barcelona, and Spain will handle the query.&#x20;

Here are a few examples of valid combinations of country and city parameters:

`cr.de;city.berlin`

`cr.br;city.salvador`

**Code example**

In this example, a query to gw\.dataimpulse.com is performed from an IP address from Berlin, Germany:

```
curl -x "http://login__cr.de;city.berlin:password@gw.dataimpulse.com:823" https://api.ipify.org/
```

We cannot guarantee the availability of proxies from a specific city at any given time. However, most popular cities are well covered.

{% hint style="info" %}
It's important to note that selecting a country is mandatory to specify city, state, ZIP code, and ASN targeting.
{% endhint %}

***

You can now exclude specific cities using the `nocity` parameter.

**Example:** To target Germany but exclude Berlin, use:

`cr.de;nocity.berlin`

{% hint style="info" %}
Traffic routed through the `nocity` parameter, as well as `city` parameter is billed at double the standard rate.
{% endhint %}


# Anonymous

Learn how to use the anonymous parameter with DataImpulse proxies to request high-anonymity IPs that hide proxy usage from target servers. Full guide inside.

`anon` - Use this parameter only for anonymous proxies.\
After enabling this option, you will exclusively receive more anonymous proxies from our pool.

{% hint style="info" %}
&#x20;Please be aware that this option may reduce pool size compared to the standard configuration.
{% endhint %}

**Code example:**

```
curl -x "http://login__anon.1:password@gw.dataimpulse.com:823" https://api.ipify.org/
```


# Session Id

Learn how to use the session-id parameter with DataImpulse proxies to maintain sticky sessions and keep the same IP across multiple consecutive requests.

`sessid` - Connect to a specific IP address for 30 minutes. The value for `sessid`can be any string or number.

It's not a replacement for Sticky proxies, but rather an alternative when you want to connect to a specific IP address for an average of 30 minutes.

{% hint style="info" %}
Real people provide residential IPs, and if the IP provider you are using goes offline, your IP will be automatically replaced with another available one.
{% endhint %}

**Example:**

```
curl -x "http://login__cr.au;sessid.123:password@gw.dataimpulse.com:823" https://api.ipify.org/
```

Using `__cr.au;sessid.123` signifies that the client wants to connect to an IP address labeled as 123 in Australia (e.g., IP 154.6.151.212).

```
curl -x "http://login__cr.au;sessid.45:password@gw.dataimpulse.com:823" https://api.ipify.org/
```

Similarly, `cr.au;sessid.45` indicates the client's request for an IP address labeled as 45 in Australia (e.g., IP 38.55.106.76).

When you connect to the proxy via `__cr.au;sessid.123` you will consistently be assigned the IP address 154.6.151.212 for the entire 30-minute duration.  Likewise, connecting with `__cr.au;sessid.45` will result in the IP address 38.55.106.76 being assigned.

{% hint style="info" %}
Ensure that the port is specified in the settings as 824 for Socks5 or 823 for HTTPS.
{% endhint %}

<br>


# Session Interval

Understand the session-interval parameter in DataImpulse proxies. Control how frequently your IP rotates to balance anonymity and session continuity.

`sessttl` - Set the interval for IP rotation for sticky proxies, specifying the value in minutes.<br>

The Sticky Proxy configuration allows you to control the frequency of IP address rotation. You can set the interval for IP rotation by adding the `sessttl` parameter after the login, specifying the value in minutes.

\
**For example**, if you want the IP address to change every minute, you can use the following format: `sessttl.1`

If you want the IP address to change every hour, the value would be `sessttl.60`

{% hint style="info" %}
If the selected IP address becomes unavailable, the system will automatically replace it with another active IP address.
{% endhint %}

You can also specify both the country and the IP rotation frequency by adding parameters after the login.

**For example**, if you want to use an IP address from France with a rotation frequency of every hour, you can use the following format: `cr.fr;sessttl.60`

```
curl -x "http://login__cr.fr;sessttl.60:password@gw.dataimpulse.com:10000" https://api.ipify.org/
```

\
In this example, "cr.fr" represents France, and "sessttl.60" indicates a rotation frequency of 60 minutes.

<br>


# Threads

Learn how concurrent threads work with DataImpulse proxies. Understand thread limits, parallel connections, and how to optimize throughput for your use case.

Each plan has a limit of 2000 threads. A thread represents an active connection to a proxy. If the maximum number of simultaneous connections is reached, the service will return an error `407 THREADS_EXHAUSTED` .

If you need to increase this limit, please contact our Support team.

{% hint style="info" %}
For security purposes, users need to complete KYC verification before their increasing request is approved.
{% endhint %}


# UDP

Learn about UDP proxy support in DataImpulse. Understand use cases, configuration options, and limitations of UDP protocol for proxy connections.

We support UDP connections; it is disabled by default for all users.

To enable it, you need to:

* &#x20;Provide a detailed description of your use case.&#x20;
* &#x20;Include company information (if applicable).
* &#x20;Complete KYC verification.

Each request is reviewed individually to ensure compliance and prevent misuse.

{% hint style="info" %}
Requests without completed KYC will not be considered.
{% endhint %}


# Authentication methods

Explore all DataImpulse proxy authentication methods: username/password and IP whitelisting. Choose the right method for your use case and setup.

We support proxy authentication via:

* [ Username and password](/authentication-methods/user-pass-authentication)
* &#x20;[IP-based whitelisting](/authentication-methods/whitelist-ips)


# User:pass authentication

Learn how to use username and password authentication with DataImpulse proxies. Generate credentials and connect in seconds from any device or app.

After you purchase a plan, a proxy login and password will be automatically generated in the **Proxy Access** section.

<figure><img src="https://2032935727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2PNbkVMJTPjkWGv2Kbvj%2Fuploads%2FXNx4QabVhisEuJBG2g1e%2FGoogle%20Chrome%202024-11-06%20%D0%B2%2012.41.43.png?alt=media&amp;token=8d4906f6-ac73-45f5-a52b-7da9a5ef9352" alt=""><figcaption></figcaption></figure>

You have the option to reset the password by clicking on the refresh icon


# Whitelist IPs

Set up IP whitelisting for DataImpulse proxy authentication. Allow specific IPs to connect without credentials for seamless and secure proxy access.

The Whitelist IPs feature allows users to add and manage IP addresses to access our proxies easily without using the login and password upon each additional request.&#x20;

{% hint style="info" %}
The same IP address cannot be added to multiple plans at the same time.&#x20;
{% endhint %}

<figure><img src="https://2032935727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2PNbkVMJTPjkWGv2Kbvj%2Fuploads%2FlpkwTM6ushpg0jrHQHnE%2Fimage.webp?alt=media&amp;token=45476fd8-436b-4b70-9018-004ad0457f16" alt="Whitelist IPs - DataImpulse Dashboard"><figcaption></figcaption></figure>


# Port access

Learn about DataImpulse proxy port access configuration. Understand which ports are available and how to connect using HTTP, HTTPS, and SOCKS5 protocols.

### Default access

With the proxies, the following ports are accessible by default:

* `80`
* `443`
* `5228`
* `53`
* `5060`
* `8080`
* `8090`
* `8443`
* `853`
* `8888`

#### Restricted ports

Restricted ports include SMTP, IMAP, and various other ports related to mailing and messaging.

***

### Procedure for Unblocking a Port

To request a port unblock, please contact us at <support@dataimpulse.com> and provide the following information:

* Specify the port that needs to be opened.
* Clearly describe the use case for this port—provide as many details as possible.
* Include the specific target you intend to access through this port.

For security purposes, users may need to complete KYC verification before their unblocking request is approved.


# Blocked Websites

DataImpulse blocked websites list: domains inaccessible via proxy servers to maintain network security, stability, and abuse prevention.

As of December 2023, we are blocking certain websites to ensure the safety of our proxies. Some of these can be unblocked once you complete identity verification and, in some cases, reach a certain spending level. See the requirements below.

### Currently blocked websites

* All government websites&#x20;
* Banking and payment websites (refer to the complete list of blocked websites [here](https://docs.google.com/spreadsheets/d/18RwU3srsbO2PzQxrPxjN2cVLkrV6ZKrdRERlz3k2MKU/edit?usp=sharing))
* Ticketswap service
* HealthEquity
* SopranoVillas
* Traffic Monetization Platforms (GetGrass, NodePay, Gradient, etc.)
* VFS global <https://visa.vfsglobal.com/>
* mspapis.com
* Greenshades.com, GreenEmployee.com, GreenshadesOnline.com, Downloadmyform.com
* DDS hosting
* 4chan.org
* openstreetmap.org, osm.org
* Moviestarplanet
* rolimons.com
* fool.com
* torbox.app
* happyrail.com
* treinreiswinkel.nl

### How unblocking works

We review unblocking requests based on your verification status and spending level. The more trust your account builds, the more we can open.

#### Step 1: Identity verification

Once you confirm your identity on DataImpulse, we can consider unblocking specific **.gov** domains on request.&#x20;

Each domain is reviewed individually, so you'll need to submit the exact domains you need to our support team.

#### Step 2: Identity verification + $100 spent

After confirming your identity and spending over $100, we can open all **.gov** websites at once. You will no longer need to request individual domains each time.

#### Step 3: Identity verification + $1,000 spent

After confirming your identity and spending over $1,000, we can consider unblocking **banking and payment websites.**

{% hint style="info" %}
Banking and payment websites are opened for business use cases only. We do not unblock them for personal use.
{% endhint %}

### Corporate accounts

If you represent a company, we may consider unblocking websites upon identity verification alone, with no minimum spending required. Corporate requests receive a higher level of trust during our review process.

### How to request an unblock

To request a website unblock, contact us at <support@dataimpulse.com> and include:

* The exact website you need opened.
* A clear description of your use case, with as many details as possible.

{% hint style="info" %}
For security purposes, all users must complete KYC verification before an unblocking request can be approved.
{% endhint %}


# Errors

Troubleshoot DataImpulse proxy errors with our comprehensive error code reference. Understand what each error means and how to resolve connection issues fast.

When using HTTP Proxy, errors are shown in the response of the proxy server after using the service. When using SOCKS5, errors are shown by status codes when creating a connection and authenticating. All the errors can be checked on the account dashboard.

**The list of HTTP errors:**

`400 Bad Request` - CONNECT request to the proxy server was created incorrectly.\
`403 PORT_BLOCKED` - The connection attempt is made to the blocked ports.\
`403 SITE_PERMANENTLY_BLOCKED` - The access to the specified site has been permanently blocked.\
`403 HOST_BLOCKED` - The access to the specified site has been blocked by user in the current plan settings.\
`407 NO_USER` - The user’s plan doesn’t exist.\
`407 TRAFFIC_EXHAUSTED` - The traffic limit of the plan is exceeded.\
`407 THREADS_EXHAUSTED` - The threads limit of the plan is exceeded.\
`407 PORT_NOT_ALLOWED` - Used sticky sessions port is not allowed by current plan settings.\
`407 USER_BLOCKED` - The user’s current plan has been blocked.\
`500 INTERNAL_SERVER_ERROR` - The server encountered an unexpected condition that prevented it from fulfilling the request.\
`502 NO_HOST_CONNECTION` - There is no connection to the host specified in the CONNECT request.\
`503 NO_RAY` - There are no proxies available based on the targeting parameters specified in the request.\ <br>

**The list of SOCKS5 errors:**

For such errors as `NO_USER`, `REQUESTS_EXHAUSTED`, `TRAFFIC_EXHAUSTED`, `THREADS_EXHAUSTED` an unsuccessful authentication response will be returned with the Denied status when there was an attempt to connect to a proxy server\
\
For such errors as `PORT_BLOCKED`, `NO_RAY`, `NO_HOST_CONNECTION` authentication will be passed, after which, the proxy connection will be reset I there is an attempt of the UDP connection, the connection will be dropped.&#x20;

`UDP_BIND_FAILED` – Failed to bind a local UDP port, preventing the UDP connection from being established. This error is similar to `502 NO_HOST_CONNECTION`, but occurs when using the UDP protocol.

More details relevant to the errors can be found on our blog: [Proxy Errors: Types, Causes, and Solutions](https://dataimpulse.com/blog/proxy-errors-types-causes-and-solutions/)


# Resellers

DataImpulse reseller program documentation. Learn how to set up a white-label proxy business, manage sub-users, and configure your reseller account.

To become a DataImpulse reseller, simply create an account in our [Dashboard](https://app.dataimpulse.com/).&#x20;

Fill out the Know Your Customer (KYC) form through our secure partner iDenfy to verify your identity and ensure compliance with our platform’s policies. After that, sign the Reseller Agreement to activate your reseller status.

After your account is set up, go to the Resellers section to make a deposit of at least $50 to activate your reseller status.

The Reseller API is available [here](https://documenter.getpostman.com/view/6095389/2s9YC7UC2x). If you need specific endpoints that have yet to be implemented, please contact our Support Team for assistance.


# Custom DNS host

Set a custom DNS host for your DataImpulse reseller business. Learn how to configure a branded proxy endpoint for your white-label proxy service customers.

You can configure your own domain instead if you wish to resell our proxies while keeping DataImpulse’s host invisible.&#x20;

For detailed instructions on how to set up a custom DNS host, please click [here](https://dataimpulse.com/tutorials/how-to-set-up-proxies-in-reselling-dataimpulse/).&#x20;


# Manage SSL Certificates

Learn how to manage SSL certificates for your DataImpulse reseller domain. Secure your white-label proxy endpoints with custom HTTPS certificate configuration.

Use this feature to manage SSL certificates for your custom domains. By uploading your public and private keys, you can ensure secure HTTPS connections for your users and resolve any certificate-related errors.&#x20;

Simply add your domain, upload the necessary keys, and click "Add".&#x20;

Your certificate will be activated within 5 minutes.


# Deposit Calculation Update

Understand the DataImpulse reseller deposit calculation update. Learn how deposits are computed for your sub-users and how billing works for resellers.

We've introduced a coefficient-based system for accurately managing deposits across different proxy pools.&#x20;

Previously, deposit calculations were only applied to the residential pool. With the addition of Mobile and Datacenter pools, the following coefficients are now in place:

Residential: x1

Datacenter: x0.5

Mobile: x2

Premium Residential: x5

**Deposit Process**

The deposit process remains unchanged:

A $50 deposit provides 50 GB of traffic.

Custom pricing continues to function as previously defined.

**Sub-User Allocation**

When resellers allocate traffic to their sub-users, the balance is deducted based on the following logic:

***Residential Pool:***

Request: 10 GB

Deduction: $10 GB from reseller balance

***Datacenter Pool:***

Request: 10 GB

Deduction: $5 GB from reseller balance

***Mobile Pool:***

Request: 10 GB

Deduction: $20 GB from reseller balance

***Residential Premium Pool:***

Request: 10 GB

Deduction: $50 GB from reseller balance

<br>


# Target Filters for sub-users

Configure proxy targeting filters for sub-users in your DataImpulse reseller account. Control which countries and parameters each sub-user can access.

For resellers and their sub-users, location selection is available at the country, state, city, ASN, or ZIP level.&#x20;

State, city, ASN, or ZIP can only be configured when a country is specified.&#x20;

{% hint style="info" %}
Connections using State, city, ASN, or ZIP parameters are billed at double the standard rate.
{% endhint %}

{% hint style="info" %}
**Premium Residential Pool**: No additional charges. Target filters are included in the base price.
{% endhint %}


# Affiliate Program

Learn how the DataImpulse affiliate program works. Earn commissions by referring customers. Find out about payouts, tracking, and how to get started.

We offer a referral program to all clients, accessible through the affiliate page. When someone registers using your referral link, you earn 15% of their order. You can withdraw your referral earnings in  Bitcoin, USDT TRC20, or Wire Transfer once you reach $100, or convert them into your Plan / Reseller balance.

Referral earnings are held for 30 days for verification before being paid out within 48 hours of a withdrawal request. Refunded orders are deducted from generated sales. If a referral earning has been received for an order that is later refunded, the amount will be subtracted from the following payout.

We reserve the right to decline payout if our system detects fraudulent activity.

**Active balance:** The amount of referral earnings that are available for payout.

**Holded balance:** Referral earnings that are temporarily held for 30 days for verification.

**Total payout sum:** The cumulative sum of all referral earnings paid to you.

You can find a step-by-step guide [here](https://dataimpulse.com/blog/dataimpulse-affiliate-program/).

{% hint style="info" %}
Please do not use the DataImpulse trademark in paid search advertisements, as it violates our policy. If we discover that you have violated this rule, we will block your account.
{% endhint %}


# Payment Methods

DataImpulse offers several ways to top up your balance and purchase plans. Available methods can vary by region.

### Traditional Payments

* **Credit and debit cards**: Visa, Mastercard, and other major international cards are supported.
* **Apple Pay and Google Pay**: Fast payment through mobile wallets. Availability depends on your location.
* **Alipay**: Available in supported regions.
* **UPIpay:** Available in supported regions.
* **QRIS:** Available in supported regions.
* **PIX:** Available for users in Brazil, with payments made in BRL.\
  Please note that the maximum amount per transaction is limited to the equivalent of $2500.
* **PayPal:** PayPal access is not available by default and is restricted to most users, requiring a manual request through our Support Team and a verification process where DataImpulse reserves the right to deny access at our sole discretion.

### Cryptocurrencies

You can top up your balance with popular crypto assets through our integrated payment provider, Cryptomus.

**Mind the Fees:** It is critical to account for all network and exchange withdrawal fees when sending your payment.

**Underpayments:** If you send an amount less than the declared invoice total, the transaction will not complete automatically. In this case, you will need to contact Cryptomus Support directly to resolve the issue and locate your funds.

{% hint style="warning" %}
The 7-day refund policy does not apply to cryptocurrency payments.
{% endhint %}

### Wire Transfer

Wire transfers are available for corporate clients and large payments. Please contact our Support Team, and we will generate a bank invoice for you.&#x20;

When you choose this method, please provide the following information in your request:

* **Full Legal Entity Name**
* **Registered Address**
* **VAT/Tax ID**
* **Deposit Amount**

### Key Payment Information

* **Intro plan**: Available for `$5`.
* **Minimum deposit:** The minimum top-up for plans is $50.
* [**Auto-recharge**:](/billing/auto-recharge) You can enable automatic traffic purchases when your balance reaches a set threshold.&#x20;
* **Fees**: Any payment system fees are paid by the client. This includes bank commissions and blockchain network fees.
* **Invoices**: You can review transaction history and download PDF invoices in the [**Payments**](https://app.dataimpulse.com/account/payments) section of your dashboard.
* **Custom Requests:** If you require specific payment documents or custom-formatted invoices for your accounting department, please contact our [Support Team](/support). We will review your request and generate the necessary documents whenever possible.


# Auto-recharge

Set up auto-recharge for your DataImpulse account. Never run out of proxy traffic — configure automatic top-ups based on your balance threshold.

The Auto-recharge Subscription feature allows you to set a certain threshold for the traffic on your account.&#x20;

If the traffic falls below this threshold, the system will automatically create a new order for a specified amount of traffic and charge it to your credit card. This way, you can ensure that your account always has enough traffic without needing to top it up manually. The Auto-recharge Subscription is available with a credit card and PayPal payment method.

**Important Note:** With the FastSpring payment provider, the total subscription amount will be charged immediately upon subscribing, unlike Stripe, which charges once you reach your selected data limit.

For detailed instructions on setting up Auto-recharge, please refer to this [tutorial](https://dataimpulse.com/blog/how-to-use-dataimpulses-auto-charge-feature/).

{% embed url="<https://youtu.be/1Pn3ajRBGV8?feature=shared>" %}


# 2FA

Two-factor authentication on your DataImpulse account. Step-by-step guide to securing your proxy dashboard with 2FA for enhanced account safety.

#### Two-Factor Authentication (2FA)

Two-factor authentication (2FA) is mandatory for all user accounts as an additional security control to reduce the risk of unauthorized access. It is enabled by default using email-based verification and cannot be disabled.

**Configuration and Supported Methods**

Two-factor authentication can be configured on your DataImpulse dashboard in the profile [security settings](https://app.dataimpulse.com/account/security).

The following authentication methods are supported:

* Authenticator application (a temporarily generated code)
* Email-based verification -  enabled by default&#x20;

<figure><img src="https://2032935727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2PNbkVMJTPjkWGv2Kbvj%2Fuploads%2FJ7QAtU7DPYqXntJOFHtL%2Fimage.png?alt=media&amp;token=7c904d20-465a-41fb-9dd8-9d87424dbf9d" alt=""><figcaption></figcaption></figure>

You can switch your 2FA method between email and an authenticator app at any time, but 2FA itself cannot be turned off - one of the two methods always stays active.

{% hint style="info" %}
Please note: **2FA applies only to standard email/password login**. It does **not** apply when signing in via **Google or LinkedIn**.
{% endhint %}

{% embed url="<https://youtu.be/dbkMkD1LKBA>" %}


# Recovering your account if you lose your 2FA credentials

**When you need this guide**

Use this guide if:

* You've lost the device with your authenticator app
* You no longer have access to the email address used for email-based 2FA
* You believe your account has been compromised (an unexpected password change, unrecognized sign-ins, or 2FA was enabled without your action)

**How to request recovery**

Email [**support@dataimpulse.com**](mailto:support@dataimpulse.com) from the email address associated with your account, using the subject line *Account recovery - 2FA reset*.

{% hint style="info" %}
For security, we will temporarily suspend your account access during verification. This protects your data and balance from any further unauthorized activity.
{% endhint %}

To help us verify your identity, please include:

* The email address on your account
* The last 4 digits of the card used for your most recent payment
* The IP address from which you typically sign in

{% hint style="warning" %}
If you can't provide this information, we won't be able to verify that the account belongs to you and won't be able to restore access.
{% endhint %}

**What happens after verification**

Once we've confirmed your identity, our team will:

1. Reset the password on your account
2. Disable 2FA so you can sign in again
3. End all active sessions across devices

After signing in, you'll need to set up 2FA again - this is mandatory to keep using your account. We strongly recommend an authenticator app (TOTP) over email-based codes, as it's more resilient if your inbox is ever compromised.

**How long it takes**

Most recovery requests are reviewed within one business day (excluding weekends and public holidays, as each case is reviewed individually). Cases involving suspected account compromise may take longer while we investigate.

{% hint style="warning" %}
DataImpulse support will never ask for your password, full payment card number, or 2FA codes. If anyone asks for these - even someone claiming to be from DataImpulse - it's a phishing attempt. Forward suspicious messages to <support@dataimpulse.com>.
{% endhint %}


# Account security best practices

Your DataImpulse account - including its balance, billing details, and proxy credentials - is protected by the password and 2FA method you choose. Keeping them safe is your responsibility.

**Password hygiene**

* Use a **strong, unique password** for DataImpulse: at least 8 characters with a mix of letters, numbers, and symbols. Don't reuse passwords from other services.
* Use a **password manager** (1Password, Bitwarden, LastPass, or similar) to store and generate credentials safely.
* **Never share your password**.

**Two-factor authentication**

* Enable **2FA** . See [Two-Factor Authentication (2FA)](/dashboard/2fa) for setup steps.
* Prefer an **authenticator app (TOTP)** over email-based codes - email is more vulnerable if your inbox is compromised.
* **Never share 2FA codes** with anyone, including DataImpulse support.
* If you change your phone or email address, update your 2FA settings **before** losing access to the previous method.

**Protect the email on your account**

If your inbox is compromised, an attacker can intercept password resets and email-based 2FA codes. Enable 2FA on the email provider itself, and watch for any unrecognized sign-in alerts.

**Watch out for phishing**

{% hint style="warning" %}
DataImpulse support will **never** ask for your password, full payment card number, or 2FA codes. If anyone asks for these - even someone claiming to be from DataImpulse - it's a phishing attempt. Forward suspicious messages to <support@dataimpulse.com>.
{% endhint %}

**What to do if you suspect a breach**

If you notice unrecognized sign-ins, unexpected password changes, or unfamiliar payment activity, contact <support@dataimpulse.com> immediately.&#x20;

**Your responsibility**

The password and 2FA method you choose are the front line of your account's security. We protect our infrastructure but a weak, reused, or shared password is something we can't compensate for from our side. If unauthorized access results from credentials that were guessed, leaked, or handed to someone else, we may not be able to recover the account or reverse the damage.


# Active Session management

This feature allows you to monitor unauthorized access and manage your active connections in real-time.

#### Monitoring Your Activity

In the [Security Settings tab](https://app.dataimpulse.com/account/security), under the Active sessions section, you can view details for each connection:

* Device Type: Identifies the operating system and device type (e.g., Desktop · Mac OS X).
* Browser: Displays which web browser was used (e.g., Chrome).
* IP Address: Shows the specific network address of the connection.
* Last Seen: Provides a timestamp of the most recent activity.
* Location: Detects the geographic origin of the session (e.g., The Netherlands).
* Status: A green "Current" badge identifies the device you are using right now.

#### Terminating Sessions

If you notice a suspicious login or simply want to log out from all other devices (for example, after using a public computer), you can use the Terminate all function.

1. Navigate to the Security Settings tab.
2. Scroll down to the Active sessions area.
3. Click the red Terminate all button located at the top right of this section.
4. Result: All existing sessions, except for your current one, will be immediately logged out, requiring a new login (and 2FA code, if enabled) to regain access.

***

{% hint style="warning" %}
For maximum security, we recommend enabling 2FA (Two-Factor Authentication) in this same menu to add an extra layer of protection to every sign-in attempt.
{% endhint %}


# Telegram Notifications

This feature allows you to receive real-time notifications directly to your mobile device or desktop Telegram app, duplicating the critical updates usually sent via email.

#### What notifications will I receive?

By enabling the Telegram integration, you will receive:

* Balance Alerts
* Important Announcements

#### How to Enable Telegram Notifications

1. Log in to your DataImpulse dashboard.
2. Navigate to the Account Settings (click on your profile/icon in the top right corner).
3. Go to the [Integrations tab](https://app.dataimpulse.com/account/integrations).
4. In the "Get Instant Alerts in Telegram" section, click the Connect Telegram button.
5. You will be redirected to the official Telegram bot. Click Start in your Telegram app to link your account.
6. Once linked, your Telegram username will appear in the dashboard, confirming the connection.

#### How to Disable Telegram Notifications

If you wish to stop receiving alerts via Telegram:

1. Go back to the Integrations tab in your account settings.
2. Locate the red Disconnect Telegram button.
3. Click the button to revoke access.
4. *Optional:* You can also stop or block the bot directly within the Telegram app.

***

### FAQ

**Is it free?**\
Yes, Telegram integration is included in all plans at no additional cost.

**Will I still receive emails?**\
Yes, Telegram notifications act as a duplicate for your convenience, ensuring you don't miss critical updates if you are away from your email.

{% hint style="info" %}
Available notification types can vary by account setup.
{% endhint %}


# Support

Have a Question? Our support team is available 24/7.

Have a Question? **Our support team is available 24/7**.

You can reach out to our support team using one of the following methods:

* **Live Chat**: Start a conversation using the live chat widget at the bottom right corner of this documentation or our [website](https://dataimpulse.com/). Live chat is ideal for quick questions or bug reports.
* **Email**: Contact us at <support@dataimpulse.com> for non-urgent questions or suggestions.
* **Telegram**: Contact us at [@di\_support\_team](https://www.telegram.me/di_support_team) for any urgent questions.


