Handling Geo-Restricted Access (IP Whitelisting)

If your target website restricts access to specific regions (e.g., Mainland China), you must provide a compliant upstream proxy. Scrapingbypass API allows you to tunnel requests through your own localized IP resources to bypass geographic blocks.

Implementation Steps

To access geo-restricted content, integrate your regional proxy into the Scrapingbypass API request flow:

  1. Acquire a Regional Proxy: Secure a proxy server or residential IP from the required region (e.g., a China-based ISP).
  2. Configure the Header: Pass your proxy credentials and address via the X-Cb-Proxy custom header.
  3. Execute the Request: The API will use our TLS/JA3 impersonation technology while routing the traffic through your specified regional IP.

Request Format

Include the proxy details in the following format within your request headers:

X-Cb-Proxy: http://username:password@ip:port

Technical Workflow

  • Fingerprint Alignment: Even when using an external proxy, Scrapingbypass API continues to apply browser fingerprinting and session management.
  • WAF Bypass: The API handles Cloudflare/WAF challenges, while the X-Cb-Proxy ensures the target server perceives the request as originating from the authorized region.
  • Protocols: Supports http, https, and socks5 protocols for the upstream proxy.

Important Note

Ensure that the upstream proxy you provide has stable connectivity to the open internet, as it must be able to communicate with the Scrapingbypass API gateway to complete the request lifecycle.