Samurai Proxies Documentation

# Quick test — see your exit IP
curl -x "http://res-us:YOUR_PROXY_KEY@samuraiproxy.net:8081" \
  https://httpbin.org/ip

# HTTP / HTTPS proxy
Proxy-Authorization: Basic base64(username:proxy_key)

# SOCKS5
username = routing_string    (e.g. res-us)
password = proxy_key         (e.g. sam-abc123...)

# Example
curl -x "http://res-us:sam-your-key@samuraiproxy.net:8081" https://httpbin.org/ip

{type}-{country}

res-any         # Residential rotating, random country
res-us          # Residential rotating, United States
stc-nl          # Static ISP, Netherlands
mob-uk          # Mobile, United Kingdom
dc-de           # Datacenter, Germany

{type}-{country}-sid-{session_id}

res-us-sid-123456789    # Same IP while session is alive
stc-jp-sid-987654321    # Static sticky session
mob-any-sid-123456789   # Mobile sticky session
dc-any-sid-123456789    # Datacenter sticky session

{type}_sc-{country}_{city}
{type}_sc-{country}_{state}_{city}

res_sc-nl_amsterdam                # Residential, Amsterdam
stc_sc-nl_amsterdam                # Static ISP, Amsterdam
res_sc-us_california_losangeles     # Residential, LA
res_sc-us_new_york_newyork          # Residential, NYC
stc_sc-us_texas_dallas              # Static ISP, Dallas
res_sc-us_florida_miami             # Residential, Miami

res-{country}-Lsid-{id}-TTL-{seconds}

res-us-Lsid-875078898-TTL-3600   # Long session, up to 1 hour
res-any-Lsid-123456789-TTL-1800  # Global, 30 minutes

res-{country}-asn-{number}

res-af-asn-55330   # Afghanistan, specific network
res-us-asn-14615   # United States, specific network

# HTTP proxy
curl -x "http://res-us:YOUR_PROXY_KEY@samuraiproxy.net:8081" \
  https://httpbin.org/ip

# SOCKS5
curl --socks5-hostname "res-us:YOUR_PROXY_KEY@samuraiproxy.net:8081" \
  https://httpbin.org/ip

# Sticky session
curl -x "http://res-us-sid-123456789:YOUR_PROXY_KEY@samuraiproxy.net:8081" \
  https://httpbin.org/ip

# State / City
curl -x "http://res_sc-us_california_losangeles:YOUR_PROXY_KEY@samuraiproxy.net:8081" \
  https://httpbin.org/ip

# Long session (LSID, 1 hour)
curl -x "http://res-us-Lsid-875078898-TTL-3600:YOUR_PROXY_KEY@samuraiproxy.net:8081" \
  http://httpbin.org/ip

import requests

PROXY_KEY = "sam-your-proxy-key"
ENDPOINT = "samuraiproxy.net:8081"

# Rotating residential US
proxies = {
    "http": f"http://res-us:{PROXY_KEY}@{ENDPOINT}",
    "https": f"http://res-us:{PROXY_KEY}@{ENDPOINT}",
}
r = requests.get("https://httpbin.org/ip", proxies=proxies)
print(r.json())

# Sticky session
proxies = {
    "http": f"http://res-us-sid-123456789:{PROXY_KEY}@{ENDPOINT}",
    "https": f"http://res-us-sid-123456789:{PROXY_KEY}@{ENDPOINT}",
}
r = requests.get("https://httpbin.org/ip", proxies=proxies)
print(r.json())

import { ProxyAgent } from "undici";

const PROXY_KEY = "sam-your-proxy-key";
const ENDPOINT = "samuraiproxy.net:8081";
const agent = new ProxyAgent(
  `http://res-us:${PROXY_KEY}@${ENDPOINT}`
);

const res = await fetch("https://httpbin.org/ip", {
  dispatcher: agent,
});
console.log(await res.json());

package main

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

func main() {
    proxyURL, _ := url.Parse("http://res-us:sam-your-proxy-key@samuraiproxy.net:8081")
    client := &http.Client{
        Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)},
    }
    resp, _ := client.Get("https://httpbin.org/ip")
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

<?php
$ch = curl_init("https://httpbin.org/ip");
curl_setopt($ch, CURLOPT_PROXY, "samuraiproxy.net:8081");
curl_setopt($ch, CURLOPT_PROXYUSERPWD, "res-us:sam-your-proxy-key");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
echo curl_exec($ch);
curl_close($ch);

using System.Net;
using System.Net.Http;

var proxy = new WebProxy("http://samuraiproxy.net:8081")
{
    Credentials = new NetworkCredential("res-us", "sam-your-proxy-key"),
};
var handler = new HttpClientHandler { Proxy = proxy };
using var client = new HttpClient(handler);
Console.WriteLine(await client.GetStringAsync("https://httpbin.org/ip"));

export HTTP_PROXY="http://res-us:YOUR_PROXY_KEY@samuraiproxy.net:8081"
export HTTPS_PROXY="http://res-us:YOUR_PROXY_KEY@samuraiproxy.net:8081"
export ALL_PROXY="socks5://res-us:YOUR_PROXY_KEY@samuraiproxy.net:8081"

# Now any CLI tool that reads these vars will use the proxy
curl https://httpbin.org/ip
wget -qO- https://httpbin.org/ip

# Sticky session — same IP for multiple requests
curl -x "http://res-us-sid-123456789:YOUR_PROXY_KEY@samuraiproxy.net:8081" \
  https://httpbin.org/ip

# Long session — same IP for up to 1 hour
curl -x "http://res-us-Lsid-875078898-TTL-3600:YOUR_PROXY_KEY@samuraiproxy.net:8081" \
  https://httpbin.org/ip

POST /api/scraper/scrape
Content-Type: application/json
Cookie: samurai_session=YOUR_SESSION_COOKIE

{
  "url": "https://example.com",
  "format": "markdown",
  "proxyType": "res-us",
  "selector": "h1, .title"
}

{
  "url": "https://example.com",
  "status": 200,
  "title": "Example Domain",
  "content": "# Example Domain

This domain...",
  "format": "markdown",
  "selector": null,
  "proxyType": "res-us",
  "exitIp": null,
  "latency": 3456,
  "contentLength": 1234
}

import requests

r = requests.post(
  "https://samuraiproxy.net/api/scraper/scrape",
  json={
    "url": "https://news.ycombinator.com",
    "format": "json",
    "selector": ".titleline > a",
    "proxyType": "res-us"
  },
  cookies={"samurai_session": "YOUR_COOKIE"}
)
print(r.json())

const r = await fetch(
  "https://samuraiproxy.net/api/scraper/scrape",
  {
    method: "POST",
    headers: {"Content-Type": "application/json"},
    body: JSON.stringify({
      url: "https://news.ycombinator.com",
      format: "markdown",
      proxyType: "res-us"
    })
  }
);
console.log(await r.json());