


Building an Async E-Commerce Web Scraper with Pydantic, Crawl & Gemini
In short: This guide demonstrates building an e-commerce scraper using crawl4ai's AI-powered extraction and Pydantic data models. The scraper asynchronously retrieves both product listings (names, prices) and detailed product information (specifications, reviews).
Access the complete code on Google Colab
Tired of the complexities of traditional web scraping for e-commerce data analysis? This tutorial simplifies the process using modern Python tools. We'll leverage crawl4ai for intelligent data extraction and Pydantic for robust data modeling and validation.
Why Choose Crawl4AI and Pydantic?
- crawl4ai: Streamlines web crawling and scraping using AI-driven extraction methods.
- Pydantic: Provides data validation and schema management, ensuring structured and accurate scraped data.
Why Target Tokopedia?
Tokopedia, a major Indonesian e-commerce platform, serves as our example. (Note: The author is Indonesian and a user of the platform, but not affiliated.) The principles apply to other e-commerce sites. This scraping approach is beneficial for developers interested in e-commerce analytics, market research, or automated data collection.
What Sets This Approach Apart?
Instead of relying on complex CSS selectors or XPath, we utilize crawl4ai's LLM-based extraction. This offers:
- Enhanced resilience to website structure changes.
- Cleaner, more structured data output.
- Reduced maintenance overhead.
Setting Up Your Development Environment
Begin by installing necessary packages:
%pip install -U crawl4ai %pip install nest_asyncio %pip install pydantic
For asynchronous code execution in notebooks, we'll also use nest_asyncio
:
import crawl4ai import asyncio import nest_asyncio nest_asyncio.apply()
Defining Data Models with Pydantic
We use Pydantic to define the expected data structure. Here are the models:
from pydantic import BaseModel, Field from typing import List, Optional class TokopediaListingItem(BaseModel): product_name: str = Field(..., description="Product name from listing.") product_url: str = Field(..., description="URL to product detail page.") price: str = Field(None, description="Price displayed in listing.") store_name: str = Field(None, description="Store name from listing.") rating: str = Field(None, description="Rating (1-5 scale) from listing.") image_url: str = Field(None, description="Primary image URL from listing.") class TokopediaProductDetail(BaseModel): product_name: str = Field(..., description="Product name from detail page.") all_images: List[str] = Field(default_factory=list, description="List of all product image URLs.") specs: str = Field(None, description="Technical specifications or short info.") description: str = Field(None, description="Long product description.") variants: List[str] = Field(default_factory=list, description="List of variants or color options.") satisfaction_percentage: Optional[str] = Field(None, description="Customer satisfaction percentage.") total_ratings: Optional[str] = Field(None, description="Total number of ratings.") total_reviews: Optional[str] = Field(None, description="Total number of reviews.") stock: Optional[str] = Field(None, description="Stock availability.")
These models serve as templates, ensuring data validation and providing clear documentation.
The Scraping Process
The scraper operates in two phases:
1. Crawling Product Listings
First, we retrieve search results pages:
async def crawl_tokopedia_listings(query: str = "mouse-wireless", max_pages: int = 1): # ... (Code remains the same) ...
2. Fetching Product Details
Next, for each product URL, we fetch detailed information:
async def crawl_tokopedia_detail(product_url: str): # ... (Code remains the same) ...
Combining the Stages
Finally, we integrate both phases:
async def run_full_scrape(query="mouse-wireless", max_pages=2, limit=15): # ... (Code remains the same) ...
Running the Scraper
Here's how to execute the scraper:
%pip install -U crawl4ai %pip install nest_asyncio %pip install pydantic
Pro Tips
- Rate Limiting: Respect Tokopedia's servers; introduce delays between requests for large-scale scraping.
-
Caching: Enable crawl4ai's caching during development (
cache_mode=CacheMode.ENABLED
). - Error Handling: Implement comprehensive error handling and retry mechanisms for production use.
- API Keys: Store Gemini API keys securely in environment variables, not directly in the code.
Next Steps
This scraper can be extended to:
- Store data in a database.
- Monitor price changes over time.
- Analyze product trends and patterns.
- Compare prices across multiple stores.
Conclusion
crawl4ai's LLM-based extraction significantly improves web scraping maintainability compared to traditional methods. The integration with Pydantic ensures data accuracy and structure.
Always adhere to a website's robots.txt
and terms of service before scraping.
Important Links:
Crawl4AI
- Official Website: https://www.php.cn/link/1026d8c97a822ee171c6cbf939fe4aca
- GitHub Repository: https://www.php.cn/link/62c1b075041300455ec2b54495d93c99
- Documentation: https://www.php.cn/link/1026d8c97a822ee171c6cbf939fe4aca/mkdocs/core/installation/
Pydantic
- Official Documentation: https://www.php.cn/link/a4d4ec4aa3c45731396ed6e65fee40b9
- PyPI Page: https://www.php.cn/link/4d8ab89733dd9a88f1a9d130ca675c2e
- GitHub Repository: https://www.php.cn/link/22935fba49f7d80d5adf1cfa6b0344f4
Note: The complete code is available in the Colab notebook. Feel free to experiment and adapt it to your specific needs.
The above is the detailed content of Building an Async E-Commerce Web Scraper with Pydantic, Crawl & Gemini. For more information, please follow other related articles on the PHP Chinese website!

