API · country parameter
Usage Examples
Pass the ISO 3166-1 alpha-2 code from the first column — FR,
not France and not Fr. The lookup is exact, and
a value it does not recognise falls back to the United States defaults
rather than reporting an error.
When you use the country parameter, the system
automatically sets the default language, time zone, and geolocation for
that country:
https://api.site-shot.com/?url=https://example.com&userkey=YOUR_API_KEY&country=FRThis will use French language, Europe/Paris time zone, and Paris geolocation (48.8566,2.3522).
You can override any of these defaults by explicitly specifying the parameters:
https://api.site-shot.com/?url=https://example.com&userkey=YOUR_API_KEY&country=FR&language=enThis will use French proxy IP, but English language instead of French.
When a country is not available
This list follows live, verified proxy capacity, so a country that worked last month can be absent today. By default that is silent: the capture falls back to a United States proxy and returns a normal screenshot. The request succeeds — from the wrong country.
Add strict_country=1 when the country matters more than
getting an image back. The request then fails fast with
"error": "country_unavailable" instead of quietly
capturing from somewhere else:
https://api.site-shot.com/?url=https://example.com&userkey=YOUR_API_KEY&country=DE&strict_country=1
It applies only when country is set, and only when you set
it explicitly — it is never inferred.
Who can use these countries
Choosing a country needs an active subscription, which starts at $5/mo, and works the same way through the API and in the browser tool once you are signed in. The free browser tool captures directly, without a proxy, and offers the United States as its one country choice.