Documentation
One gateway, three networks, every IP in South Korea. Pick the city or session you want by writing it into the username; the rest is the HTTP client you already use.
What the gateway is
ScalarData is a proxy gateway. Your client opens a normal proxy connection to one host, the gateway picks a Korean exit IP that matches what you asked for, and your request leaves from that IP. There is no SDK and nothing to install: anything that can talk to an HTTP or SOCKS5 proxy can use it, from cURL to a browser automation framework.
Every network, every protocol and every city share the same endpoint. What changes between requests is the username you send, not the host you connect to.
icn-01.gw.scalardata.ai:7777The port is the same for HTTP, HTTPS (through CONNECT) and SOCKS5. See Protocols for the differences between them.
The three networks
A proxy user is created for one network. Requests sent with that user exit through that network unless you override it in the username. Every IP on every network is in South Korea; the networks differ in where the IPs come from and, as a result, in how Korean sites treat them.
- Residential
- Korean residential exits from our upstream pool. Rotate per connection or hold a sticky session for up to 30 minutes, targeted by city.
- ISP
- Addresses registered to Korean ISPs and hosted on servers. Static IPs that stay yours for as long as the plan runs, with no per-GB charge.
- Datacenter
- Korean datacenter IPs for targets that do not fight back. Dedicated to your account, at the lowest cost per IP.
The username carries the targeting
The proxy username starts with an optional network prefix, your account handle and the name of your proxy user, followed by optional parameter-value pairs (each key at most once), all joined by hyphens. The gateway reads them on every connection, so two requests with different usernames can go to two cities, or hold two separate sessions, with no change of endpoint.
# handle = k7f3q2
# user = acme
# where = South Korea, Seoul
# how = keep the same IP under session "a1b2"
k7f3q2-acme-country-kr-city-seoul-session-a1b2Sent through cURL, that username looks like this:
curl -x icn-01.gw.scalardata.ai:7777 \
-U "k7f3q2-acme-country-kr-city-seoul-session-a1b2:PASSWORD" \
https://ipinfo.io/jsoncountry-kr is the only country value the gateway accepts today; city and ASN narrow the pool inside South Korea. The full list of parameters, with the rules for each, is on the targeting syntax page.
Where to go next
- Quickstart
From a new account to a request routed through a Korean residential IP, in five steps and a few minutes.
- Payments
What you can pay for by card or in crypto, how a crypto invoice works, and what to do when a payment does not arrive.
- Authentication
Username and password, or a whitelist of your own server IPs. Both are set per proxy user, and an account can have up to 100 proxy users.
- Targeting syntax
Country, city, ASN and session are all parameters in the proxy username. This is the full grammar.
- Sessions
Get a fresh exit on every connection, or hold one IP for up to thirty minutes with a session ID you choose.
- Protocols
HTTP, HTTPS through CONNECT, and SOCKS5, all on the same host and port. What each one does with TLS and DNS.
- API reference
A small REST API for the things you would otherwise click through the dashboard for: proxy users, usage and whitelists.
- Errors
What each status code from the gateway means, what usually causes it, and what to change.