# Scraper API

Source: https://docs.evomi.com/scraping-products-instructions/scraper-api/

The Evomi Scraper API is a unified solution for extracting web data at scale. With intelligent mode selection, managed browser rendering, and global proxy integration, it handles everything from simple static pages to complex JavaScript-heavy applications through a single REST API.

## Why Scraper API?

**Intelligent Mode Selection**
Our smart `auto` mode automatically detects whether a page needs JavaScript rendering, optimizing both cost and performance without manual intervention.

**Global Proxy Network**
Route requests through residential or datacenter proxies across 150+ countries. Session management keeps your IP consistent across multi-step workflows.

**Rich Output Formats**
Extract data as HTML, clean Markdown, PDFs or full-page screenshots. Integrate AI enhancement for instant summaries and structured data extraction.

**Built for Scale**
Handle concurrent requests with automatic rate limiting, async processing for long-running tasks, and transparent credit-based pricing.

## Key Features

| Feature | Description |
|---------|-------------|
| **Auto Mode** | Automatically chooses between fast HTTP requests and full browser rendering |
| **Browser Automation** | Execute JavaScript, click buttons, fill forms—all without managing browsers |
| **AI Enhancement** | Built-in AI for content summarization and structured data extraction |
| **Global Proxies** | Residential and datacenter proxies with geo-targeting and session support |
| **Multiple Outputs** | HTML, Markdown, PDFs or PNG screenshots with one parameter |
| **Async Processing** | Background task execution for complex scraping jobs |
| **Resource Blocking** | Speed up requests by blocking images, CSS, and other resources |
| **Network Capture** | Intercept and capture XHR/Fetch API responses during page load |

## Quick Start

Make your first request in seconds:

