Skip to content

Quickstart

From a new account to a request routed through a Korean residential IP, in five steps and a few minutes.

1. Create an account

Sign up with an email address. New accounts start with $3 of free credit for residential traffic, which unlocks once you verify the account under Billing: a $1 card payment, added to your dollar credit, or a crypto payment of $5 or more. Until then the gateway answers 402 verification_required.

2. Create a proxy user

In the dashboard, open Proxy users and create one. Give it a short name (this quickstart uses acme) and choose Residential as its network. The dashboard generates a 16-character password; copy it with Show. The username your client sends is your account handle followed by this name (k7f3q2-acme here), and the password is the generated one; the account login is never used for proxy traffic.

You can create up to 100 proxy users, one per project or per environment, and see their usage separately. See Authentication.

3. Copy the endpoint

Every request goes to the same host and port, whichever network or protocol you use:

icn-01.gw.scalardata.ai:7777

4. Make a request

Point your client at the endpoint with your handle and proxy user as the username, followed by -country-kr to ask for a Korean IP. Replace k7f3q2 with your own handle and PASSWORD with the password you copied in step 2.

curl -x icn-01.gw.scalardata.ai:7777 \
  -U "k7f3q2-acme-country-kr:PASSWORD" \
  https://ipinfo.io/json

The proxy URL form, http://user:pass@host:port, is what most libraries and frameworks expect in a proxy setting or an HTTPS_PROXY environment variable.

5. Verify the exit IP

ipinfo.io reports the address it was reached from. If the request went through the gateway, the answer is not your own IP and the country is KR:

{
  "ip": "203.0.113.42",
  "city": "Seoul",
  "region": "Seoul",
  "country": "KR",
  "org": "AS64496 Example Broadband",
  ...
}

Run it twice. Without a session parameter the gateway rotates, so the second answer usually comes from a different IP. To keep the same IP across requests, add a session ID; see Sessions.

Next steps

  • Targeting syntax: narrow the exit IP to a city or an ASN inside South Korea.
  • Sessions: hold one IP for a login flow or a multi-page crawl.
  • Protocols: use SOCKS5, or understand what the gateway does and does not see over HTTPS.
  • API reference: create proxy users and read usage from your own code.