Quick Start

📘

Decodo Proxies Use Endpoints

• Endpoints are like gateways to IP pools.
• When you connect to an endpoint, your traffic is automatically routed through a random IP address from the Decodo IP pool.

• Static Residential proxies use the following endpoint and port for random requests:

isp.decodo.com:10000

• Here are a few basic request examples in various programming languages:

curl -U "USERNAME:PASSWORD" -x "isp.decodo.com:10000" "https://ip.decodo.com/json"

import requests
url = 'https://ip.decodo.com/json'
username = 'USERNAME'
password = 'PASSWORD'
proxy = f"http://{username}:{password}@isp.decodo.com:10000"
result = requests.get(url, proxies = {
    'http': proxy,
    'https': proxy
})
print(result.text)

const axios = require('axios');
const { HttpsProxyAgent } = require('https-proxy-agent');

const url = 'https://ip.decodo.com/json';
const proxyAgent = new HttpsProxyAgent(
  'http://username:[email protected]:10000');

axios
  .get(url, {
    httpsAgent: proxyAgent,
  })
  .then((response) => {
    console.log(response.data);
  });

<?php

      $url = 'ip.decodo.com/json';
      $proxy = 'isp.decodo.com';
      $port = 10000;
      $user = 'username';
      $psw = 'password';

      $ch = curl_init($url);
      curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
      
      curl_setopt($ch, CURLOPT_PROXY, "$proxy:$port");
      curl_setopt($ch, CURLOPT_PROXYUSERPWD, "$user:$psw");
      $result = curl_exec($ch);
      curl_close($ch);

      if ($result) {
        echo $result . PHP_EOL;
      }

package main

import (
    "log"
    "net/http"
    "net/url"
)

   func main() {
     proxyUrl, err := url.Parse("http://username:[email protected]:10000")
     if err != nil {
       log.Fatalln(err)
     }

     client := &http.Client{
       Transport: &http.Transport{Proxy: http.ProxyURL(proxyUrl)},
     }
     req, err := http.NewRequest("GET", "https://ip.decodo.com/json", nil)
     if err != nil {
       log.Println(err)
     }

     res, err := client.Do(req)
     log.Println(res)

     if err != nil {
       log.Println(err)
     }
   }

import java.net.*;
import java.io.*;
import java.util.Scanner;

public class ProxyTest
{
   public static void main(String[] args) throws Exception
   {
  	InetSocketAddress proxyAddress = new InetSocketAddress("isp.decodo.com", 10000); // Set proxy IP/port.
  	Proxy proxy = new Proxy(Proxy.Type.HTTP, proxyAddress);
  	URL url = new URI("https://ip.decodo.com/").toURL(); //enter target URL
  	Authenticator authenticator = new Authenticator() {
     	public PasswordAuthentication getPasswordAuthentication() {
        	return (new PasswordAuthentication("username","password".toCharArray())); //enter credentials
     	}
  	};


  	Authenticator.setDefault(authenticator);
   URLConnection urlConnection = url.openConnection(proxy);


//Scanner to view output

Scanner scanner = new Scanner(urlConnection.getInputStream());
   System.out.println(scanner.nextLine());
   scanner.close();

   }
}

📘

Control Your Connection

• You can make this more specific by adding parameters to control the IP selection and location.
• Keep reading for a step-by-step walkthrough on specifying and generating more examples.

Authentication

1. First, navigate to the Static Residential → Dedicated ISP → Proxy setup page on your dashboard and look for the Authentication section.
   • You’ll see that your first proxy user and password are created automatically.
2. Next, select your proxy authentication method.
   • This can be either your whitelisted IP address or one of your proxy users

📘

Additional Authentication Options

1. You may copy your password by clicking on it

2. To see the password click the eye icon.

3. You can generate a new password by clicking on the arrow icon and choosing Confirm.

4. Here, you can also see the used traffic per proxy user, or check the used traffic sum of your whitelisted IPs.

• You can further manage your credentials in the Authentication tab. For more details, check out the Authentication Methods article.

Proxy Setup

In the ISP Pay/GB Proxy Setup section of your dashboard, selecting various parameters will generate examples you can easily copy into your applications, tools, or code.

1. On the Static Residential → Dedicated ISP → Proxy setup page, find the parameter selection section below your authentication methods.

Location

2. First, select the Location of your proxy. Choosing a specific country or multiple countries will allow you to generate a list with only those locations.

📘

Direct IP Targeting

• You can specify the IPs you would like to connect as a parameter by selecting the Direct IP option.
  • You can toggle the IPs, select all, or use the search field to create a list.
  • The IP selection will be limited to selected countries under Location (All countries will provide an entire list).

📘

IP-based Whitelisting and Location Selection

• For Dedicated ISP Proxies, a location or IP can only be specified when using the user:pass authentication method. Otherwise, All countries will be preselected with a whitelisted IP.

Session Type

3. Afterward, select your preferred Session Type, Rotating or Static.

📘

Session Ports

• Static – Ports 10001-63000 provide a static IP address that remains until you decide to change it or the session ends.
• Rotating – Port 10000 rotates the IP address on every request you make.

Protocol

4. Finally, choose the Protocol format. Endpoint:port, HTTP, HTTPS, and SOCKS5 options are available.

Proxy List Examples

Once you're done setting up in the Proxy Setup section, you will see a proxy list of generated endpoints and ports based on your selection.

1. Simply copy it to your clipboard, or download a .csv or .txt file of the created proxy list.
2. Alternatively, copy single elements of the generated parameters, such as the Proxy Address, Port, Username, Password, and IP, or copy the entire example string.

📘

Endpoint List Control

1. The number of generated endpoints in the list will depend on how many IPs you purchased with your plan.
   • If you select only specific IPs or countries, the total number of generated endpoints will equal your plan's IP count, but the generated IPs will repeat to fill the list.
2. Set the number of how many endpoints to display per page (10, 25, 50, or 100).
3. Hide your password by clicking on the eye icon. This will not affect the copy & paste function.
4. Click Switch view at the top right under Layout to display the entire parameter string.

Code Examples

You can test your proxies using code examples, based on your previous selection in the Proxy Setup section of your dashboard, generated at the very bottom.

1. You can select any of the available languages: cURL, Python, NodeJS, PHP, orGO.
2. Click Copy in the bottom right corner for convenient pasting.

Integration Guides

Once you generate the endpoints and ports, you can apply them to any application or tool to start using proxies instantly.

📘

Decodo Tools

• Alternatively, you can use the Decodo Extension for Chrome or Firefox.

📘

Integration Guides

• Check out the most popular 3rd party tool guides in the Integrations overview section.

📘

GitHub

• For any advanced code samples and middleware please visit our GitHub page.

Statistics

To track Dedicated ISP proxy usage, navigate to the Static Residential → Dedicated ISP → Usage statistics section.

1. Here, you can view a Graph of traffic usage sorted by Proxy users and Date, as well as see the total Usage, Total Upload, Total Download, and Total Successful Requests.
2. Export in .CSV, .TXT formats or simply Copy the data to your clipboard.

• All dates are in UTC.

Troubleshooting

If you are experiencing any issues, please refer to our troubleshooting section or contact our support team directly, which is available 24/7.