Dokumentacja proxy CrawlRelay: szybki start

Jak wysłać pierwsze zapytanie?

Skopiuj nazwę użytkownika i hasło z panelu, a następnie uruchom jeden z tych przykładów. Każdy wyświetla adres IP, który widzi strona, zwykle zmienia się przy każdym uruchomieniu.

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

Jak zbudować nazwę użytkownika?

Zacznij od nazwy użytkownika z panelu i dodaj parametry łącznikiem, zgodnie z powyższym formatem. Każdy parametr jest opcjonalny. Wartości pisz małymi literami, a nazwy miast używają podkreśleń (new_york, sao_paulo). Dostępność miast jest różna.

Jak działają rotujące i trwałe sesje?

Nazwa użytkownika bez session- pobiera IP z puli przy każdym nowym połączeniu TCP, zwykle inne. Nazwa użytkownika z session-<id>-ttl-<minutes> zachowuje tę samą IP wyjścia dla tego ID, aż do wygaśnięcia TTL lub rozłączenia urządzenia proxy rezydencjalnego.

• Rotacja odbywa się na poziomie połączenia, nie zapytania: keep-alive używa tego samego IP wyjścia.
• Używaj nowego ID sesji na każdą pracę, kontekst przeglądarki lub przepływ konta.
• Dwa scrapery wysyłające ten sam ID sesji dzielą jedno IP wyjścia.

Przewodnik po sesjach opisuje ponowne użycie połączeń w każdej bibliotece.

Jakie są limity?

• Zablokowane cele: Strony bankowe, rządowe i portale płatności, a także porty SMTP (wysyłanie maili) 25, 465 i 587. Żądania do nich są odrzucane.
• Zastosowanie: tylko dane publiczne, zgodnie z Polityką Akceptowalnego Użytkowania. Zakaz przejmowania kont, oszustw, spamu lub obchodzenia blokad serwisów.
• Ruch: rozliczany za GB. Zużycie liczy całe dane wysłane i odebrane przez proxy (upload i download, nagłówki wliczone). 1 GB = 1 000 000 000 bajtów. Nieudane próby połączeń bez dotarcia do celu nie są liczone. Żądania zatrzymują się po wyczerpaniu pakietu.
• Sesje: do 30 minut; IP może się zmienić wcześniej, np. gdy urządzenie z proxy rezydencjalnym przejdzie offline.
• Protokoły: HTTP, HTTPS (CONNECT) i SOCKS5.
• Równoczesność: bez opłat. Limit to to, co akceptuje każdy cel; zobacz poradnik równoczesności.

Jak zarządzać danymi logowania i użyciem?

W panelu lub przez REST API pod https://crawlrelay.com/api/v1 z kluczem API. Klucze API, które możesz w każdej chwili unieważnić. Główne funkcje:

• Subużytkownicy: osobny zestaw danych dla każdego scraper’a lub projektu klienta, z opcjonalnym limitem ruchu. Zobacz residential API.
• Lista dozwolonych IP: do 10 adresów IP mogących się łączyć bez hasła.
• Użycie: dzienny transfer na subskrypcję, by ostrzec przed wyczerpaniem ruchu.
• Katalog: kraje, miasta, województwa i ASN do celów, aby kod mógł zweryfikować nazwę użytkownika przed użyciem.
• Zamówienia: dokup więcej ruchu ze swojego salda bez otwierania panelu. Zobacz orders API.