Hot AI Tools

Undresser.AI Undress
AI-powered app for creating realistic nude photos

AI Clothes Remover
Online AI tool for removing clothes from photos.

Undress AI Tool
Undress images for free

Clothoff.io
AI clothes remover

Video Face Swap
Swap faces in any video effortlessly with our completely free AI face swap tool!

Hot Article

Hot Tools

Notepad++7.3.1
Easy-to-use and free code editor

SublimeText3 Chinese version
Chinese version, very easy to use

Zend Studio 13.0.1
Powerful PHP integrated development environment

Dreamweaver CS6
Visual web development tools

SublimeText3 Mac version
God-level code editing software (SublimeText3)

Hot Topics











Python is suitable for data science, web development and automation tasks, while C is suitable for system programming, game development and embedded systems. Python is known for its simplicity and powerful ecosystem, while C is known for its high performance and underlying control capabilities.

You can learn basic programming concepts and skills of Python within 2 hours. 1. Learn variables and data types, 2. Master control flow (conditional statements and loops), 3. Understand the definition and use of functions, 4. Quickly get started with Python programming through simple examples and code snippets.

Python excels in gaming and GUI development. 1) Game development uses Pygame, providing drawing, audio and other functions, which are suitable for creating 2D games. 2) GUI development can choose Tkinter or PyQt. Tkinter is simple and easy to use, PyQt has rich functions and is suitable for professional development.

Python is easier to learn and use, while C is more powerful but complex. 1. Python syntax is concise and suitable for beginners. Dynamic typing and automatic memory management make it easy to use, but may cause runtime errors. 2.C provides low-level control and advanced features, suitable for high-performance applications, but has a high learning threshold and requires manual memory and type safety management.

You can learn the basics of Python within two hours. 1. Learn variables and data types, 2. Master control structures such as if statements and loops, 3. Understand the definition and use of functions. These will help you start writing simple Python programs.

To maximize the efficiency of learning Python in a limited time, you can use Python's datetime, time, and schedule modules. 1. The datetime module is used to record and plan learning time. 2. The time module helps to set study and rest time. 3. The schedule module automatically arranges weekly learning tasks.

Python is widely used in the fields of web development, data science, machine learning, automation and scripting. 1) In web development, Django and Flask frameworks simplify the development process. 2) In the fields of data science and machine learning, NumPy, Pandas, Scikit-learn and TensorFlow libraries provide strong support. 3) In terms of automation and scripting, Python is suitable for tasks such as automated testing and system management.

Python excels in automation, scripting, and task management. 1) Automation: File backup is realized through standard libraries such as os and shutil. 2) Script writing: Use the psutil library to monitor system resources. 3) Task management: Use the schedule library to schedule tasks. Python's ease of use and rich library support makes it the preferred tool in these areas.
