Routing capability · country targeting
Choose the country.
Compare the page.
Request a proxy exit IP in a supported country to collect regional pricing, catalog and availability snapshots. Set one parameter on your existing scrape request.
Country targeting adds no fee. Proxy-tier access and normal request charges still apply.
{
"url": "https://example.com",
"proxy_country": "DE",
"formats": [
"markdown"
]
}example.com demonstrates the request shape, not localized content.
An ISO-2 code selects the requested country
POST the body above to /api/v1/scrape with your x-api-key header. Replace the target URL, and use a code such as DE or US for the country you need.
Check the API HTTP status and success, then read data.markdown. Country availability depends on the resolved proxy type and pool. An unsupported combination returns 422; it does not silently select another country.
Location is more than an IP address
A site may also use language, currency settings, cookies, account details or a delivery address. A country-selected request is not a guarantee of the exact experience of every local customer.
FineData's public option selects a country, not a city or GPS location. For BYOP, choose a regional profile instead: proxy_country cannot be combined with proxy_profile_id.
Compare regions under consistent conditions
01 · Pick the page and markets
Choose an authorized source and verify country availability for the proxy type your plan allows. Start with two markets before expanding.
02 · Keep other inputs consistent
Use the same product variant and extraction fields. Record language, cookies and any delivery assumptions that affect the result.
03 · Store regional snapshots
Keep source URL, requested country, collection time and currency with the data. Your application compares snapshots and handles unavailable markets.
Use structured extraction for comparable fields or pass proxy_country through an MCP scrape tool.
Availability, access and cost
Which countries can I request?
Use an ISO-2 code with proxy_country. Country availability depends on the resolved proxy type and current pool. An unsupported country returns HTTP 422 instead of silently routing elsewhere. Country selection does not provide city-level targeting.
Does country targeting cost extra?
proxy_country adds no extra tokens. Normal request and proxy-tier charges still apply, including any rendering, extraction or retries. See tokens_used for the actual charge.
Can I use it on the Free plan?
Country targeting itself has no plan restriction, but access to the selected proxy type still depends on your plan. Residential and mobile proxies are restricted on Trial and Free unless an account override permits them.
Will I see exactly what a local customer sees?
Not necessarily. Sites may also use language, cookies, account settings, delivery address and personalization. Keep those conditions consistent and record the requested region when comparing page snapshots.
Can I combine it with BYOP?
No. proxy_country and proxy_profile_id are mutually exclusive. For BYOP, select a profile containing your own proxies in the required country.
Regional routing does not grant rights to restricted or licensed content. Respect source terms and the Acceptable Use Policy.
Try the markets your application needs
Verify availability and output before planning a regional collection.