# Residential proxies in 199+ countries | Spider

Route any request through residential proxy IPs in 199+ countries. Pay-as-you-go proxy aggregator with automatic rotation.

Canonical: https://spider.cloud/proxy-locations/

Point your HTTP client at proxy.spider.cloud and each request leaves from a residential IP address in the country you choose.

Connection

```
curl -x "http://YOUR_API_KEY:country_code=us@proxy.spider.cloud:8888" \  https://example.com
```

Your API key is the user name, and the country code goes in the password. [Proxy docs](https://spider.cloud/docs/api/proxy/)

Proxy mode from $1 per GB.

[Get an API key](https://spider.cloud/register/)

A dot map of the world. Each dot is shaded by how much residential coverage that country has.

## Routing that cuts slow exits.

- Health checked

  Spider probes every proxy pool around the clock. A failing pool leaves rotation and comes back when it recovers.

- Stalled exits replaced

  If an exit sends no first byte, the tunnel dials a fresh one and replays your request.

## Featured countries.

- [North America United States country_code us](/proxy-locations/united-states/)
- [Europe United Kingdom country_code gb](/proxy-locations/united-kingdom/)
- [South America Brazil country_code br](/proxy-locations/brazil/)
- [Europe Germany country_code de](/proxy-locations/germany/)
- [Asia Japan country_code jp](/proxy-locations/japan/)
- [North America Canada country_code ca](/proxy-locations/canada/)
- [Europe France country_code fr](/proxy-locations/france/)
- [Oceania Australia country_code au](/proxy-locations/australia/)

## All 199+ countries.

Search for a country

### North America

[US United States ](/proxy-locations/united-states/)[CA Canada ](/proxy-locations/canada/)[MX Mexico ](/proxy-locations/mexico/)[HN Honduras ](/proxy-locations/honduras/)[DO Dominican Republic ](/proxy-locations/dominican-republic/)[PA Panama ](/proxy-locations/panama/)[GT Guatemala ](/proxy-locations/guatemala/)[SV El Salvador ](/proxy-locations/el-salvador/)[JM Jamaica ](/proxy-locations/jamaica/)[TT Trinidad And Tobago ](/proxy-locations/trinidad-and-tobago/)[CR Costa Rica ](/proxy-locations/costa-rica/)[BB Barbados ](/proxy-locations/barbados/)[CU Cuba ](/proxy-locations/cuba/)[NI Nicaragua ](/proxy-locations/nicaragua/)[BS Bahamas ](/proxy-locations/bahamas/)[AG Antigua And Barbuda ](/proxy-locations/antigua-and-barbuda/)[HT Haiti ](/proxy-locations/haiti/)[KY Cayman Islands ](/proxy-locations/cayman-islands/)[BZ Belize ](/proxy-locations/belize/)[DM Dominica ](/proxy-locations/dominica/)[CW Curaçao ](/proxy-locations/curacao/)[VG Virgin Islands, British ](/proxy-locations/virgin-islands-british/)[LC Saint Lucia ](/proxy-locations/saint-lucia/)[GD Grenada ](/proxy-locations/grenada/)[GP Guadeloupe ](/proxy-locations/guadeloupe/)[VC Saint Vincent And The Grenadines ](/proxy-locations/saint-vincent-and-the-grenadines/)[TC Turks And Caicos Islands ](/proxy-locations/turks-and-caicos-islands/)[SX Sint Maarten (dutch Part) ](/proxy-locations/sint-maarten-dutch-part/)[VI Virgin Islands, U.s. ](/proxy-locations/virgin-islands-u-s/)[KN Saint Kitts And Nevis ](/proxy-locations/saint-kitts-and-nevis/)[MQ Martinique ](/proxy-locations/martinique/)[GL Greenland ](/proxy-locations/greenland/)[MS Montserrat](/proxy-locations/montserrat/)

### Europe

[GB United Kingdom ](/proxy-locations/united-kingdom/)[DE Germany ](/proxy-locations/germany/)[FR France ](/proxy-locations/france/)[RU Russia ](/proxy-locations/russia/)[ES Spain ](/proxy-locations/spain/)[IT Italy ](/proxy-locations/italy/)[UA Ukraine ](/proxy-locations/ukraine/)[PL Poland ](/proxy-locations/poland/)[GR Greece ](/proxy-locations/greece/)[BE Belgium ](/proxy-locations/belgium/)[NL Netherlands ](/proxy-locations/netherlands/)[PT Portugal ](/proxy-locations/portugal/)[IE Ireland ](/proxy-locations/ireland/)[RO Romania ](/proxy-locations/romania/)[CZ Czech Republic ](/proxy-locations/czech-republic/)[CH Switzerland ](/proxy-locations/switzerland/)[FI Finland ](/proxy-locations/finland/)[HU Hungary ](/proxy-locations/hungary/)[NO Norway ](/proxy-locations/norway/)[LT Lithuania ](/proxy-locations/lithuania/)[HR Croatia ](/proxy-locations/croatia/)[DK Denmark ](/proxy-locations/denmark/)[RS Serbia ](/proxy-locations/serbia/)[LV Latvia ](/proxy-locations/latvia/)[AT Austria ](/proxy-locations/austria/)[BG Bulgaria ](/proxy-locations/bulgaria/)[SE Sweden ](/proxy-locations/sweden/)[EE Estonia ](/proxy-locations/estonia/)[SK Slovakia ](/proxy-locations/slovakia/)[BA Bosnia And Herzegovina ](/proxy-locations/bosnia-and-herzegovina/)[BY Belarus ](/proxy-locations/belarus/)[AL Albania ](/proxy-locations/albania/)[SI Slovenia ](/proxy-locations/slovenia/)[CY Cyprus ](/proxy-locations/cyprus/)[MD Moldova ](/proxy-locations/moldova/)[MT Malta ](/proxy-locations/malta/)[LU Luxembourg ](/proxy-locations/luxembourg/)[ME Montenegro ](/proxy-locations/montenegro/)[IS Iceland ](/proxy-locations/iceland/)[IM Isle Of Man ](/proxy-locations/isle-of-man/)[JE Jersey ](/proxy-locations/jersey/)[GI Gibraltar ](/proxy-locations/gibraltar/)[SM San Marino ](/proxy-locations/san-marino/)[MC Monaco ](/proxy-locations/monaco/)[LI Liechtenstein](/proxy-locations/liechtenstein/)

### Asia

[JP Japan ](/proxy-locations/japan/)[IN India ](/proxy-locations/india/)[KR Korea ](/proxy-locations/korea/)[MY Malaysia ](/proxy-locations/malaysia/)[ID Indonesia ](/proxy-locations/indonesia/)[VN Vietnam ](/proxy-locations/vietnam/)[TR Turkey ](/proxy-locations/turkey/)[SA Saudi Arabia ](/proxy-locations/saudi-arabia/)[TH Thailand ](/proxy-locations/thailand/)[PK Pakistan ](/proxy-locations/pakistan/)[PH Philippines ](/proxy-locations/philippines/)[CN China ](/proxy-locations/china/)[IR Iran ](/proxy-locations/iran/)[TW Taiwan ](/proxy-locations/taiwan/)[IL Israel ](/proxy-locations/israel/)[AE United Arab Emirates ](/proxy-locations/united-arab-emirates/)[IQ Iraq ](/proxy-locations/iraq/)[KZ Kazakhstan ](/proxy-locations/kazakhstan/)[SY Syria ](/proxy-locations/syria/)[JO Jordan ](/proxy-locations/jordan/)[BD Bangladesh ](/proxy-locations/bangladesh/)[YE Yemen ](/proxy-locations/yemen/)[AZ Azerbaijan ](/proxy-locations/azerbaijan/)[KW Kuwait ](/proxy-locations/kuwait/)[OM Oman ](/proxy-locations/oman/)[UZ Uzbekistan ](/proxy-locations/uzbekistan/)[LK Sri Lanka ](/proxy-locations/sri-lanka/)[HK Hong Kong ](/proxy-locations/hong-kong/)[SG Singapore ](/proxy-locations/singapore/)[LB Lebanon ](/proxy-locations/lebanon/)[NP Nepal ](/proxy-locations/nepal/)[PS Palestine ](/proxy-locations/palestine/)[MM Myanmar ](/proxy-locations/myanmar/)[KG Kyrgyzstan ](/proxy-locations/kyrgyzstan/)[KH Cambodia ](/proxy-locations/cambodia/)[AM Armenia ](/proxy-locations/armenia/)[BH Bahrain ](/proxy-locations/bahrain/)[QA Qatar ](/proxy-locations/qatar/)[MN Mongolia ](/proxy-locations/mongolia/)[AF Afghanistan ](/proxy-locations/afghanistan/)[LA Laos ](/proxy-locations/laos/)[TJ Tajikistan ](/proxy-locations/tajikistan/)[GE Georgia ](/proxy-locations/georgia/)[MV Maldives ](/proxy-locations/maldives/)[MO Macao ](/proxy-locations/macao/)[TL Timor-leste ](/proxy-locations/timor-leste/)[BN Brunei ](/proxy-locations/brunei/)[TM Turkmenistan ](/proxy-locations/turkmenistan/)[BT Bhutan](/proxy-locations/bhutan/)

### South America

[BR Brazil ](/proxy-locations/brazil/)[AR Argentina ](/proxy-locations/argentina/)[CO Colombia ](/proxy-locations/colombia/)[VE Venezuela ](/proxy-locations/venezuela/)[CL Chile ](/proxy-locations/chile/)[PE Peru ](/proxy-locations/peru/)[EC Ecuador ](/proxy-locations/ecuador/)[UY Uruguay ](/proxy-locations/uruguay/)[BO Bolivia ](/proxy-locations/bolivia/)[PY Paraguay ](/proxy-locations/paraguay/)[GY Guyana ](/proxy-locations/guyana/)[SR Suriname ](/proxy-locations/suriname/)[GF French Guiana](/proxy-locations/french-guiana/)

### Africa

[EG Egypt ](/proxy-locations/egypt/)[ZA South Africa ](/proxy-locations/south-africa/)[DZ Algeria ](/proxy-locations/algeria/)[MA Morocco ](/proxy-locations/morocco/)[TN Tunisia ](/proxy-locations/tunisia/)[KE Kenya ](/proxy-locations/kenya/)[NG Nigeria ](/proxy-locations/nigeria/)[MU Mauritius ](/proxy-locations/mauritius/)[ET Ethiopia ](/proxy-locations/ethiopia/)[LY Libya ](/proxy-locations/libya/)[GH Ghana ](/proxy-locations/ghana/)[SD Sudan ](/proxy-locations/sudan/)[TZ Tanzania ](/proxy-locations/tanzania/)[CI Ivory Coast ](/proxy-locations/ivory-coast/)[GA Gabon ](/proxy-locations/gabon/)[SN Senegal ](/proxy-locations/senegal/)[CD Democratic Republic Of The Congo ](/proxy-locations/democratic-republic-of-the-congo/)[UG Uganda ](/proxy-locations/uganda/)[ML Mali ](/proxy-locations/mali/)[BF Burkina Faso ](/proxy-locations/burkina-faso/)[MG Madagascar ](/proxy-locations/madagascar/)[ZM Zambia ](/proxy-locations/zambia/)[CM Cameroon ](/proxy-locations/cameroon/)[MZ Mozambique ](/proxy-locations/mozambique/)[BJ Benin ](/proxy-locations/benin/)[AO Angola ](/proxy-locations/angola/)[MR Mauritania ](/proxy-locations/mauritania/)[TG Togo ](/proxy-locations/togo/)[ZW Zimbabwe ](/proxy-locations/zimbabwe/)[SO Somalia ](/proxy-locations/somalia/)[MW Malawi ](/proxy-locations/malawi/)[CG Congo ](/proxy-locations/congo/)[RE Réunion ](/proxy-locations/reunion/)[RW Rwanda ](/proxy-locations/rwanda/)[NA Namibia ](/proxy-locations/namibia/)[SL Sierra Leone ](/proxy-locations/sierra-leone/)[BW Botswana ](/proxy-locations/botswana/)[GN Guinea ](/proxy-locations/guinea/)[NE Niger ](/proxy-locations/niger/)[GM Gambia ](/proxy-locations/gambia/)[CV Cape Verde ](/proxy-locations/cape-verde/)[TD Chad ](/proxy-locations/chad/)[SZ Swaziland ](/proxy-locations/swaziland/)[LR Liberia ](/proxy-locations/liberia/)[LS Lesotho ](/proxy-locations/lesotho/)[SC Seychelles ](/proxy-locations/seychelles/)[BI Burundi ](/proxy-locations/burundi/)[SS South Sudan ](/proxy-locations/south-sudan/)[ST Sao Tome And Principe ](/proxy-locations/sao-tome-and-principe/)[GW Guinea-bissau ](/proxy-locations/guinea-bissau/)[GQ Equatorial Guinea ](/proxy-locations/equatorial-guinea/)[KM Comoros](/proxy-locations/comoros/)

### Oceania

[AU Australia ](/proxy-locations/australia/)[NZ New Zealand ](/proxy-locations/new-zealand/)[FJ Fiji ](/proxy-locations/fiji/)[PF French Polynesia ](/proxy-locations/french-polynesia/)[GU Guam ](/proxy-locations/guam/)[PG Papua New Guinea ](/proxy-locations/papua-new-guinea/)[NC New Caledonia](/proxy-locations/new-caledonia/)

No country matches that search.

## Route through any country.

Call the Scrape API, or point the client you already use at the proxy endpoint. One API key works for both.

```
curl -X POST https://api.spider.cloud/scrape \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "country_code": "us",
    "return_format": "markdown"
  }'
```

```
import requests

resp = requests.post(
    "https://api.spider.cloud/scrape",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "url": "https://example.com",
        "country_code": "us",
        "return_format": "markdown",
    },
)
print(resp.json())
```

```
const resp = await fetch("https://api.spider.cloud/scrape", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://example.com",
    country_code: "us",
    return_format: "markdown",
  }),
});
const data = await resp.json();
console.log(data);
```

```
curl -x "http://YOUR_API_KEY:country_code=us@proxy.spider.cloud:8888" \
  https://example.com
```

```
import requests

proxies = {
    "http":  "http://YOUR_API_KEY:country_code=us@proxy.spider.cloud:8888",
    "https": "https://YOUR_API_KEY:country_code=us@proxy.spider.cloud:8889",
}

resp = requests.get("https://example.com", proxies=proxies)
print(resp.text)
```

```
import { ProxyAgent } from "undici";

const dispatcher = new ProxyAgent(
  "http://YOUR_API_KEY:country_code=us@proxy.spider.cloud:8888"
);

const resp = await fetch("https://example.com", { dispatcher });
console.log(await resp.text());
```

api.spider.cloud country_code: us

## Common questions.

What types of proxies does Spider offer?

Spider offers residential proxies. They route through real consumer connections, so sites treat the traffic like any household visitor. People use them for price monitoring, search result checks, and ad verification in a chosen country.

How many proxy locations are available?

Spider provides proxy coverage in 199+ countries across every inhabited continent. Coverage is deepest in the United States, the United Kingdom, Germany, Brazil and Japan.

Do I need to manage proxy rotation myself?

No. Each new connection leaves from a fresh IP, so rotation needs no setup. Requests sent over one open proxy connection keep the same IP until it closes.

How do I target a specific country?

Pass the two-letter ISO country code in the "country_code" parameter of your API request. For example, set "country_code": "de" to route through a German proxy. If Spider cannot fulfill a request from your selected country, it returns an error.

How does Spider keep proxy requests fast?

Spider checks the health of every proxy pool and takes a failing one out of rotation until it recovers. A pool that does not connect within 3 seconds is skipped. If an exit sends no first byte, the tunnel dials a fresh one and replays your request. Latency still depends on the target country and the site.

Is there a bandwidth limit on proxy usage?

There are no hard bandwidth caps. Usage is metered: you pay per gigabyte of bandwidth plus a small charge per minute a request runs, billed from one prepaid credit balance. A blocked page usually costs a fraction of a cent. Your balance never expires. There is no subscription and nothing resets monthly.

Can I use proxies with headless browsers?

Yes. Spider's proxy network integrates directly with its headless browser infrastructure. Every request already goes through a residential proxy, so turn on browser rendering to pair residential IPs with a real browser engine.

Do you support SOCKS5 or HTTP CONNECT proxies?

Yes. Spider exposes an HTTP/HTTPS proxy on proxy.spider.cloud:8888 (HTTP) and :8889 (HTTPS), plus a SOCKS5 proxy on proxy.spider.cloud:8887. Use your API key as the username and optional parameters such as country_code=us as the password.

How does pricing work for proxy requests?

Proxy requests bill like every other Spider request: bandwidth from $1/GB plus $0.0001 per minute a request runs, drawn as credits from one prepaid balance. Spider measures bandwidth on the content before it transforms it. Every request goes through a residential proxy by default. There is no separate proxy invoice or minimum commitment. A blocked page usually costs a fraction of a cent.

What happens if a proxy request fails?

Spider retries a failed request automatically. If the request still fails, you receive an error. An attempt bills only the bandwidth it used and the time it ran.

## Start routing in 30 seconds.

One API key. No proxy vendor to manage.

2,500 free credits, worth $0.25, if your signup passes our checks. No card required.

[Get an API key](https://spider.cloud/dashboard/) [Read the proxy docs](https://spider.cloud/docs/api/proxy/)
