2extract Developer Documentation

This guide assumes you have already created your first Residential Proxy. Here, we’ll focus on how to use it with a simple example.

Your Connection Credentials

First, navigate to your proxy’s settings page in the My Proxies dashboard. You will need the following from the “Connection Details” block:

Host: proxy.2extract.net
Port: (e.g., 5555)
Username: (e.g., 2xt-customer-...-proxy-my_scraper)
Password: (Click “Show” to reveal)

Example: Getting an IP from Germany

Let’s make a request to get an IP address from Germany. We will do this by adding the -country-de parameter to your username.

# Replace with your actual credentials
USERNAME="PROXY_USERNAME-country-de"
PASSWORD="PROXY_PASSWORD"
HOST="proxy.2extract.net:5555"

curl "https://api.ipify.org?format=json" \
  --proxy "https://${USERNAME}:${PASSWORD}@${HOST}"

import requests

# Replace with your actual credentials
proxy_details = {
  "username": "PROXY_USERNAME-country-de",
  "password": "PROXY_PASSWORD",
  "host": "proxy.2extract.net",
  "port": 5555,
}

proxies = {
 "http": f"https://{proxy_details['username']}:{proxy_details['password']}@{proxy_details['host']}:{proxy_details['port']}",
 "https": f"https://{proxy_details['username']}:{proxy_details['password']}@{proxy_details['host']}:{proxy_details['port']}",
}

response = requests.get('https://api.ipify.org?format=json', proxies=proxies)

print(response.json())

The https:// in front of your credentials describes the link to our gateway, not the site you are visiting. It keeps your proxy password encrypted on the way to us, and works for http:// and https:// targets alike. See HTTPS vs. HTTP.

If successful, the response will be a JSON object containing an IP address located in Germany.

That’s it! You can now use this logic to target any country or configure sessions. For a full list of possibilities, check out our Configuration Guide.

Getting Started

Guides & Concepts

Proxy Products

Geo Reference

Troubleshooting & Help

Legal

Release Notes

Residential Proxies: Quick Start

Your Connection Credentials

Example: Getting an IP from Germany

​Your Connection Credentials

​Example: Getting an IP from Germany

Your Connection Credentials

Example: Getting an IP from Germany