Download the PHP package browser7/sdk without Composer

Browser7 PHP SDK

Official PHP client for the Browser7 web scraping and rendering API.

Browser7 provides geo-targeted web scraping with automatic proxy management, CAPTCHA solving, and powerful wait actions for dynamic content.

Features

• 🌍 Geo-Targeting - Render pages from specific countries and cities using residential proxies
• 🤖 CAPTCHA Solving - Automatic detection and solving of reCAPTCHA and Cloudflare Turnstile
• 📸 Screenshots - Capture viewport or full-page screenshots in PNG or JPEG
• 🌐 In-Browser Fetch - Fetch additional URLs through the rendered page's browser context
• ⏱️ Wait Actions - Click elements, wait for selectors, text content, or delays
• 🚀 Performance - Block images, track bandwidth, view timing breakdowns
• 🔄 Automatic Polling - Built-in polling with progress callbacks
• 🐘 PHP 8.0+ - Full type declarations for IDE support

Installation

Requirements: PHP 8.0+

Quick Start

Authentication

Get your API key from the Browser7 Dashboard.

Usage Examples

Basic Rendering

With Wait Actions

With CAPTCHA Solving

With Screenshots

Fetch Additional URLs

Check Account Balance

API Reference

new Browser7Client(string $apiKey, ?string $baseUrl = null)

Create a new Browser7 client.

Parameters:

• $apiKey (string, required): Your Browser7 API key
• $baseUrl (string, optional): Full API base URL. Defaults to production API.

Example:

$client->render(string $url, array $options = []): RenderResult

Render a URL and poll for the result.

Parameters:

• $url (string): The URL to render
• $options (array, optional):
  • countryCode (string): Country code (e.g., 'US', 'GB', 'DE')
  • city (string): City name (e.g., 'new.york', 'london')
  • waitFor (array): List of wait actions (max 10)
  • captcha (string): CAPTCHA mode: 'disabled', 'auto', 'recaptcha_v2', 'recaptcha_v3', 'turnstile'
  • blockImages (bool): Block images for faster rendering (default: true)
  • fetchUrls (array): Additional URLs to fetch (max 10)

Returns: RenderResult object

$client->getAccountBalance(): AccountBalance

Get the current account balance.

Returns: AccountBalance object

Example:

AccountBalance properties:

• $totalBalanceCents (int): Total balance in cents (also equals renders remaining, since 1 cent = 1 render)
• $totalBalanceFormatted (string): Total balance formatted as USD currency (e.g., "$13.00")
• $breakdown (object): Balance breakdown by type
  • $breakdown->paid - Paid balance with cents and formatted properties
  • $breakdown->free - Free balance with cents and formatted properties
  • $breakdown->bonus - Bonus balance with cents and formatted properties

Helper Methods

WaitAction::delay(int $duration): array

Create a delay wait action.

WaitAction::selector(string $selector, string $state = 'visible', int $timeout = 30000): array

Create a selector wait action.

WaitAction::text(string $text, ?string $selector = null, int $timeout = 30000): array

Create a text wait action.

WaitAction::click(string $selector, int $timeout = 30000): array

Create a click wait action.

Supported Countries

AT, BE, CA, CH, CZ, DE, FR, GB, HR, HU, IT, NL, PL, SK, US

See Browser7 Documentation for available cities per country.

CAPTCHA Support

Browser7 supports automatic CAPTCHA detection and solving for:

• reCAPTCHA v2 - Google's image-based CAPTCHA
• reCAPTCHA v3 - Google's score-based CAPTCHA
• Cloudflare Turnstile - Cloudflare's CAPTCHA alternative

Modes:

• 'disabled' (default) - Skip CAPTCHA detection (fastest)
• 'auto' - Auto-detect and solve any CAPTCHA type
• 'recaptcha_v2', 'recaptcha_v3', 'turnstile' - Solve specific type

Contributing

Issues and pull requests are welcome! Please visit our GitHub repository.

License

MIT

Support

• 📧 Email: [email protected]
• 📚 Documentation: https://docs.browser7.com
• 🐛 Issues: https://github.com/browser7data/browser7-php/issues

Links

• Browser7 Website
• API Documentation
• Dashboard
• Pricing