Your API key is available in the [Evomi Dashboard](https://my.evomi.com/my/products/scraper-api-universal/playground). And you need an active trial, subscription, or pay-as-you-go credits specifically for the Scraper API to access it.

```bash
curl "https://scrape.evomi.com/api/v1/scraper/realtime?url=https://example.com&api_key=YOUR_API_KEY"
```

That's it! The API intelligently handles the rest—choosing the right method, managing proxies, and returning clean content. You can even paste this URL directly into your browser to see the results.

## Base URL

```
https://scrape.evomi.com
```

All API requests use this base URL with the `/api/v1/scraper/` prefix.

## Pricing at a Glance

Transparent, credit-based pricing with no surprises:

| Mode | Proxy Type | Cost per Request |
|------|------------|------------------|
| Request | Datacenter | 1 credit |
| Request | Premium (residential) | 2 credits |
| Browser | Premium (residential) | 5 credits |
| Auto | Premium (request succeeds) | 2 credits |
| Auto | Premium (upgraded to browser) | 6 credits |
| AI Enhancement | - | +30 credits |
| Screenshot | - | +1 credit |
| PDF | - | +1 credit |

**Browser and Auto modes require premium (residential) proxies.** Datacenter proxies can only be used with `mode="request"`.

Auto mode charges only for what it uses. If a simple HTTP request works, you pay 2 credits. If browser rendering is needed, you pay 50% of the request cost plus the full browser cost (6 credits total)—always optimized for value.

## Next Steps

Explore the documentation to unlock the full potential of the Scraper API:

- **[Quickstart](/scraping-products-instructions/scraper-api/quickstart/)** - Make your first request and see results in seconds
- **[Authentication](/scraping-products-instructions/scraper-api/authentication/)** - Secure your API access
- **[Parameters](/scraping-products-instructions/scraper-api/parameters/)** - Comprehensive parameter reference
- **[Usage Examples](/scraping-products-instructions/scraper-api/usage-examples/)** - Code samples in Python, Node.js, and more

Keep your API key secure. Never expose it in client-side code or public repositories. Store it in environment variables and use HTTPS for all requests.

## Pages in this section

- [Output Formats](https://docs.evomi.com/scraping-products-instructions/scraper-api/parameters/output-formats/index.md): Choose HTML, markdown, a screenshot or a PDF with content=, and raw or JSON delivery.
- [Quickstart](https://docs.evomi.com/scraping-products-instructions/scraper-api/quickstart/index.md): Your first Scraper API call is one GET request.
- [AI Creation](https://docs.evomi.com/scraping-products-instructions/scraper-api/scraper-config/ai-creation/index.md): Describe the site and the data you want, and the config generator discovers URLs, inspects pages and returns a tested scraper config.
- [Scraper API Authentication](https://docs.evomi.com/scraping-products-instructions/scraper-api/authentication/index.md): Send your Scraper API key as a query parameter, an x-api-key header or in the JSON body.
- [Storage Providers](https://docs.evomi.com/scraping-products-instructions/scraper-api/cloud-storage/providers/index.md): Setup guides for Amazon S3, Cloudflare R2, DigitalOcean Spaces, Google Cloud Storage, Azure Blob, and other S3-compatible storage providers.
- [Domain Crawling Usage Examples](https://docs.evomi.com/scraping-products-instructions/scraper-api/tools/domain-crawling/usage-examples/index.md): Domain Crawling requests and responses: crawl depth, URL pattern filters, JavaScript rendering, markdown output, AI enhancement and async mode.
- [Search Tool Usage Examples](https://docs.evomi.com/scraping-products-instructions/scraper-api/tools/search/usage-examples/index.md): Search API requests and responses: single and multiple queries, regional results, async handling, and passing the domains you find straight into a scrape.
- [URL Discovery Usage Examples](https://docs.evomi.com/scraping-products-instructions/scraper-api/tools/url-discovery/usage-examples/index.md): Url Discovery requests and responses: sitemap and Common Crawl sources, live validation, pattern filters, async mode for large domains, and a full content audit.
- [Filtering](https://docs.evomi.com/scraping-products-instructions/scraper-api/parameters/filtering/index.md): excludedtags and excludedselectors strip elements before the response is built, which also changes what extraction and the AI step see.
- [Proxy Types](https://docs.evomi.com/scraping-products-instructions/scraper-api/proxy-types/index.md): Residential and datacenter proxies in the Scraper API: what each costs per mode, which modes accept them, country selection, session IDs and custom overrides.
- [Rate Limits](https://docs.evomi.com/scraping-products-instructions/scraper-api/rate-limits/index.md): Scraper API limits are on concurrent requests per key, not requests per second.
- [Webhooks](https://docs.evomi.com/scraping-products-instructions/scraper-api/webhooks/index.md): Get a callback when a scrape, crawl, map, search or schedule finishes instead of polling for it.
- [Error Handling](https://docs.evomi.com/scraping-products-instructions/scraper-api/errors/index.md): The Scraper API's status codes and error payloads, 401, 402, 408, 422, 429 and 500, what causes each, and which ones are worth retrying.
- [Fix](https://docs.evomi.com/scraping-products-instructions/scraper-api/parameters/extraction/schema/fix/index.md): With test and fix both true, the API writes or repairs an extractscheme from your prompt against the live page, and saves it only if it works.
- [Result Polling](https://docs.evomi.com/scraping-products-instructions/scraper-api/result-polling/index.md): How async Scraper API requests work: submit with async=true, poll the task endpoint, and what happens when a synchronous request hits its timeout instead.
- [Scraping Modes](https://docs.evomi.com/scraping-products-instructions/scraper-api/parameters/scraping-modes/index.md): mode=request is a fast HTTP fetch, mode=browser renders JavaScript, and mode=auto decides for you.
- [Test](https://docs.evomi.com/scraping-products-instructions/scraper-api/parameters/extraction/schema/test/index.md): test=true validates an extractscheme against a live URL before it is saved, and shows what each selector actually returned.
- [JS Automation](https://docs.evomi.com/scraping-products-instructions/scraper-api/parameters/javascript-automation/index.md): jsinstructions clicks, fills and waits on a page before it is captured.
- [Network Capture](https://docs.evomi.com/scraping-products-instructions/scraper-api/parameters/network-capture/index.md): Capture the XHR and fetch responses a page makes while it loads, filtered by resource type, URL, status, content type, method or header.
- [AI Enhancement](https://docs.evomi.com/scraping-products-instructions/scraper-api/parameters/ai-enhancement/index.md): aienhance runs a model over the page's markdown or a screenshot to summarise it or return structured data, for an additional 30 credits per request.
- [Proxy Configuation](https://docs.evomi.com/scraping-products-instructions/scraper-api/parameters/proxy/index.md): The Scraper API's proxy parameters, proxytype, proxycountry, proxysessionid and proxyoverwrite, and how residential and datacenter differ in cost and mode support.
- [Scraper API Usage Examples](https://docs.evomi.com/scraping-products-instructions/scraper-api/usage-examples/index.md): Working Scraper API code in Python and Node.js: basic requests, JSON metadata, screenshots, markdown, JS automation, AI enhancement, async polling and retries.
- [Scraper API Parameter Usage Examples](https://docs.evomi.com/scraping-products-instructions/scraper-api/parameters/usage-examples/index.md): Scraper API requests with their credit cost attached, from a one-credit datacenter fetch to browser screenshots, PDFs and AI extraction.