JoyProxy Whitelist, Credentials, and Your First Proxy Extraction

JoyProxy separates who may ask for an IP (whitelist / account security) from how applications authenticate to the proxy (username/password or tokenized API). Skipping either step is the most common reason a first extraction fails.

Step 1 — Register and verify email

Create an account at register.html and complete email activation. New users receive $5 free credit after verification (no credit card required)—enough to run real tests on a small traffic package.

Step 2 — Add your client IP to the whitelist

In the customer dashboard, open IP whitelist settings and add the public egress IP of the machine that will call JoyProxy extraction APIs or use the web extractor—not your LAN address if you are behind NAT. You can register up to ten whitelist entries per account (see Terms).

If your scraper runs on a cloud VM, whitelist the VM’s outbound IP. If it runs on a laptop on home Wi-Fi, whitelist what curl ifconfig.me returns from that laptop.

Step 3 — Choose authentication for your app

Most integrations use either:

• Proxy username + password generated in the dashboard (apps connect directly to the proxy host with these credentials).
• Extract Token / API token for programmatic /extract calls that return endpoint details.

Tokens and credentials are secrets—store them in environment variables, not in public repositories.

Step 4 — Extract an endpoint

From the dashboard extraction center, pick product type (short-term, long-term, or custom), region if applicable, and copy the HTTP/HTTPS/SOCKS5 endpoint. Alternatively call https://api.joyproxy.com/v1/extract with your token (documented in the logged-in OpenAPI Center).

Step 5 — Verify with a minimal request

curl -x http://USER:PASS@HOST:PORT https://api.ipify.org

The response should show an IP consistent with your chosen region. If you receive authentication errors, re-check whitelist IP and credential pairs—they are evaluated together.