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

> ## Agent Instructions
> The Zenrows HTTP API serves Fetch and Extract (extract=auto) at https://api.zenrows.com/v1/, Crawl at https://api.zenrows.com/v1/crawls, and Batch at https://async.api.zenrows.com/v1. Fetch, Extract, Crawl and Batch are described in OpenAPI 3.1 at https://www.zenrows.com/openapi.json and listed in the RFC 9727 API catalog at https://www.zenrows.com/.well-known/api-catalog. Every endpoint also has its own page under /api-reference with its schema. Use the spec for exact parameter names and types. Crawl's endpoints, parameters and errors are also at https://docs.zenrows.com/crawl/endpoints.md. To call Zenrows from an agent, connect the MCP server at https://mcp.zenrows.com/mcp. To search these docs from an agent, connect the docs MCP server at https://docs.zenrows.com/mcp. Agent skills for Zenrows are published at https://github.com/ZenRows/cli and install with `npx skills add ZenRows/cli`.

# Get content as seen from any country

> See prices, search results and pages exactly as visitors in any country see them, with Zenrows Fetch.

Add `proxy_country` to a Fetch request and the target sees a visitor from that country. Use it for localized prices, currencies, search results, shipping options and anything a site changes by location.

**Uses:** [Fetch](https://docs.zenrows.com/fetch/api-reference.md) with [`proxy_country`](https://docs.zenrows.com/fetch/features/proxy-country), [`premium_proxy`](https://docs.zenrows.com/fetch/features/premium-proxy) and [Adaptive Stealth Mode](https://docs.zenrows.com/fetch/features/adaptive-stealth-mode.md) (`mode=auto`)

## Ask your AI agent

With the [Zenrows MCP server](https://docs.zenrows.com/mcp/overview.md) connected to Claude, Cursor or any MCP client, paste this prompt. Your agent picks the right Zenrows tools and settings on its own.

```text theme={"theme":"css-variables"}
Use Zenrows to read https://api.country.is/ three times, as a visitor from the US, the UK
and Germany, and show me the IP and country each request came from.
```

## Fetch a page from one country

With `mode=auto`, send `proxy_country` with a two-letter ISO code. Zenrows routes the request through that country and adds JavaScript rendering when the page needs it. This example calls `https://api.country.is/`, which answers with the caller's IP and country, so you can see where the request came from.

```python Python (Requests) theme={"theme":"css-variables"}
import requests

params = {
    "apikey": "YOUR_ZENROWS_API_KEY",
    "url": "https://api.country.is/",
    "mode": "auto",
    "proxy_country": "de",
}

response = requests.get("https://api.zenrows.com/v1/", params=params, timeout=180)
response.raise_for_status()
print(response.json())
```

```bash CLI theme={"theme":"css-variables"}
zenrows fetch https://api.country.is/ --proxy-country de
```

The CLI runs in `mode=auto` by default, so `--proxy-country` is all it needs.

## Example output

```text theme={"theme":"css-variables"}
{'ip': '92.206.191.237', 'country': 'DE'}
```

## Set the proxy yourself with premium\_proxy

To control the configuration, set `premium_proxy=true` with `proxy_country`. The request goes out through a residential IP in that country:

```python Python (Requests) theme={"theme":"css-variables"}
import requests

params = {
    "apikey": "YOUR_ZENROWS_API_KEY",
    "url": "https://api.country.is/",
    "premium_proxy": "true",
    "proxy_country": "de",
}

response = requests.get("https://api.zenrows.com/v1/", params=params, timeout=180)
response.raise_for_status()

info = response.json()
print(info["ip"], info["country"])
print("Credits billed:", response.headers["X-Request-Credits"])
```

```javascript Node.js theme={"theme":"css-variables"}
const params = new URLSearchParams({
  apikey: "YOUR_ZENROWS_API_KEY",
  url: "https://api.country.is/",
  premium_proxy: "true",
  proxy_country: "de",
});

const response = await fetch(`https://api.zenrows.com/v1/?${params}`, {
  signal: AbortSignal.timeout(180_000),
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);

const info = await response.json();
console.log(info.ip, info.country);
console.log("Credits billed:", response.headers.get("X-Request-Credits"));
```

```bash cURL theme={"theme":"css-variables"}
curl "https://api.zenrows.com/v1/?apikey=YOUR_ZENROWS_API_KEY&url=https%3A%2F%2Fapi.country.is%2F&premium_proxy=true&proxy_country=de"
```

Output:

```text theme={"theme":"css-variables"}
87.122.37.191 DE
Credits billed: 10
```

In the CLI's manual mode, pair `--proxy-country` with `--premium-proxy`.

## Compare the same page across countries

Loop over country codes and keep each result next to its country. Swap the URL for a product, search or pricing page and parse the field you want to compare, for example the price and its currency.

```python Python (Requests) theme={"theme":"css-variables"}
import requests

URL = "https://api.country.is/"
COUNTRIES = ["us", "gb", "de"]

results = {}
for country in COUNTRIES:
    params = {
        "apikey": "YOUR_ZENROWS_API_KEY",
        "url": URL,
        "mode": "auto",
        "proxy_country": country,
    }
    response = requests.get("https://api.zenrows.com/v1/", params=params, timeout=180)
    if response.ok:
        results[country] = response.json()
    else:
        results[country] = f"error {response.status_code}"

for country, data in results.items():
    print(country, "->", data)
```

Output:

```text theme={"theme":"css-variables"}
us -> {'ip': '95.135.207.229', 'country': 'US'}
gb -> {'ip': '83.106.188.96', 'country': 'GB'}
de -> {'ip': '91.8.170.118', 'country': 'DE'}
```

To check many countries or many pages at once, run the requests in parallel, see [Run many requests concurrently](https://docs.zenrows.com/academy/fetch/concurrent-requests.md).

## Customize it

| Change | How |
| - | - |
| A different country | Any ISO 3166-1 alpha-2 code, such as `us`, `gb`, `fr`, `es`, `jp`, `au`, see [Proxy country](https://docs.zenrows.com/fetch/features/proxy-country.md) |
| Same country and IP across several requests | Add `session_id`, see [Keep the same IP and submit forms](https://docs.zenrows.com/academy/fetch/sessions-and-forms.md) |
| Language or currency set by a cookie | Send the cookie with `custom_headers=true`, see [Custom headers](https://docs.zenrows.com/fetch/features/headers.md#language-localization-and-currency) |
| A page that renders with JavaScript | Use `mode=auto`, or `js_render=true` with `premium_proxy=true` |
| A real browser in a country | Use the Zenrows Browser with its [country option](https://docs.zenrows.com/browser-sessions/features/country.md) |

## Troubleshooting

* **`400` when you set `proxy_country`**: on a manual configuration it rides on premium proxies. Add `premium_proxy=true`, or switch to `mode=auto`.
* **The page still shows another country's content**: the site also reads a cookie or the URL path for locale. Set the site's locale cookie with `custom_headers=true`, or request the country-specific URL.
* **An IP lookup service reports a neighboring country**: lookup databases disagree for some IP ranges. Check the content of the target page itself, which is what the site serves to that country.

## Related recipes

> [card] [Keep the same IP and submit forms](https://docs.zenrows.com/academy/fetch/sessions-and-forms.md)
>
> Pin one IP across requests and send POST bodies.

> [card] [Run many requests concurrently](https://docs.zenrows.com/academy/fetch/concurrent-requests.md)
>
> Check many countries or pages in parallel.

> [card] [Scrape pages protected by anti-bot systems](https://docs.zenrows.com/academy/fetch/protected-sites.md)
>
> Combine geotargeting with Adaptive Stealth Mode.

> [card] [E-commerce: products, prices and reviews](https://docs.zenrows.com/academy/use-cases/ecommerce.md)
>
> Track prices and availability across markets.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.