Scrape From Any Country.
One Parameter.
Pricing, availability, search rankings, and catalogs all change depending on where the
request appears to come from. Set proxy_country
to an ISO-2 code and FineData routes through an exit IP in that country -- on any plan, at no extra cost.
The Internet Looks Different Everywhere
Most sites serve different prices, inventory, and rankings based on the visitor's apparent location. Scraping from a single datacenter IP gives you one country's view of the world -- and it's not always the one you need.
Regional Pricing Differences
Airlines, SaaS products, and e-commerce sites can quote a different price in USD, EUR, or BRL depending on where the request appears to originate.
Localized Search Rankings
Google, Bing, and marketplace search results are ranked per-region. Tracking rankings from the wrong country produces numbers nobody in that market actually sees.
Geo-Blocked or Geo-Gated Content
Some catalogs, licensed feeds, and streaming availability pages simply won't render outside their target market at all.
Managing Per-Country Proxy Pools Yourself
Without built-in geo-targeting, you'd need to source, rotate, and maintain your own proxy list for every market you track.
How FineData Solves It
One parameter picks the country. Everything else in the request -- proxy tier, JS rendering, CAPTCHA solving -- works exactly as it does without geo-targeting.
Works With Any Proxy Type
proxy_country works with datacenter, residential, ISP, and mobile proxies. Pick the tier you need for anti-bot strength, then target the country on top.
Zero Extra Cost
Targeting a country adds +0 tokens. You pay the normal cost for the proxy tier you selected -- geo-targeting itself is free on every plan, including Free.
Fails Loud, Not Silent
If a country isn't currently supported for the proxy type you requested, you get a clear 422 response instead of a silent fallback to the wrong region.
One Parameter, Any Market
Loop over ISO-2 country codes and reuse the exact same request shape -- FineData picks a matching exit IP for each one, no separate proxy lists to manage.
proxy_country accepts any ISO-2 country code
Combine with proxy_sticky to keep one IP per country per session
Mutually exclusive with proxy_profile_id (BYOP)
import requests
# Same request, different country -- just change one parameter
for country in ["US", "DE", "JP", "BR"]:
response = requests.post(
"https://api.finedata.ai/api/v1/scrape",
headers={"x-api-key": "fd_your_key"},
json={
"url": "https://example.com/pricing",
"use_residential": True,
"proxy_country": country,
"proxy_sticky": True,
}
)
data = response.json()
print(country, data["tokens_used"]) # geo-targeting itself is +0 tokensAvailable on every plan, including Free. See the Proxy & Geo-Targeting docs for the full reference.
Why Teams Use Geo-Targeting
No Extra Cost
Country targeting is always +0 tokens, on top of whatever proxy tier your request already uses.
Works on Every Plan
No plan gate, unlike Bring Your Own Proxy -- geo-targeting is available starting on the Free tier.
Per-Request Granularity
Mix countries freely across requests in the same batch or job -- no need to pre-provision region-specific proxy pools.
Composable
Combine with proxy_sticky, JS rendering, and CAPTCHA solving -- geo-targeting is just one more request parameter.
Frequently Asked Questions
What is geo-targeting and how do I use it?
proxy_country to an ISO-2
country code (e.g. "DE",
"US",
"JP") on any scrape or async
job request, and FineData routes it through a proxy exit IP in that country -- no separate endpoint or
plan required.
Does geo-targeting cost extra tokens?
proxy_country adds
+0 tokens on top of whatever
proxy tier you choose. You only pay the normal cost for datacenter, residential, ISP, or mobile proxies --
targeting a specific country is free.
Which proxy types support geo-targeting?
proxy_country works
with datacenter, residential, ISP, and mobile proxies. Availability of a specific country can vary by
proxy type -- if a country isn't currently supported for the resolved type, the request returns a
422 instead of silently
routing elsewhere.
Is geo-targeting available on the Free plan?
Can I combine proxy_country with proxy_sticky?
proxy_sticky: true
alongside proxy_country to
keep the same exit IP within that country for an entire session -- useful when a warmup request and a
follow-up API call both need to originate from the same address.
Can I use geo-targeting with a BYOP profile?
proxy_country is mutually
exclusive with proxy_profile_id.
Once you select a Bring Your Own Proxy profile, FineData routes exclusively through your own proxies, so
country selection is controlled by which proxies you added to that profile.
Target Any Country Today
Start with free tokens and add proxy_country to your very first request -- no upgrade, no separate proxy pool, no extra charge.