Developer Docs

Quick Start Integration Guide

Compatible with any language or framework. Integrate in minutes. HTTP, HTTPS & SOCKS5 support with full REST API and detailed documentation.

Get Free Credentials API Reference

Quickstart

Choose Your Language

Python — requests

import requests

# ── Basic usage ──────────────────────────────────────────────────
USERNAME = "your_username"
PASSWORD = "your_password"
ENDPOINT = "server.iphtml.biz:15000"

proxies = {
    "http":  f"http://{USERNAME}:{PASSWORD}@{ENDPOINT}",
    "https": f"http://{USERNAME}:{PASSWORD}@{ENDPOINT}",
}

# ── Country targeting ─────────────────────────────────────────────
user_us = f"{USERNAME}-country-US"
proxies_us = {"https": f"http://{user_us}:{PASSWORD}@{ENDPOINT}"}

resp = requests.get("https://ipinfo.io",
                     proxies=proxies_us, timeout=30)
print(resp.json())  # {"ip": "104.x.x.x"}

# ── City targeting ────────────────────────────────────────────────
user_nyc = f"{USERNAME}-country-US-city-NewYork"
proxies_nyc = {"https": f"http://{user_nyc}:{PASSWORD}@{ENDPOINT}"}

Node.js — axios

const axios        = require('axios');
const HttpsProxy   = require('https-proxy-agent');

const USERNAME = 'your_username';
const PASSWORD = 'your_password';
const ENDPOINT = 'server.iphtml.biz:15000';

// Basic usage
const agent = new HttpsProxyAgent(
  `http://${USERNAME}:${PASSWORD}@${ENDPOINT}`
);

const response = await axios.get('https://ipinfo.io', {
  httpsAgent: agent,
});
console.log(response.data);  // { ip: '104.x.x.x' }

// Country targeting
const agentUS = new HttpsProxyAgent(
  `http://${USERNAME}-country-US:${PASSWORD}@${ENDPOINT}`
);

Java — HttpURLConnection

import java.net.*;
import java.io.*;

public class ProxyExample {
    public static void main(String[] args) throws Exception {
        String host     = "server.iphtml.biz";
        int    port     = 15000;
        String username = "your_username-country-US";
        String password = "your_password";

        Proxy proxy = new Proxy(Proxy.Type.HTTP,
            new InetSocketAddress(host, port));

        Authenticator.setDefault(new Authenticator() {
            protected PasswordAuthentication getPasswordAuthentication() {
                return new PasswordAuthentication(
                    username, password.toCharArray());
            }
        });

        URL url = new URL("https://ipinfo.io");
        HttpURLConnection conn =
            (HttpURLConnection) url.openConnection(proxy);
        // conn.getResponseCode() → 200
    }
}

PHP — cURL

$username = 'your_username';
$password = 'your_password';
$endpoint = 'server.iphtml.biz:15000';

$ch = curl_init();

curl_setopt_array($ch, [
    CURLOPT_URL            => 'https://ipinfo.io',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_PROXY          => "http://{$endpoint}",
    CURLOPT_PROXYUSERPWD   => "{$username}-country-US:{$password}",
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_SSL_VERIFYPEER => false,
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;  // {"ip":"104.x.x.x"}

Go — net/http

package main

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

func main() {
    proxyURL, _ := url.Parse(
        "http://your_username-country-US:[email protected]:15000",
    )

    transport := &http.Transport{Proxy: http.ProxyURL(proxyURL)}
    client    := &http.Client{Transport: transport}

    resp, err := client.Get("https://ipinfo.io")
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    fmt.Println(resp.StatusCode)  // 200
}

cURL

# Basic usage
curl -x http://your_username:[email protected]:15000 \
     https://ipinfo.io

# Country targeting (US)
curl -x http://your_username-country-US:[email protected]:15000 \
     https://ipinfo.io

# City targeting (New York)
curl -x "http://your_username-country-US-city-NewYork:[email protected]:15000" \
     https://ipinfo.io

# SOCKS5
curl --socks5 your_username:[email protected]:15001 \
     https://ipinfo.io

Targeting Parameters

Precise Geo Targeting

Append parameters to your username for country, city, or ISP-level targeting.

-country-XX

Target a specific country using ISO 2-letter code.

user-country-US:pass

-city-CityName

Target a specific city (requires country prefix).

user-country-US-city-NewYork:pass

-session-ID

Sticky session — keeps the same IP for the session duration.

user-session-abc123:pass

-rotate

Force rotation on every request (default for rotating proxy).

user-rotate:pass

Proxy Endpoints

All endpoints support both HTTP and SOCKS5 protocols.

Endpoint	Port	Protocol	Description
server.iphtml.biz	15000	HTTP / HTTPS	Residential proxy (rotating)
server.iphtml.biz	15001	SOCKS5	Residential proxy SOCKS5 (rotating)

Integration Features

Designed for Developers

🔌

Zero SDK Required

Works with any HTTP client library. No proprietary SDK to install or maintain.

📡

REST API

Full programmatic control over your proxies, usage stats, and account settings via REST API.

📊

Real-time Analytics

Request logs, traffic stats, and success rate monitoring available in your dashboard.

🔄

Auto Rotation

Configure per-request or interval-based rotation without any code changes.

🌐

All Languages

Python, Node.js, Java, Go, PHP, Ruby, cURL — examples for every popular stack.

🛡️

99.9% Uptime SLA

Enterprise-grade reliability. Automatic failover keeps your pipelines running.

Get Your API Credentials Now

Create Free Account View API Reference