Gateway and protocol
| Protocol to the proxy | Planned endpoint | Use |
|---|---|---|
| HTTP | proxy.crawlhub.ai:8000 | HTTP destinations and HTTPS CONNECT tunnels. |
| HTTPS | proxy.crawlhub.ai:8443 | TLS connection to the proxy itself; the client must support it. |
| SOCKS5 | proxy.crawlhub.ai:1080 | SOCKS5 clients supported by the activated product. Chromium extensions do not support SOCKS5 password authentication. |
Scroll horizontally to view all columns.
Username and password
The base login is ch-ACCOUNT_ID. Use the proxy account ID assigned at activation and its separate proxy password. The account token is case-sensitive and contains 1–64 letters, digits or underscores.
ch-ACCOUNT_ID-network-NETWORK[-PARAMETER-VALUE...]Each option is a key/value pair separated by hyphens. Values cannot contain hyphens; multiword location values use underscores. Unknown keys, duplicate keys and unsupported combinations are rejected. The complete username is limited to 255 ASCII bytes so it fits SOCKS5 authentication as well as HTTP proxy login.
Parameter reference
| Parameter | Scope | Accepted value | Rule |
|---|---|---|---|
| network | Required | residential / isp / datacenter | Select the network; no billing-type default is inferred. |
| country | Optional | Two lowercase letters, for example us | Select an available country. Inventory is validated by the activated service. |
| state | Residential | Lowercase underscore slug, for example california | Requires country. |
| city | Residential | Lowercase underscore slug, for example los_angeles | Requires country. Use the gateway location catalog when available. |
| zip | Residential | Lowercase letters, digits and underscores | Requires country. Preserve leading zeroes; use underscores for spaces or hyphens. |
| asn | Residential | Integer 1–4294967295, without AS | Filter available exits by autonomous system number. |
| session | Residential | 1–64 letters, digits or underscores | Use the same ID for related connections. Omit for rotating selection. |
| ttl | Residential | 60–3600 seconds; default 600 | Requires session. This is a maximum requested session lifetime. |
| ip | ISP / Datacenter | Assigned allocation ID, for example ip_01 | Select an IP assignment owned by this proxy account. Not an arbitrary destination address. |
Scroll horizontally to view all columns.
Parameters by network
| Network | Available v1 selectors | Session behavior |
|---|---|---|
| Residential | country, state, city, zip, asn, session, ttl | Without session: select an exit for each new upstream connection or CONNECT tunnel. |
| ISP | country, ip | Use a fixed assigned IP; residential session selectors are not accepted. |
| Datacenter | country, ip | Use a fixed assigned IP; residential session selectors are not accepted. |
Scroll horizontally to view all columns.
When both country and ip are supplied, the activated gateway must verify that the owned allocation matches that country. A syntactically valid selector does not guarantee available inventory.
Configuration examples
ch-ACCOUNT_ID-network-residential-country-us-city-los_angeles-session-job01-ttl-600ch-ACCOUNT_ID-network-isp-country-de-ip-ip_01ch-ACCOUNT_ID-network-datacenter-ip-ip_02These names show the v1 contract. Replace the proxy account ID and assignment values with activated account details.
Validate or generate a username
Download the username formatter and parser · Read the JSON Schema
import { formatProxyUsername } from './proxy_username.mjs';
console.log(formatProxyUsername({
account: 'ACCOUNT_ID',
network: 'residential',
country: 'us',
city: 'los_angeles',
session: 'job01',
ttl: 600,
}));The formatter validates syntax and option combinations. It does not authenticate the account, activate an endpoint, check ownership or validate inventory.
Use the values in your client
Keep raw username and password values in separate client fields. URL-encode credentials only when constructing a proxy URL. Do not pre-encode a password for an ordinary password input. An HTTPS destination does not require an HTTPS proxy transport.
Choose a client integration · Read location and session rules