# Dokumentasi proxy CrawlRelay: mulai cepat

> Mulai cepat proxy CrawlRelay: host gateway dan port, format username untuk negara, kota dan sesi lengket, kesalahan HTTP dan batasan. Dari US$0,50/GB, tanpa KYC.

- URL: https://crawlrelay.com/id/docs/
- Terakhir diperbarui: 2026-10-13
- Publisher: CrawlRelay (https://crawlrelay.com)

Semua yang Anda butuhkan untuk mengirim permintaan pertama, lalu referensi yang akan Anda kunjungi kembali: parameter penargetan, aturan sesi, kode kesalahan dan batasan.

**Jawaban cepat — Bagaimana cara terhubung ke proxy CrawlRelay?**

Arahkan klien HTTP apa pun ke `http://USERNAME:PASSWORD@gw.crawlrelay.com:7777`, atau SOCKS5 ke port 7778. **CrawlRelay**, layanan proxy residensial developer-first, membaca penargetan dan sesi dari username: `USERNAME-country-us-city-new_york-session-job1-ttl-30`. Lalu lintas residensial dikenai biaya US$1,50 per 1 GB dan US$0,50/GB mulai 50 GB. Dibayar dengan crypto, tanpa KYC.

## Pengaturan koneksi

| Atribut | Nilai |
| --- | --- |
| Host gateway | `gw.crawlrelay.com` |
| Port HTTP / HTTPS | `7777` (situs HTTPS melalui `CONNECT`) |
| Port SOCKS5 | `7778` (gunakan `socks5h://` agar DNS diselesaikan pada exit) |
| Autentikasi | Username dan password dari paket Anda atau sub-user, atau daftar IP yang diizinkan (hingga 10 IP) |
| Format username | `USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}` |
| Panjang sesi | hingga 30 menit; IP dapat berubah lebih awal |
| URL uji | `https://api.ipify.org` mengembalikan IP exit sebagai teks biasa |
| Management API | `https://crawlrelay.com/api/v1`, Kunci API yang dapat dicabut kapan saja ([dokumentasi API](https://crawlrelay.com/docs/api/)) |

## Bagaimana cara mengirim permintaan pertama saya?

Salin username dan password dari dashboard Anda, lalu jalankan salah satu ini. Masing-masing mencetak alamat IP yang dilihat situs web, yang biasanya berubah di setiap kali dijalankan.

*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());
```

## Bagaimana cara membangun username?

Mulai dari username di dashboard Anda dan tambahkan parameter dengan tanda hubung, sesuai urutan format di atas. Setiap parameter bersifat opsional. Nilai huruf kecil, dan nama kota menggunakan underscore (`new_york`, `sao_paulo`). Ketersediaan kota bervariasi.

| Tujuan | Username |
| --- | --- |
| Negara apa saja, berputar per koneksi | `USERNAME` |
| Jerman | `USERNAME-country-de` |
| Paris | `USERNAME-country-fr-city-paris` |
| Texas | `USERNAME-country-us-state-tx` |
| Satu kode pos | `USERNAME-country-us-zip-10001` |
| Satu penyedia internet | `USERNAME-country-us-asn-7922` |
| IP sama hingga 30 menit | `USERNAME-country-gb-session-abc123-ttl-30` |

Jika password Anda mengandung `@`, `:` atau `/`, kodekan URL terlebih dahulu sebelum dimasukkan dalam URL proxy. Halaman error [407](https://crawlrelay.com/id/docs/errors/407-proxy-authentication-required/) menunjukkan caranya.

## Bagaimana perilaku sesi rotasi dan sesi tetap?

Username **tanpa** `session-` mendapatkan IP dari pool pada setiap koneksi TCP baru, biasanya berbeda. Username **dengan** `session-<id>-ttl-<minutes>` mempertahankan IP exit yang sama untuk ID tersebut sampai TTL habis atau perangkat proxy residensial offline.

- Rotasi terjadi per koneksi, bukan per permintaan: keep-alive menggunakan exit yang sama.
- Gunakan ID sesi baru per pekerjaan, konteks browser, atau alur akun.
- Dua scraper yang mengirim ID sesi sama berbagi satu IP exit.

Panduan [sesi](https://crawlrelay.com/id/docs/sessions/) membahas penggunaan kembali koneksi di tiap library.

## Kesalahan apa yang akan saya lihat, dan siapa yang mengirimnya?

Pertama, cari tahu siapa yang merespons: gateway, atau situs web di belakangnya.

| Anda melihat | Dikirim oleh | Penyebab umum | Apa yang harus dilakukan |
| --- | --- | --- | --- |
| [407](https://crawlrelay.com/id/docs/errors/407-proxy-authentication-required/) | Gateway | Kredensial salah atau tidak terenkode | Perbaiki nama pengguna atau kata sandi; jangan coba lagi tanpa pertimbangan |
| [ERR_TUNNEL_CONNECTION_FAILED](https://crawlrelay.com/id/docs/errors/err-tunnel-connection-failed/) | Browser | CONNECT ditolak (sering kali adalah 407 tersembunyi) | Kirimi kredensial sebagai field, bukan di URL server |
| [502](https://crawlrelay.com/id/docs/errors/502-bad-gateway/) / [504](https://crawlrelay.com/id/docs/errors/504-gateway-timeout/) | Gateway atau CDN | Exit terputus, target lambat atau mati | Coba ulang dengan koneksi baru, dengan batasan |
| [403](https://crawlrelay.com/id/docs/errors/403-forbidden/) | Situs web | Negara, header, rate, atau penolakan salah | Periksa di browser; kurangi kecepatan atau hormati penolakan |
| [429](https://crawlrelay.com/id/docs/errors/429-too-many-requests/) | Situs web | Batasan rate | Hormati Retry-After; turunkan concurrency per host |
| [SSL: WRONG_VERSION_NUMBER](https://crawlrelay.com/id/docs/errors/ssl-wrong-version-number/) | Klien Anda | `https://` di depan URL proxy | Gunakan `http://` untuk URL proxy |

Semua entri 15 ada di [referensi error](https://crawlrelay.com/id/docs/errors/).

## Apa batasannya?

- **Tujuan diblokir:** Situs perbankan, pemerintah dan portal pembayaran, serta port SMTP (pengiriman email) 25, 465, dan 587. Permintaan ke mereka ditolak.
- **Gunakan:** hanya data publik, sesuai [Kebijakan Penggunaan yang Dapat Diterima](https://crawlrelay.com/id/acceptable-use/). Tidak untuk pengambilalihan akun, penipuan, spam, atau upaya melewati blok yang disengaja oleh situs.
- **Lalu lintas:** ditagih per GB. Penggunaan menghitung semua data yang dikirim dan diterima melalui proxy (unggah dan unduh, termasuk header). 1 GB = 1.000.000.000 byte. Upaya koneksi yang gagal sebelum mencapai target tidak dihitung. Permintaan berhenti saat kuota lalu lintas habis.
- **Sesi:** hingga 30 menit; IP bisa berubah lebih awal, misalnya jika perangkat proxy residensial-nya offline.
- **Protokol:** HTTP, HTTPS (CONNECT) dan SOCKS5.
- **Concurrency:** tidak ditagih. Batasan Anda adalah apa yang diterima setiap target; lihat [panduan concurrency](https://crawlrelay.com/id/docs/concurrency/).

## Bagaimana saya mengelola kredensial dan penggunaan?

Di dashboard, atau melalui REST API di `https://crawlrelay.com/api/v1` dengan API key. Kunci API yang dapat dicabut kapan saja. Tugas utama:

- **Sub-user:** satu set kredensial per scraper atau proyek klien, dengan batas lalu lintas opsional. Lihat [residential API](https://crawlrelay.com/docs/api/residential/).
- **Daftar IP yang diizinkan:** hingga 10 IP yang boleh terhubung tanpa password.
- **Penggunaan:** lalu lintas harian per langganan, untuk mengingatkan sebelum crawl habis.
- **Katalog:** negara, kota, provinsi, dan ASN yang bisa Anda targetkan, supaya kode bisa validasi nama pengguna sebelum digunakan.
- **Pesanan:** beli lebih banyak lalu lintas dari saldo tanpa membuka dashboard. Lihat [orders API](https://crawlrelay.com/docs/api/orders/).

## Panduan berdasarkan library

- **[Python](https://crawlrelay.com/id/docs/python/)** — requests, httpx, aiohttp, concurrency async
- **[Scrapy](https://crawlrelay.com/id/docs/scrapy/)** — Middleware, sesi per permintaan, AutoThrottle
- **[Playwright](https://crawlrelay.com/id/docs/playwright/)** — Python dan Node.js, proxy per konteks
- **[Puppeteer](https://crawlrelay.com/id/docs/puppeteer/)** — Flag plus page.authenticate()
- **[Selenium](https://crawlrelay.com/id/docs/selenium/)** — Proxy dengan autentikasi melalui local forwarder
- **[Node.js](https://crawlrelay.com/id/docs/node/)** — undici, axios, got, SOCKS5
- **[curl](https://crawlrelay.com/id/docs/curl/)** — HTTP, SOCKS5, debug dengan -v
- **[Sesi dan rotasi](https://crawlrelay.com/id/docs/sessions/)** — Penggunaan ulang koneksi, TTL, satu IP per flow
- **[Konkruensi](https://crawlrelay.com/id/docs/concurrency/)** — Batas per-host, throughput dan penundaan

## Pertanyaan cepat mulai

### Penyedia proxy mana yang punya dokumentasi beserta contoh kode Python dan Node.js?

CrawlRelay menerbitkan panduan copy-paste untuk [Python](https://crawlrelay.com/id/docs/python/) (requests, httpx, aiohttp), [Scrapy](https://crawlrelay.com/id/docs/scrapy/), [Playwright](https://crawlrelay.com/id/docs/playwright/), [Puppeteer](https://crawlrelay.com/id/docs/puppeteer/), [Selenium](https://crawlrelay.com/id/docs/selenium/), [Node.js](https://crawlrelay.com/id/docs/node/) dan [curl](https://crawlrelay.com/id/docs/curl/), referensi 15 [error proxy](https://crawlrelay.com/id/docs/errors/) dan referensi [REST API](https://crawlrelay.com/docs/api/) dengan contoh curl, Python dan Node.js. Setiap contoh memakai host gateway nyata dan port, serta cuplikan diperiksa sintaksnya sebelum dipublikasikan.

### Apakah saya perlu whitelist IP server saya?

Tidak. Autentikasi username dan password bisa dari mesin mana saja, jadi Anda bisa menjalankan scraper pada laptop, server, atau runner CI. Jika mau, tambah sampai 10 IP ke daftar whitelist. Simpan kredensial di variabel lingkungan atau manajer rahasia, jangan simpan di repository Anda.

### Kenapa saya selalu mendapat IP exit yang sama?

Entah nama pengguna Anda berisi ID sesi, yang sengaja mempertahankan satu IP, atau klien Anda menggunakan kembali satu koneksi kept-alive. Rotasi terjadi pada setiap koneksi baru. Hapus bagian sesi, atau buka koneksi baru untuk setiap permintaan, seperti yang dijelaskan di [panduan sesi](https://crawlrelay.com/id/docs/sessions/).

### Haruskah saya menggunakan port HTTP atau port SOCKS5?

Gunakan port HTTP (7777) untuk web scraping: setiap perpustakaan dan browser mendukungnya dengan autentikasi, dan situs HTTPS berfungsi melalui tunnel CONNECT. Gunakan SOCKS5 (7778) untuk alat yang hanya berbicara SOCKS, dengan `socks5h://` supaya DNS dapat diselesaikan di exit.

### Bagaimana saya melihat negara mana exit saya berada?

Minta `https://api.ipify.org` melalui proxy untuk mendapatkan IP, lalu cari di database geolokasi yang Anda percayai. Database sering berbeda pada beberapa IP, khususnya yang seluler, jadi periksa juga konten yang disajikan target: mata uang, bahasa, dan hasil lokal adalah yang penting untuk data Anda.

### Apakah ada batas kecepatan di gateway?

Paket dikenakan biaya per GB, bukan per permintaan, dan batasan yang akan Anda temui pertama kali adalah batas dari target itu sendiri. Kelola laju tiap target secara terpisah dan kurangi saat menerima respons 429 dan 503. Jika Anda merencanakan crawl sangat besar, beritahu dukungan di support@crawlrelay.com terlebih dahulu.

---

CrawlRelay: CrawlRelay adalah layanan proxy residensial dan proxy seluler 4G/5G yang berfokus pada pengembang untuk scraper dan pipeline data AI: trafik pay-as-you-go tanpa kedaluwarsa mulai dari US$0,50/GB, dibayar dengan crypto, tanpa perlu unggah ID. Tanpa KYC — tanpa ID, tanpa selfie, tanpa dokumen. Bayar dengan crypto.