Så använder du våra proxies — targeting, sticky sessions och API-nycklar

Grundfallet är enkelt: använd din API-nyckel som proxy-användarnamn och peka din klient på proxy.proxyapi.se:8080. Men det finns flera rattar du kan vrida på när du behöver — utan att lämna användarnamnet.

Det enklaste anropet

curl -x http://sk_live_abc123:@proxy.proxyapi.se:8080 https://httpbin.org/ip

Ingenting mer. Selektorn väljer en proxy åt dig baserat på latens och success rate. Fungerar för 90% av användningsfallen.

Targeting per request

Behöver du en specifik proxytyp eller session bara för det här anropet? Lägg till modifierare direkt i användarnamnet:

# Tvinga ISP-proxy
curl -x http://sk_live_abc123-type-isp:@proxy.proxyapi.se:8080 https://...

# Datacenter för speed
curl -x http://sk_live_abc123-type-datacenter:@proxy.proxyapi.se:8080 https://...

# Kombinera — datacenter + sticky session
curl -x http://sk_live_abc123-type-datacenter-session-job42:@proxy.proxyapi.se:8080 https://...

Ordningen spelar ingen roll. Vi parsar höger-till-vänster tills första icke-modifierare — resten är din nyckel. Du kan bygga exakta användarnamn interaktivt i dashboarden under /keys.

Sticky sessions

En del flöden bryter om exit-IP:n ändras mellan anropen — checkout, inloggning, CSRF-tokens, paginerade API:er med session-state. Lägg till -session-<id> och alla anrop med samma id går via samma proxy i 10 minuter:

# Login-flöde — samma proxy från login till cart till checkout
USER="sk_live_abc123-session-cart-$(uuidgen)"
curl -x "http://$USER:@proxy.proxyapi.se:8080" https://shop.example/login
curl -x "http://$USER:@proxy.proxyapi.se:8080" https://shop.example/cart/add
curl -x "http://$USER:@proxy.proxyapi.se:8080" https://shop.example/checkout

Olika session-id:n = oberoende pinnings. Olika jobb på samma konto kan köra parallellt utan att trampa på varandra.

Konto-preferenser vs per-request

I Settings → Proxy preferences kan du sätta en persistent default-typ (t.ex. "ISP") och aktivera sticky sessions som standard. Det gäller alla dina anrop utan att du behöver ändra koden.

Reglerna när de två kombineras:

• Sätter du -type-datacenter i ett anrop vinner det över din "ISP"-preferens för just det anropet.
• Är din preferens "ISP" och du inte skickar någon -type- får du ISP-proxies.
• Om ISP-poolen är tom just nu faller vi mjukt tillbaka till valfri typ istället för att returnera 502 (per-request-modifierare är däremot strikt).
• Sticky sessions i Settings + ingen -session- = vi pinnar automatiskt per API-nyckel. Lägg till en explicit -session-id om du behöver finare granularitet.

Python

import requests

key = "sk_live_abc123"
proxies = {
    "http":  f"http://{key}-type-isp:@proxy.proxyapi.se:8080",
    "https": f"http://{key}-type-isp:@proxy.proxyapi.se:8080",
}
r = requests.get("https://httpbin.org/ip", proxies=proxies)
print(r.json())

Node.js

import { HttpsProxyAgent } from "https-proxy-agent";

const key = "sk_live_abc123";
const session = `job-${process.env.JOB_ID}`;
const agent = new HttpsProxyAgent(`http://${key}-session-${session}:@proxy.proxyapi.se:8080`);

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

När saker går fel

Ser du många 502:or mot ett specifikt mål? Öppna validators-sidan, peka en health check mot samma URL, och du ser per-proxy vilken som blockas. Klicka Stäng av på de proxies som konsekvent misslyckas — de hoppas över för dina framtida requests utan att påverka andra kunder.

Och behöver du debugga ett enskilt anrop? Varje failed CONNECT loggas i dashboarden med exit-IP och felmeddelande, så du slipper gissa om problemet är proxy, nätverk eller destination.