Quickstart

Route a single HTTP(S) request through the Shifter gateway to verify your plan is live and see a residential IP in action.

1. Sign in to get credentials

   Log in at shifter.io/panel and open the Residential Proxies section. Copy your username, your password, and confirm the gateway address is p.shifter.io:443.

2. Route a request through the gateway

   Replace USERNAME and PASSWORD, then pick your language.

   curl

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

   Python

   import requests
   
   proxies = {
       "http":  "customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443",
       "https": "customer-USERNAME-country-us-sid-9f3a2b7c-ttl-600:PASSWORD@p.shifter.io:443",
   }
   
   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());

3. Verify the response

   You should see a US residential IP address. The sid-9f3a2b7c in the username pins that IP for the default 120-second TTL; the ttl-600 extends it to 600 seconds. Remove the sid flag (just customer-USERNAME-country-us) to rotate to a fresh IP on every request.

4. Add session stickiness or tighter targeting

   Keep the same IP by adding sid-abc to the username (default 120s lifetime). Add ttl-600 alongside sid to extend it to 10 minutes. Target a city with city-los_angeles, a region with region-california, or a network with asn-7922. Details in Sessions and Geo-targeting.

Tip

Use the endpoint builder inside shifter.io/panel under Residential Proxies to assemble the username visually and copy a ready-to-use proxy URL.