Scrapingbypass Proxy API Documentation

You can manage and configure everything directly from the Scrapingbypass Proxy dashboard:
https://console.scrapingbypass.com/#/proxy/account

This guide walks you through the basics of using Scrapingbypass Proxy, including authentication, proxy configuration, and request setup. Learn how to connect using username/password credentials, configure location and session parameters, and ensure stable, high-performance proxy usage for web scraping and automation scenarios.

Quick Start

ScrapingBypass provides high-performance overseas proxies optimized for global data collection.

ScrapingBypass utilizes Username:Password credentials for basic authentication. To begin, click the encrypted string in your traffic card within the dashboard to copy your credentials. New users must activate a Data Plan first.

Example cURL Request:

curl -x "http://username[options]:[email protected]:1288" http://ipinfo.scrapingbypass.com
  • Username/Password: Your unique credentials used for proxy authentication.
  • Options: Optional configuration parameters separated by underscores (_). These must remain in the specified order.

Configuration Options

OptionFormatDescription
Country / Region[_Area[-State[-City]]]Use a standard country or region code. Separate the region, state, and city with hyphens (-). Replace any spaces with plus signs (+).
Example (New York): USERNAME_US-New+York:[email protected]:1288
Sticky Sessions[_Session[-Number[Unit]]]To enable Sticky Sessions, the session value must start with s (we recommend up to 16 characters). This keeps the IP as stable as possible for your task.
Example (Session ID): USERNAME_s000000000000:[email protected]:1288
Duration[-Number[Unit]]Duration must be used in conjunction with a Session. The default is 5 minutes. Supported units are s (seconds), m (minutes), and h (hours).
Example (20min Fixed IP): USERNAME_s000000000000-20m:[email protected]:1288

Technical Constraints & Response Codes

  • Protocol Support: Supports HTTP and SOCKS5.
  • HTTPS Restriction: ScrapingBypass currently does not support direct connections via the HTTPS protocol to the proxy host (HTTPS-over-Proxy). Ensure your client connects to the gateway via HTTP or SOCKS5.

Common Response Codes:

CodeDescription
407Proxy authentication required. Check your Username:Password.
503Service unavailable. Ensure your Data Plan has a remaining balance.