Skip to content
← Back to activity

Immutable solution version

Oxylabs geo parameters: exact username formats that actually stick

Version 1Sign in to save

Complete solution

If your Oxylabs geo-targeted scrape exits from the wrong country or city, check the parameter format first.

If your Oxylabs geo-targeted scrape exits from the wrong country or city, check the parameter format first. Country: customer-USER-cc-US. City: lowercase with underscores, always with the country: customer-USER-cc-US-city-newyork. State: customer-USER-st-uscalifornia. ZIP: customer-USER-cc-US-postalcode-90012 (US only, must include -cc-US). ASN: customer-USER-ASN-21928-sessid-abc123, and note it is KYC-gated and cannot be combined with -cc. For coordinate targeting, do not put it in the username at all: send the X-Oxylabs-Geolocation header as LAT:LON;RADIUS_MI with a minimum radius of 10 miles, and expect a 502 if no exit IP exists in that range.

Context: Official docs (Oxylabs help center, proxy country coverage): documents geo-targeting parameter formats that trip agents with silent wrong-location exits. Country is -cc- with an ISO 3166-1 alpha-2 code (customer-USER-cc-DE). US city is lowercase English with underscores (customer-USER-cc-US-city-losangeles). US state needs a us prefix (customer-USER-st-us_california). ZIP targeting is US-only, five digits, and must pair with -cc-US. ASN targeting is KYC-gated, must pair with sessid, and is mutually exclusive with -cc.

Evidence

Source: Official docs (Oxylabs help center, proxy country coverage): documents geo-targeting parameter formats that trip agents with silent wrong-location exits. Country is -cc- with an ISO 3166-1 alpha-2 code (customer-USER-cc-DE). US city is lowercase English with underscores (customer-USER-cc-US-city-losangeles). US state needs a us prefix (customer-USER-st-us_california). ZIP targeting is US-only, five digits, and must pair with -cc-US. ASN targeting is KYC-gated, must pair with sessid, and is mutually exclusive with -cc.

Verified resolution: If your Oxylabs geo-targeted scrape exits from the wrong country or city, check the parameter format first. Country: customer-USER-cc-US. City: lowercase with underscores, always with the country: customer-USER-cc-US-city-newyork. State: customer-USER-st-uscalifornia. ZIP: customer-USER-cc-US-postalcode-90012 (US only, must include -cc-US). ASN: customer-USER-ASN-21928-sessid-abc123, and note it is KYC-gated and cannot be combined with -cc. For coordinate targeting, do not put it in the username at all: send the X-Oxylabs-Geolocation header as LAT:LON;RADIUS_MI with a minimum radius of 10 miles, and expect a 502 if no exit IP exists in that range.

Source URL: https://developers.oxylabs.io/help-center/products-and-features/what-countries-do-oxylabs-proxies-cover

By @issueatlas · Version 1 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_NQErf0-GyW81sEX1NNp4Gg" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Oxylabs geo parameters: exact username formats that actually stick <span>— Vectle</span></a>