Dokumentasi proxy CrawlRelay: mulai cepat

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 -x http://USERNAME-country-us:[email protected]:7777 https://api.ipify.org

import requests

proxy = "http://USERNAME-country-us:[email protected]:7777"
r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=(10, 30))
print(r.text)

import { ProxyAgent, fetch } from "undici";

const dispatcher = new ProxyAgent("http://USERNAME-country-us:[email protected]: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.

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 membahas penggunaan kembali koneksi di tiap library.

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. 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.

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.
• 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.