---
id: brightdata-sdk
version: "2.5.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# brightdata-sdk — Modern async-first Python SDK for Bright Data APIs

License: permissive · Maintenance: active · Downloads: 115.3K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 115.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

web scraping SDK, SERP search API client, async web scraper, bot detection bypass, Bright Data API, web data collection, browser automation cloud, web-scraping, async-first, data-collection

[View on SkillFed](https://skillfed.io/packages/brightdata-sdk) · [View on PyPI](https://pypi.org/project/brightdata-sdk/)