Quickstart

Make your first proxied request in under a minute.

1. Create an account and pick a plan

   Sign up at shifter.io/order and choose a plan.

2. Grab your credentials

   Open the client dashboard and copy your proxy username and password (or API key for the Scraping/SERP APIs). They look like:

   Username: customer-USERNAME
   Password: 5f8a9c2b1d3e4f6g7h8i
   Gateway:  p.shifter.io:443

3. Send your first request

   Route any HTTP call through the gateway. The username encodes your targeting:

   curl

   curl -x customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443 \
     https://ipinfo.io/json

   Python

   import requests
   
   proxy = "customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443"
   proxies = {"http": proxy, "https": proxy}
   
   r = requests.get("https://ipinfo.io/json", proxies=proxies)
   print(r.text)

   Node.js

   import fetch from 'node-fetch';
   import { HttpsProxyAgent } from 'https-proxy-agent';
   
   const agent = new HttpsProxyAgent(
     'customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443'
   );
   
   const res = await fetch('https://ipinfo.io/json', { agent });
   console.log(await res.text());

   TypeScript

   import axios from 'axios';
   import { HttpsProxyAgent } from 'https-proxy-agent';
   
   const agent = new HttpsProxyAgent(
     'customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443'
   );
   
   const { data } = await axios.get<string>('https://ipinfo.io/json', {
     httpAgent: agent,
     httpsAgent: agent,
   });
   
   console.log(data);

   JavaScript

   const fetch = require('node-fetch');
   const { HttpsProxyAgent } = require('https-proxy-agent');
   
   const agent = new HttpsProxyAgent(
     'customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443'
   );
   
   fetch('https://ipinfo.io/json', { agent })
     .then((r) => r.text())
     .then(console.log);

   Go

   package main
   
   import (
     "fmt"
     "io"
     "net/http"
     "net/url"
   )
   
   func main() {
     proxyURL, _ := url.Parse("customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443")
     client := &http.Client{
       Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)},
     }
   
     resp, _ := client.Get("https://ipinfo.io/json")
     defer resp.Body.Close()
     body, _ := io.ReadAll(resp.Body)
     fmt.Println(string(body))
   }

   Rust

   use reqwest::blocking::Client;
   use reqwest::Proxy;
   
   fn main() -> Result<(), Box<dyn std::error::Error>> {
       let proxy = Proxy::all("http://p.shifter.io:443")?
           .basic_auth("customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600", "PASSWORD");
   
       let client = Client::builder().proxy(proxy).build()?;
       let body = client.get("https://ipinfo.io/json").send()?.text()?;
       println!("{body}");
       Ok(())
   }

   Java

   import java.net.*;
   import java.net.http.*;
   
   public class Main {
       public static void main(String[] args) throws Exception {
           HttpClient client = HttpClient.newBuilder()
               .proxy(ProxySelector.of(new InetSocketAddress("p.shifter.io", 443)))
               .authenticator(new Authenticator() {
                   protected PasswordAuthentication getPasswordAuthentication() {
                       return new PasswordAuthentication(
                           "customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600",
                           "PASSWORD".toCharArray()
                       );
                   }
               })
               .build();
   
           HttpRequest req = HttpRequest.newBuilder(URI.create("https://ipinfo.io/json")).build();
           HttpResponse<String> res = client.send(req, HttpResponse.BodyHandlers.ofString());
           System.out.println(res.body());
       }
   }

   C#

   using System.Net;
   using System.Net.Http;
   
   var handler = new HttpClientHandler
   {
       Proxy = new WebProxy("http://p.shifter.io:443")
       {
           Credentials = new NetworkCredential(
               "customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600",
               "PASSWORD"
           )
       },
       UseProxy = true
   };
   
   using var client = new HttpClient(handler);
   var ip = await client.GetStringAsync("https://ipinfo.io/json");
   Console.WriteLine(ip);

   PHP

   <?php
   require 'vendor/autoload.php';
   
   $client = new GuzzleHttp\Client([
       'proxy' => 'customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443',
   ]);
   
   $res = $client->get('https://ipinfo.io/json');
   echo $res->getBody();

4. Target a country, session, or ISP

   Use parameters to control geo, session, and routing:

   Parameter	Example	Effect
   country-XX	customer-USERNAME-country-de	Route through Germany
   region-NAME	customer-USERNAME-region-california	Target a specific region/state
   city-NAME	customer-USERNAME-city-new_york	Target a specific city
   asn-NUMBER	customer-USERNAME-asn-7922	Target a specific ASN
   sid-ID	customer-USERNAME-sid-abc	Sticky session (same IP held for the default TTL of 120s)
   ttl-SECONDS	customer-USERNAME-sid-abc-ttl-600	Custom TTL in seconds for the sticky session (requires sid)
   strict-true	customer-USERNAME-country-us-strict-true	Fail with 502 instead of falling back to a broader pool

What’s next

• Authentication - API keys vs. username/password
• Choosing a product - pick the right Shifter product
• API Reference - every REST endpoint, every parameter