JoyProxy Help

English

简体中文

English

简体中文

Advanced extraction parameters ​

On Endpoint generator, combine the parameters below. They are encoded into the generated long username.

1. Location targeting ​

  • Country: the exit country (United States, United Kingdom, Japan, Germany, and 200+ others).
  • Province / State: after you pick a country, you can lock a state or province (for example California).
  • City: lock a specific city (for example Los Angeles). City inventory changes with live node availability.

2. Carrier targeting (ASN) ​

You can request an exit IP from a specific ASN (for example AS7922 Comcast or AS7018 AT&T).

3. Session control and sticky duration mechanism ​

  • Rotate IPs on every request: the gateway assigns a new exit IP on each HTTP/HTTPS request. Best for large-scale collection, crawling, and anti-block work.
  • Sticky session:
    • Console slider range: supports 1–1440 minutes (up to 24 hours / 1 full day). While the window is active, every request that uses that long username keeps the same exit IP.
    • Custom sticky duration (no upper limit): for longer sessions (e.g., 3 days, 7 days), you are not limited by the UI slider. You can directly edit the sesstime-<minutes> attribute in the username string (e.g., sesstime-10080 for 7 days), which has no hardcoded upper limit.

What happens if the exit IP fails during the sticky window? ​

Residential and Mobile Proxies are routed from real residential home broadband and mobile cellular networks worldwide. During the sticky window, remote physical devices may occasionally go offline due to power-off, system sleep, local network disconnection, or base station handovers.

  • Instant automated failover: the JoyProxy gateway performs millisecond health probing. If the current exit IP becomes unavailable or offline, the system instantly and smoothly reallocates a healthy exit IP in the same region to continue serving requests without dropping the connection.
  • Strict inheritance of geo & ASN: the reallocated exit IP strictly preserves the original country, state/city, and carrier ASN, preventing cross-region jumps.
  • Zero client interruption: the connection remains alive with the exact same hostname, port, username, and password. This behavior mirrors legitimate home broadband reconnects and will not trigger target site anti-fraud mechanisms.

What happens when the sticky session expires? ​

  • Connection stays alive: when the configured sesstime expires (e.g. 1440 minutes elapsed), the underlying connection is never forcibly disconnected. The original long username and password remain valid.
  • Smooth IP rotation: on your next HTTP/HTTPS request, the gateway automatically rotates to a fresh exit IP that inherits the exact same country, region, and ASN attributes.
  • Zero client maintenance: crawlers, anti-detect browsers, and scripts continue operating seamlessly without any reconfiguration or re-extraction.

Endpoint generator settings

4. Protocol and output format ​

  • Protocol: HTTP, HTTPS, and SOCKS5. HTTP and SOCKS5 can both reach HTTPS sites.
  • Output format:
    • Endpoint:port: gate.joyproxy.com:9001.
    • HTTP / SOCKS5 URI: full URI such as http://user:pass@gate.joyproxy.com:9001.
    • Table view: Host, Port, Username, and Password in four columns, for clients that use separate fields.

💡 Pass parameters through the API
To extract in bulk from code and control targeting, the API accepts country_iso, format, and other core parameters. For the full parameter list, limits, and live tests, see OpenAPI Center or Programmatic extract guide.