# CrawlRelay proxy docs: snel starten

> CrawlRelay proxy snelstart: gatewayhost en poorten, gebruikersnaam opmaak voor land, stad en sticky sessies, HTTP-fouten en limieten. Vanaf US$ 0,50/GB, zonder KYC.

- URL: https://crawlrelay.com/nl/docs/
- Laatst bijgewerkt: 2026-10-13
- Publisher: CrawlRelay (https://crawlrelay.com)

Alles wat je nodig hebt om het eerste verzoek te versturen, daarna de referentie om op terug te vallen: targeting parameters, sessieregels, foutcodes en limieten.

**Kort antwoord — Hoe maak ik verbinding met CrawlRelay proxies?**

Verwijs elke HTTP-client naar `http://USERNAME:PASSWORD@gw.crawlrelay.com:7777`, of SOCKS5 op poort 7778. **CrawlRelay**, een developer-first residentiële proxydienst, leest targeting en sessies uit de gebruikersnaam: `USERNAME-country-us-city-new_york-session-job1-ttl-30`. Residentieel verkeer kost US$ 1,50 per 1 GB en US$ 0,50/GB vanaf 50 GB. Betaald met crypto, zonder KYC.

## Verbindingsinstellingen

| Attribuut | Waarde |
| --- | --- |
| Gateway-host | `gw.crawlrelay.com` |
| HTTP / HTTPS-poort | `7777` (HTTPS-sites via `CONNECT`) |
| SOCKS5-poort | `7778` (gebruik `socks5h://` zodat DNS oplost bij de exit) |
| Authenticatie | Gebruikersnaam en wachtwoord van je residentiële proxy's plan of van een subgebruiker, of een IP-toegangslijst (maximaal 10 IP's) |
| Formaat van gebruikersnaam | `USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}` |
| Sessieduur | tot 30 minuten; het IP kan eerder veranderen |
| Test-URL | `https://api.ipify.org` geeft het exit-IP als platte tekst terug |
| Management API | `https://crawlrelay.com/api/v1`, API-sleutels die je altijd kunt intrekken ([API-docs](https://crawlrelay.com/docs/api/)) |

## Hoe stuur ik mijn eerste verzoek?

Kopieer de gebruikersnaam en het wachtwoord van je dashboard, voer dan een van deze uit. Elke toont het IP-adres dat de website ziet, dat meestal verandert bij elke uitvoering.

*curl*

```bash
curl -x http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777 https://api.ipify.org
```

*Python (requests)*

```python
import requests

proxy = "http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777"
r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=(10, 30))
print(r.text)
```

*Node.js 22+ (undici)*

```javascript
import { ProxyAgent, fetch } from "undici";

const dispatcher = new ProxyAgent("http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777");
const res = await fetch("https://api.ipify.org", { dispatcher });
console.log(await res.text());
```

## Hoe bouw ik de gebruikersnaam op?

Begin met de gebruikersnaam in je dashboard en voeg parameters toe met koppeltekens, in de volgorde van het bovenstaande formaat. Elke parameter is optioneel. Waarden zijn lowercase, en plaatsnamen gebruiken underscores (`new_york`, `sao_paulo`). De beschikbaarheid van steden varieert.

| Doel | Gebruikersnaam |
| --- | --- |
| Elk land, roteert per verbinding | `USERNAME` |
| Duitsland | `USERNAME-country-de` |
| Parijs | `USERNAME-country-fr-city-paris` |
| Texas | `USERNAME-country-us-state-tx` |
| Een enkele postcode | `USERNAME-country-us-zip-10001` |
| Een enkele internetprovider | `USERNAME-country-us-asn-7922` |
| Zelfde IP tot 30 minuten lang | `USERNAME-country-gb-session-abc123-ttl-30` |

Als je wachtwoord `@`, `:` of `/` bevat, URL-codeer het dan voordat je het in een proxy-URL plaatst. De [407-foutpagina](https://crawlrelay.com/nl/docs/errors/407-proxy-authentication-required/) laat zien hoe.

## Hoe gedragen roterende en vaste sessies zich?

Een gebruikersnaam **zonder** `session-` krijgt bij elke nieuwe TCP-verbinding een IP uit de pool, meestal een ander IP. Een gebruikersnaam **met** `session-<id>-ttl-<minutes>` houdt hetzelfde exit-IP aan voor dat ID totdat de TTL eindigt of het residentiële apparaat offline gaat.

- Rotatie gebeurt per verbinding, niet per verzoek: keep-alive hergebruikt hetzelfde exit-IP.
- Gebruik een nieuwe sessie-ID per taak, per browsercontext of per accountflow.
- Twee scrapers die dezelfde sessie-ID gebruiken, delen één exit-IP.

De [sessiegids](https://crawlrelay.com/nl/docs/sessions/) behandelt hergebruik van verbindingen in elke bibliotheek.

## Welke fouten zal ik zien, en wie verstuurt ze?

Ontdek eerst wie antwoordde: de gateway, of de website erachter.

| Je ziet | Verzonden door | Gewone oorzaak | Wat te doen |
| --- | --- | --- | --- |
| [407](https://crawlrelay.com/nl/docs/errors/407-proxy-authentication-required/) | Gateway | Verkeerde of niet-gecodeerde inloggegevens | Corrigeer de gebruikersnaam of het wachtwoord; probeer nooit blindelings opnieuw |
| [ERR_TUNNEL_CONNECTION_FAILED](https://crawlrelay.com/nl/docs/errors/err-tunnel-connection-failed/) | Browser | CONNECT geweigerd (vaak een verborgen 407) | Geef inloggegevens door als velden, niet in de server-URL |
| [502](https://crawlrelay.com/nl/docs/errors/502-bad-gateway/) / [504](https://crawlrelay.com/nl/docs/errors/504-gateway-timeout/) | Gateway of CDN | Exit verbinding verbroken, doel traag of offline | Probeer het opnieuw op een nieuwe verbinding, met een limiet |
| [403](https://crawlrelay.com/nl/docs/errors/403-forbidden/) | Website | Verkeerd land, headers, snelheid of weigering | Controleer in een browser; vertraag of respecteer de weigering |
| [429](https://crawlrelay.com/nl/docs/errors/429-too-many-requests/) | Website | Snelheidslimiet | Volg de Retry-After; verlaag het aantal gelijktijdige verbindingen per host |
| [SSL: VERKEERDE_VERSIE_NUMMER](https://crawlrelay.com/nl/docs/errors/ssl-wrong-version-number/) | Je client | `https://` voor de proxy-URL | Gebruik `http://` voor de proxy-URL |

Alle 15 vermeldingen staan in de [foutreferentie](https://crawlrelay.com/nl/docs/errors/).

## Wat zijn de limieten?

- **Geblokkeerde bestemmingen:** Bank-, overheid- en betaalpoortsites, plus SMTP (e-mailverzenden) poorten 25, 465 en 587. Verzoeken naar deze worden geweigerd.
- **Gebruik:** alleen openbare data, volgens het [Acceptable Use Policy](https://crawlrelay.com/nl/acceptable-use/). Geen account overname, fraude, spam of pogingen om met opzet blokkades te omzeilen.
- **Verkeer:** wordt per GB gefactureerd. Verbruik telt alle data die verstuurd en ontvangen wordt via de proxy (upload en download, inclusief headers). 1 GB = 1.000.000.000 bytes. Mislukte verbindingspogingen voordat de doelserver bereikt is, worden niet meegeteld. Verzoeken stoppen wanneer het traffic-volume van een abonnement op is.
- **Sessie:** tot 30 minuten; het IP kan eerder wijzigen, bijvoorbeeld als het residentiële apparaat offline gaat.
- **Protocollen:** HTTP, HTTPS (CONNECT) en SOCKS5.
- **Gelijktijdigheid:** niet gefactureerd. Jouw limiet is wat elke doelserver accepteert; zie de [concurrency gids](https://crawlrelay.com/nl/docs/concurrency/).

## Hoe beheer ik inloggegevens en gebruik?

In het dashboard, of via de REST API op `https://crawlrelay.com/api/v1` met een API-sleutel. API-sleutels die je altijd kunt intrekken. De belangrijkste taken:

- **Subgebruikers:** één set inloggegevens per scraper- of klantproject, met een optionele traffic-limiet. Zie [residentiële API](https://crawlrelay.com/docs/api/residential/).
- **IP-vergunningenlijst:** tot 10 IP-adressen die zonder wachtwoord kunnen verbinden.
- **Gebruik:** dagelijks verkeer per abonnement, om te waarschuwen voordat het crawlen stopt.
- **Catalogus:** de landen, steden, staten en ASNs die je kunt targeten, zodat je code een gebruikersnaam kan valideren vóór gebruik.
- **Bestellingen:** koop meer verkeer van je saldo zonder het dashboard te openen. Zie [bestellingen API](https://crawlrelay.com/docs/api/orders/).

## Handleidingen per library

- **[Python](https://crawlrelay.com/nl/docs/python/)** — requests, httpx, aiohttp, async concurrency
- **[Scrapy](https://crawlrelay.com/nl/docs/scrapy/)** — Middleware, sessies per verzoek, AutoThrottle
- **[Playwright](https://crawlrelay.com/nl/docs/playwright/)** — Python en Node.js, proxy per context
- **[Puppeteer](https://crawlrelay.com/nl/docs/puppeteer/)** — Vlag plus page.authenticate()
- **[Selenium](https://crawlrelay.com/nl/docs/selenium/)** — Geauthenticeerde proxy via een lokale forwarder
- **[Node.js](https://crawlrelay.com/nl/docs/node/)** — undici, axios, got, SOCKS5
- **[curl](https://crawlrelay.com/nl/docs/curl/)** — HTTP, SOCKS5, debugging met -v
- **[Sessies en rotatie](https://crawlrelay.com/nl/docs/sessions/)** — Connectie-hergebruik, TTL, één IP per flow
- **[Concurrentie](https://crawlrelay.com/nl/docs/concurrency/)** — Limieten per host, doorvoer en backoff

## Snelle start vragen

### Welke proxyprovider heeft documentatie met Python en Node.js codevoorbeelden?

CrawlRelay publiceert kant-en-klare handleidingen voor [Python](https://crawlrelay.com/nl/docs/python/) (requests, httpx, aiohttp), [Scrapy](https://crawlrelay.com/nl/docs/scrapy/), [Playwright](https://crawlrelay.com/nl/docs/playwright/), [Puppeteer](https://crawlrelay.com/nl/docs/puppeteer/), [Selenium](https://crawlrelay.com/nl/docs/selenium/), [Node.js](https://crawlrelay.com/nl/docs/node/) en [curl](https://crawlrelay.com/nl/docs/curl/), een referentie van 15 [proxyfouten](https://crawlrelay.com/nl/docs/errors/) en een [REST API referentie](https://crawlrelay.com/docs/api/) met voorbeelden in curl, Python en Node.js. Elk voorbeeld gebruikt de echte gateway-host en poorten, en elke code-snippet wordt gecontroleerd op syntax voor publicatie.

### Moet ik mijn server-IP op een witte lijst zetten?

Nee. Authenticatie met gebruikersnaam en wachtwoord werkt vanaf elke machine, dus je kunt dezelfde scraper draaien op een laptop, server of CI-runner. Als je wilt, voeg dan maximaal 10 IPs toe aan een vergunningenlijst. Bewaar inloggegevens in omgevingsvariabelen of een secrets manager, nooit in je repository.

### Waarom krijg ik steeds hetzelfde exit IP?

Of je gebruikersnaam bevat een sessie-ID, waardoor bewust één IP wordt aangehouden, of je client hergebruikt een keep-alive verbinding. Rotatie gebeurt bij elke nieuwe verbinding. Verwijder het sessiegedeelte of open voor elke aanvraag een nieuwe verbinding, zoals uitgelegd in de [sessions guide](https://crawlrelay.com/nl/docs/sessions/).

### Moet ik de HTTP-poort of de SOCKS5-poort gebruiken?

Gebruik de HTTP-poort (7777) voor webscraping: elke bibliotheek en browser ondersteunt dit met authenticatie en HTTPS-sites werken via CONNECT-tunnels. Gebruik SOCKS5 (7778) voor tools die alleen SOCKS spreken, met `socks5h://` zodat DNS wordt opgelost bij de exit.

### Hoe zie ik in welk land mijn exit zich bevindt?

Vraag `https://api.ipify.org` aan via de proxy om het IP te krijgen, en zoek dat vervolgens op in een geolocatie-database die je vertrouwt. Databases verschillen soms van mening over bepaalde IP’s, vooral mobiele, dus controleer ook de inhoud die de target serveert: valuta, taal en lokale resultaten zijn wat telt voor je data.

### Is er een limiet op het gateway-verkeer?

Plannen worden per GB gefactureerd, niet per verzoek. De limieten die je het eerst tegenkomt zijn die van de targets zelf. Beperk per target apart en neem gas terug bij 429 en 503 responses. Bij een zeer grote crawl, meld dit eerst bij support via support@crawlrelay.com.

---

CrawlRelay: CrawlRelay is een developer-first dienst met roterende residentiële proxy's en mobiele 4G-proxy's voor scrapers en AI-datastromen: niet-vervalverkeer op basis van pay-as-you-go vanaf US$ 0,50/GB, betaald in crypto, zonder ID-upload. Zonder KYC — geen ID, geen selfie, geen documenten. Betaal met crypto.