Skip to content

Commit ae3e74e

Browse files
committed
Auto Zones creation default to True + zone names changed to sdk_ prefix for analytics
1 parent aac4394 commit ae3e74e

File tree

17 files changed

+103
-1439
lines changed

17 files changed

+103
-1439
lines changed

README.md

Lines changed: 47 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -198,6 +198,21 @@ result = client.scrape.amazon.reviews(
198198
result = client.scrape.amazon.sellers(
199199
url="https://amazon.com/sp?seller=AXXXXXXXXX"
200200
)
201+
202+
# NEW: Search Amazon by keyword and filters
203+
result = client.search.amazon.products(
204+
keyword="laptop",
205+
min_price=50000, # $500 in cents
206+
max_price=200000, # $2000 in cents
207+
prime_eligible=True,
208+
condition="new"
209+
)
210+
211+
# Search by category
212+
result = client.search.amazon.products(
213+
keyword="wireless headphones",
214+
category="electronics"
215+
)
201216
```
202217

203218
#### LinkedIn Data
@@ -235,8 +250,8 @@ result = client.search.linkedin.profiles(
235250

236251
result = client.search.linkedin.posts(
237252
profile_url="https://linkedin.com/in/johndoe",
238-
start_date="2024-01-01",
239-
end_date="2024-12-31"
253+
start_date="2025-01-01",
254+
end_date="2025-12-31"
240255
)
241256
```
242257

@@ -264,8 +279,8 @@ result = client.scrape.chatgpt.prompts(
264279
result = client.scrape.facebook.posts_by_profile(
265280
url="https://facebook.com/profile",
266281
num_of_posts=10,
267-
start_date="01-01-2024",
268-
end_date="12-31-2024",
282+
start_date="01-01-2025",
283+
end_date="12-31-2025",
269284
timeout=240
270285
)
271286

@@ -286,8 +301,8 @@ result = client.scrape.facebook.posts_by_url(
286301
result = client.scrape.facebook.comments(
287302
url="https://facebook.com/post/123456",
288303
num_of_comments=100,
289-
start_date="01-01-2024",
290-
end_date="12-31-2024",
304+
start_date="01-01-2025",
305+
end_date="12-31-2025",
291306
timeout=240
292307
)
293308

@@ -330,8 +345,8 @@ result = client.scrape.instagram.reels(
330345
result = client.search.instagram.posts(
331346
url="https://instagram.com/username",
332347
num_of_posts=10,
333-
start_date="01-01-2024",
334-
end_date="12-31-2024",
348+
start_date="01-01-2025",
349+
end_date="12-31-2025",
335350
post_type="reel",
336351
timeout=240
337352
)
@@ -340,8 +355,8 @@ result = client.search.instagram.posts(
340355
result = client.search.instagram.reels(
341356
url="https://instagram.com/username",
342357
num_of_posts=50,
343-
start_date="01-01-2024",
344-
end_date="12-31-2024",
358+
start_date="01-01-2025",
359+
end_date="12-31-2025",
345360
timeout=240
346361
)
347362
```
@@ -403,7 +418,16 @@ asyncio.run(scrape_multiple())
403418

404419
---
405420

406-
## 🆕 What's New in v26.11.24
421+
## 🆕 What's New in v01.12.24
422+
423+
### 🆕 **Latest Updates (December 2025)**
424+
-**Amazon Search API** - NEW parameter-based product discovery
425+
-**LinkedIn Job Search Fixed** - Now builds URLs from keywords internally
426+
-**Trigger Interface** - Manual trigger/poll/fetch control for all platforms
427+
-**Auto-Create Zones** - Now enabled by default (was opt-in)
428+
-**Improved Zone Names** - `sdk_unlocker`, `sdk_serp`, `sdk_browser`
429+
-**26 Sync Wrapper Fixes** - All platform scrapers now work without context managers
430+
-**Zone Manager Tests Fixed** - All 22 tests passing
407431

408432
### 🎓 **For Data Scientists**
409433
-**5 Jupyter Notebooks** - Complete interactive tutorials
@@ -422,17 +446,18 @@ asyncio.run(scrape_multiple())
422446

423447
### 🖥️ **CLI Tool**
424448
-**`brightdata` command** - Use SDK from terminal
425-
-**Scrape operations** - `brightdata scrape amazon products --url ...`
426-
-**Search operations** - `brightdata search linkedin jobs --keyword ...`
449+
-**Scrape operations** - `brightdata scrape amazon products ...`
450+
-**Search operations** - `brightdata search amazon products --keyword ...`
427451
-**Output formats** - JSON, pretty-print, minimal
428452

429453
### 🏗️ **Architecture Improvements**
430454
-**Single AsyncEngine** - Shared across all scrapers (8x efficiency)
431455
-**Resource Optimization** - Reduced memory footprint
432456
-**Enhanced Error Messages** - Clear, actionable error messages
433-
-**502+ Tests** - Comprehensive test coverage
457+
-**500+ Tests Passing** - Comprehensive test coverage (99.4%)
434458

435-
### 🆕 **New Platforms**
459+
### 🆕 **Platforms & Features**
460+
-**Amazon Search** - Keyword-based product discovery
436461
-**Facebook Scraper** - Posts (profile/group/URL), Comments, Reels
437462
-**Instagram Scraper** - Profiles, Posts, Comments, Reels
438463
-**Instagram Search** - Posts and Reels discovery with filters
@@ -456,6 +481,7 @@ client.scrape.instagram.profiles(url="...")
456481
client.scrape.generic.url(url="...")
457482

458483
# Parameter-based discovery (search namespace)
484+
client.search.amazon.products(keyword="...", min_price=..., max_price=...)
459485
client.search.linkedin.jobs(keyword="...", location="...")
460486
client.search.instagram.posts(url="...", num_of_posts=10)
461487
client.search.google(query="...")
@@ -490,11 +516,11 @@ client = BrightDataClient(
490516
token="your_token", # Auto-loads from BRIGHTDATA_API_TOKEN if not provided
491517
customer_id="your_customer_id", # Auto-loads from BRIGHTDATA_CUSTOMER_ID (optional)
492518
timeout=30, # Default timeout in seconds
493-
web_unlocker_zone="sdk_unlocker", # Web Unlocker zone name
494-
serp_zone="sdk_serp", # SERP API zone name
495-
browser_zone="sdk_browser", # Browser API zone name
496-
auto_create_zones=False, # Auto-create missing zones
497-
validate_token=False # Validate token on init
519+
web_unlocker_zone="sdk_unlocker", # Web Unlocker zone name (default)
520+
serp_zone="sdk_serp", # SERP API zone name (default)
521+
browser_zone="sdk_browser", # Browser API zone name (default)
522+
auto_create_zones=True, # Auto-create missing zones (default: True)
523+
validate_token=False # Validate token on init (default: False)
498524
)
499525
```
500526

@@ -639,6 +665,7 @@ brightdata scrape generic \
639665
- `brightdata scrape generic url`
640666

641667
**Search Operations:**
668+
- `brightdata search amazon products`
642669
- `brightdata search linkedin jobs/profiles/posts`
643670
- `brightdata search instagram posts/reels`
644671
- `brightdata search google/bing/yandex`

0 commit comments

Comments
 (0)