Skip to content

The Proxy Playbook · Appendix

Appendix

Reference pages to keep open while working: a glossary, a provider scorecard, a pre-launch checklist, HTTP status codes and ProxyLook's free tools.

  • Glossary of 24 proxy terms
  • Provider scorecard worksheet
  • Pre-launch checklist
  • HTTP status codes behind a proxy

5 min read · page 85 of the PDF

These pages are for use, not for reading through. Print the scorecard and the checklist, and keep the status table near the terminal.

Glossary

TermMeaning
AllowlistingAuthorizing a client by its IP address instead of a password.
Antidetect browserBrowser that gives each profile its own fingerprint, storage and proxy.
ASNNumber that identifies the network owning an IP range.
Backconnect gatewayOne hostname that forwards each request to a changing exit IP.
BackoffWaiting longer after each failed attempt before retrying.
Cloud phoneRemote Android device with its own identity and proxy setting.
ConcurrencyNumber of requests in flight at the same time.
Datacenter proxyIP hosted in a data center: fast, cheap, easier to flag.
Exit nodeThe device or server whose IP the target sees.
FingerprintSet of browser or client traits that can identify a visitor.
Geo-targetingChoosing the country, region or city of the exit IP.
ISP proxyStatic IP on a server, registered to a consumer internet provider.
JitterRandom variation in delays so clients do not retry together.
Mobile proxyIP assigned by a mobile carrier to a device.
p95 latencyTime within which 95% of requests finish.
Residential proxyIP assigned by a home internet provider to a household.
RotationChanging the exit IP per request or on a timer.
Scraper APIService that fetches a URL and returns the page or data.
SOCKS5Proxy protocol that carries any TCP traffic, and optionally UDP.
Soft blockA 200 response that carries wrong or missing data.
Sticky sessionKeeping the same exit IP for a set time.
TLS fingerprintSignature of a client's TLS handshake, such as JA3.
UnblockerManaged proxy that handles fingerprints, retries and challenges itself.
WebRTC leakBrowser revealing the real IP through a WebRTC lookup.
Twenty-four terms used in this book.

Provider scorecard

These are the 12 criteria from Chapter 7, scored 1 to 5. Copy the worksheet once per provider and fill it in during the pilot.

CriterionWhat to checkScore (1 to 5)
1. Pool and coverageIPs in the countries and cities the job needs
2. Proxy typesThe type needed now, plus the next rung up
3. TargetingCountry, region, city and carrier options in the plan
4. Session controlSticky duration and rotation settings per connection
5. Pricing fitCost per 1,000 successful requests in the pilot
6. Trial and refundTrial or refund terms stated before payment
7. Sourcing transparencyWritten answer on consent and opt-out for device owners
8. DocumentationPublic setup guides and working code samples
9. SupportSpeed and quality of the reply to a technical question
10. Dashboard and APIUsage by day and target, sub-users, traffic limits
11. Compliance and KYCAcceptable use policy and a real customer check
12. ReputationA named company with a track record
Provider scorecard worksheet. The maximum unweighted score is 60.

Pre-launch checklist

Run through this list before a new scraper, profile or automation goes live.

  • Exit IP, country and ASN confirmed from inside the app that does the work.
  • No WebRTC or DNS leak in any browser profile.
  • Timezone and language match the exit location.
  • Credentials come from environment variables, and nothing secret is in the repository.
  • Every request has a timeout, and TLS verification is on.
  • Retries use backoff with jitter and a cap on attempts.
  • Every response is checked for expected content, not only for status.
  • Concurrency is limited per domain.
  • A daily GB cap and a success-rate alert are in place.
  • The legal questions are answered in writing, and robots.txt has been read.

HTTP status quick reference

A 407 always comes from the proxy, never from the target. A 502 or 503 can come from either. For HTTPS targets a proxy-side error shows up as a failed tunnel, while the target's own error arrives inside a normal response. Providers also add their own error codes, which their documentation explains.

CodeNameBehind a proxy it usually meansWhat to do
200OKSuccess, or a soft block with wrong dataValidate the content
301 / 302RedirectA normal move, or a push to login or CAPTCHACheck the final URL
403ForbiddenTarget refused the IP or the client fingerprintChange the client, then the IP type
404Not FoundPage is gone; now and then a disguised blockDo not retry; spot-check in a browser
407Proxy Authentication RequiredWrong credentials, or the client IP is not allowlistedFix credentials or the allowlist
408Request TimeoutSlow exit node or slow targetRetry with backoff
429Too Many RequestsRate limit per IP or per sessionSlow down; honor Retry-After
500Internal Server ErrorTarget failed while handling the requestRetry a few times
502Bad GatewayProxy or exit node could not reach the targetRetry on a new IP
503Service UnavailableTarget overloaded, a challenge page, or no exit availableBack off and inspect the body
Common status codes and what they usually mean behind a proxy.

Troubleshooting order

When requests fail, work from the bottom of the connection upward. Each layer is quicker and cheaper to check than the one after it.

1 · CredentialsA 407 or refused connection: check username, password, port and allowlist.
2 · ConnectivityTimeouts: test the gateway alone with curl and a 30-second limit.
3 · Exit IPConfirm the country, ASN and network type match the order.
4 · Rate429s or blocks after some pages: lower concurrency and add backoff.
5 · Client fingerprint403 on the first request: fix headers and TLS, or use a real browser.
6 · IP typeStill blocked: move to ISP, residential or mobile, then an unblocker.
The order in which to check a failing proxy setup.

ProxyLook's free tools

All six are free and run in the browser.

Key takeaways

  • Score providers during a pilot on real targets, not on list price or pool size.
  • Run the pre-launch checklist before every new scraper, profile or automation.
  • A 407 comes from the proxy, and a 200 can still be a block.
  • Troubleshoot in order: credentials, connectivity, exit IP, rate, client fingerprint, IP type.

Prefer the designed PDF? The Proxy Playbook is 91 pages, free, with no sign-up.

Download the PDF