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 → ISP Pay/GB → 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 and add a traffic limit 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 → ISP Pay/GB → Proxy setup page, find the parameter selection section below your authentication methods.

Location

2. First, select the Location of your proxy.

📘

IP-based Whitelisting And Location Selection

• For ISP Pay/GB Proxies a location can only be specified when using the user:pass authentication method. Otherwise, you can only select a random location 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, and Password, or copy the entire example string.

📘

Endpoint List Control

1. You can set the number of generated endpoints.
2. As well as how many of them you would like 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

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 dedicated Decodo tools like the Decodo X Browser and the Decodo Extension for Chrome and 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 ISP Pay/GB proxy usage, navigate to the Static Residential → ISP Pay/GB → 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.