brightdata-sdk

What it is and what it does

Brightdata-sdk is the official Python client for Bright Data's web data APIs. It is async-native (with a sync fallback) and wraps multiple services: web scraping with bot detection bypass, SERP queries across Google/Bing/Yandex, cloud-hosted browser automation via Chrome DevTools Protocol, AI-ranked web discovery, custom Scraper Studio jobs, and access to pre-built datasets. The SDK handles authentication via environment variables or stored CLI credentials, supports both blocking and polling-based async workflows, and includes ready-made scrapers for popular sites like Amazon, LinkedIn, Instagram, and others.

The package is designed for developers who need to collect structured web data at scale—whether that's product information, search results, social media content, or custom-scraped pages. Its async-first design makes it suitable for batch operations and background processing. Dependencies are standard (aiohttp, requests, pydantic, click, aiolimiter) and the library requires Python 3.9 or later.

Use it for:

• Batch scrape product listings from e-commerce sites with automatic bot detection bypass.
• Retrieve parsed search results from Google, Bing, or Yandex in a single async call.
• Automate browser-driven workflows (login, JS rendering, clicks) via cloud Chrome instances.
• Run custom data collection jobs built in Bright Data's Scraper Studio and poll for results.
• Query AI-ranked web search results filtered by natural-language intent for research.
• Access pre-built datasets (100+) for social media, e-commerce, and other platforms.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Official Python SDK for Bright Data APIs, providing async-first access to web scraping, SERP search, browser automation, and 100+ ready-made datasets with built-in bot detection bypass.

Yes, if you need web scraping or SERP data at scale. The SDK is actively maintained, has no known vulnerabilities, low install friction, and permissive licensing. It's production-ready for developers already using or evaluating Bright Data's services. Not suitable if you need a lightweight, free scraper—this is a commercial API client.

Install

brightdata-sdk on PyPI

pip install brightdata-sdk

uv add brightdata-sdk

poetry add brightdata-sdk

Installing brightdata-sdk

Before you install

Low install friction with a pure-Python wheel. Active maintenance—released 2 days ago with a commit history through 2026-08-12. Depends on 8 common runtime libraries (aiohttp, requests, pydantic, click, etc.), all widely maintained.

License in practice

MIT license (permissive). You can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart

pip install brightdata-sdk

import asyncio
from brightdata import BrightDataClient

async def main():
    async with BrightDataClient() as client:
        result = await client.scrape_url("https://example.com")
        print(result.data)

asyncio.run(main())

Requires Python >=3.9. API token from Bright Data Control Panel (can be set via BRIGHTDATA_API_TOKEN env var or CLI credentials).

Verify before relying

• Whether the 100+ datasets claim is current and what categories they cover.
• Rate limits and quota behavior for concurrent requests across different API endpoints.
• Exact timeout and retry behavior in async mode under network failures.

Package facts

Evidence: brightdata_sdk-2.5.2-py3-none-any.whl

Tags

More WWW/HTTP packages