> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spidra.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Stealth Mode

> Route requests through residential proxies

Stealth Mode routes your scrape and crawl requests through a network of residential proxies, making them appear to come from real users in real locations. Use it when a site blocks direct requests, requires a specific country IP, or shows different content based on location.

## When to Use It

* The target site returns CAPTCHA pages or blocks automated requests
* You need to see prices, content, or search results from a specific country
* The site detects and blocks datacenter IPs
* You're scraping a site that uses bot-protection services like Cloudflare or Akamai

## How to Enable It

### In the Playground

Toggle **Stealth Mode** in the Advanced Configuration section. Once enabled, a country selector appears — pick a specific country, choose **Europe Mix** to rotate across EU member states, or leave it on **Worldwide** for no preference.

### Via API

Add `"useProxy": true` to any scrape or crawl request. Optionally add `"proxyCountry"` to target a specific location.

```json theme={null}
{
  "urls": [{"url": "https://amazon.de/dp/B123456"}],
  "prompt": "Extract the product price in euros",
  "output": "json",
  "useProxy": true,
  "proxyCountry": "de"
}
```

## Country Targeting

Pass `"proxyCountry"` with any of the values below.

Omitting `proxyCountry` (or setting it to `"global"`) lets Spidra pick the best available exit node with no location preference.

Setting it to `"eu"` rotates randomly across all 27 EU member states on each request — useful when you need a European IP but don't care which specific country.

For a specific country, use its two-letter ISO code:

<Accordion title="View all 50 supported countries">
  | Code | Country        | Code | Country        | Code | Country      |
  | ---- | -------------- | ---- | -------------- | ---- | ------------ |
  | `us` | United States  | `de` | Germany        | `jp` | Japan        |
  | `gb` | United Kingdom | `fr` | France         | `au` | Australia    |
  | `ca` | Canada         | `br` | Brazil         | `in` | India        |
  | `nl` | Netherlands    | `sg` | Singapore      | `es` | Spain        |
  | `it` | Italy          | `mx` | Mexico         | `za` | South Africa |
  | `ng` | Nigeria        | `ar` | Argentina      | `be` | Belgium      |
  | `ch` | Switzerland    | `cl` | Chile          | `cn` | China        |
  | `co` | Colombia       | `cz` | Czech Republic | `dk` | Denmark      |
  | `eg` | Egypt          | `fi` | Finland        | `gr` | Greece       |
  | `hk` | Hong Kong      | `hu` | Hungary        | `id` | Indonesia    |
  | `ie` | Ireland        | `il` | Israel         | `kr` | South Korea  |
  | `my` | Malaysia       | `no` | Norway         | `nz` | New Zealand  |
  | `pe` | Peru           | `ph` | Philippines    | `pl` | Poland       |
  | `pt` | Portugal       | `ro` | Romania        | `sa` | Saudi Arabia |
  | `se` | Sweden         | `th` | Thailand       | `tr` | Turkey       |
  | `tw` | Taiwan         | `ua` | Ukraine        | `vn` | Vietnam      |
</Accordion>

## Examples

### Scraping geo-restricted content

```json theme={null}
{
  "urls": [{"url": "https://example.com/pricing"}],
  "prompt": "Extract the pricing tiers and amounts",
  "output": "json",
  "useProxy": true,
  "proxyCountry": "us"
}
```

### Crawling with a European IP

```json theme={null}
{
  "baseUrl": "https://example.eu/products",
  "crawlInstruction": "Find all product pages",
  "transformInstruction": "Extract product name and price in EUR",
  "maxPages": 10,
  "useProxy": true,
  "proxyCountry": "eu"
}
```

### No country preference

```json theme={null}
{
  "urls": [{"url": "https://example.com"}],
  "prompt": "Extract the main content",
  "output": "json",
  "useProxy": true
}
```

## Billing

Stealth Mode is billed against your **bandwidth quota**, not your credit balance. Each request routed through the proxy network consumes bandwidth (measured in MB) based on the size of the pages fetched. There is no extra per-URL credit charge for enabling `useProxy`.

Monthly bandwidth included per plan:

| Plan    | Included bandwidth |
| ------- | ------------------ |
| Free    | 50 MB              |
| Starter | 500 MB             |
| Builder | 2 GB               |
| Pro     | 5 GB               |

If you run out of bandwidth mid-cycle, proxy requests are paused until your quota renews or you purchase a top-up. You can monitor your bandwidth usage from the **Usage** page in the dashboard.

<CardGroup cols={3}>
  <Card title="Submit a Scrape Job" icon="paper-plane" href="/api-reference/scraping/scrape">
    Scrape API reference
  </Card>

  <Card title="Submit a Crawl Job" icon="spider" href="/api-reference/crawling/crawl">
    Crawl API reference
  </Card>

  <Card title="Proxy Top-up" icon="circle-plus" href="/billing/proxy-topup">
    Buy more bandwidth
  </Card>
</CardGroup>