Skip to main content
Legacy v1 service. Use Extract instead — it is the canonical v2 API and the equivalent MCP tool. This page is kept for reference.
SmartScraper Service

Overview

SmartScraper is our flagship LLM-powered web scraping service that intelligently extracts structured data from any website. Using advanced LLM models, it understands context and content like a human would, making web data extraction more reliable and efficient than ever.
Try SmartScraper instantly in our interactive playground

Getting Started

Quick Start

Parameters

Get your API key from the dashboard
The response includes:
  • request_id: Unique identifier for tracking your request
  • status: Current status of the extraction (“completed”, “running”, “failed”)
  • result: The extracted data in structured JSON format
  • error: Error message (if any occurred during extraction)
Instead of providing a URL, you can optionally pass your own HTML content:
This is useful when:
  • You already have the HTML content cached
  • You want to process modified HTML
  • You’re working with dynamically generated content
  • You need to process content offline
  • You want to pre-process the HTML before extraction
You must provide exactly one of: website_url, website_html, or website_markdown. Providing multiple will result in an error.
You can also pass your own Markdown content directly for extraction:
This is useful when:
  • You already have Markdown content from another source
  • You’re processing documentation or README files
  • You want to extract structured data from Markdown
  • You’re working with content that’s already in Markdown format
  • You need to process content offline
  • Maximum content size: 2MB
  • You must provide exactly one of: website_url, website_html, or website_markdown
  • Parameters like number_of_scrolls, total_pages, and stealth are not applicable when using Markdown content

Key Features

Universal Compatibility

Works with any website structure, including JavaScript-rendered content

AI Understanding

Contextual understanding of content for accurate extraction

Structured Output

Returns clean, structured data in your preferred format

Schema Support

Define custom output schemas using Pydantic or Zod

Use Cases

Content Aggregation

  • News article extraction
  • Blog post summarization
  • Product information gathering
  • Research data collection

Data Analysis

  • Market research
  • Competitor analysis
  • Price monitoring
  • Trend tracking

AI Training

  • Dataset creation
  • Training data collection
  • Content classification
  • Knowledge base building
Want to learn more about our AI-powered scraping technology? Visit our main website to discover how we’re revolutionizing web data extraction.

Other Functionality

Retrieve a previous request

If you know the response id of a previous request you made, you can retrieve all the information.

Parameters

Custom Schema Example

Define exactly what data you want to extract:

Async Support

For applications requiring asynchronous execution, SmartScraper provides comprehensive async support through the AsyncClient:

Infinite Scroll Support

SmartScraper can handle infinite scroll pages by automatically scrolling to load more content before extraction. This is perfect for social media feeds, e-commerce product listings, and other dynamic content.

Parameters for Infinite Scroll

Infinite scroll is particularly useful for:
  • Social media feeds (Twitter, Instagram, LinkedIn)
  • E-commerce product listings
  • News websites with continuous scrolling
  • Any page that loads content dynamically as you scroll

SmartScraper Endpoint

The SmartScraper endpoint is our core service for extracting structured data from any webpage using advanced language models. It automatically adapts to different website layouts and content types, enabling quick and reliable data extraction.

Key Capabilities

  • Universal Compatibility: Works with any website structure, including JavaScript-rendered content
  • Schema Validation: Supports both Pydantic (Python) and Zod (JavaScript) schemas
  • Concurrent Processing: Efficient handling of multiple URLs through async support
  • Custom Extraction: Flexible user prompts for targeted data extraction

Endpoint Details

Required Headers
Request Body
Response Format

Best Practices

  1. Schema Definition:
    • Define schemas to ensure consistent data structure
    • Use descriptive field names and types
    • Include field descriptions for better extraction accuracy
  2. Async Processing:
    • Use async clients for concurrent requests
    • Implement proper error handling
    • Monitor rate limits and implement backoff strategies
  3. Error Handling:
    • Always wrap requests in try-catch blocks
    • Check response status before processing
    • Implement retry logic for failed requests

Integration Options

Official SDKs

  • Python SDK - Perfect for data science and backend applications
  • JavaScript SDK - Ideal for web applications and Node.js

AI Framework Integrations

Best Practices

Optimizing Extraction

  1. Be specific in your prompts
  2. Use schemas for structured data
  3. Handle pagination for multi-page content
  4. Implement error handling and retries

Rate Limiting

  • Implement reasonable delays between requests
  • Use async clients for better performance
  • Monitor your API usage

Example Projects

Check out our cookbook for real-world examples:
  • E-commerce product scraping
  • News aggregation
  • Research data collection
  • Content monitoring

API Reference

For detailed API documentation, see:

Support & Resources

Documentation

Comprehensive guides and tutorials

API Reference

Detailed API documentation

Community

Join our Discord community

GitHub

Check out our open-source projects

Ready to Start?

Sign up now and get your API key to begin extracting data with SmartScraper!