ScreenshotNeo

BlogHow-to

How to Capture a Website Screenshot from a Specific Country with GrabzIt

Set GrabzIt’s country option to SG, UK, or US to capture from a supported region. Here are REST examples, limits, and troubleshooting steps.

By the ScreenshotNeo team4 October 20266 min read

To capture a website screenshot from a specific country with GrabzIt, set the capture’s country parameter to one of its three documented values: SG for Singapore, UK for the United Kingdom, or US for the United States. GrabzIt documents country-specific capture through its API and online screenshot tool. If you omit the option, it uses the current fastest location, which does not promise a particular country. [GrabzIt’s location-specific screenshots guide]

The country option chooses a supported capture region; it does not guarantee that every person in that country would see identical content. The reviewed documentation lists only these three country values. If you need another country, contact GrabzIt support to ask whether it may be available.

Choose a supported country

Value Capture region
SG Singapore
UK United Kingdom
US United States

GrabzIt says US captures use one of its New York, Chicago, or Miami servers, while UK captures use its London data center. The documentation does not promise a particular city for each request or a response-time guarantee. [Location-specific screenshots]

Capture a screenshot with GrabzIt’s REST API

  1. Get your GrabzIt application key from your account.
  2. Choose SG, UK, or US.
  3. Send a request to the REST endpoint with the webpage URL and country.
  4. Save the returned response as an image file and inspect the result.

The REST API documents country as an optional capture parameter, with the current fastest location as its default. Its endpoint is https://api.grabz.it/convert. Use the exact parameter names and encoding shown below; URL-encode the target address. Keep the application key on the server, since putting it into browser-side code exposes it. [GrabzIt REST API documentation]

cURL

curl --fail --show-error --location --get 'https://api.grabz.it/convert' \
  --data-urlencode 'key=YOUR_APPLICATION_KEY' \
  --data-urlencode 'url=https://www.bbc.com/' \
  --data-urlencode 'country=US' \
  --output screenshot.jpg

Replace the example target with the page you want to capture. The REST docs show the capture returned in the HTTP response. Choose an output filename and format appropriate to the format configured for your account or request; the example uses a JPEG filename. Check the response if the request fails instead of assuming every response body is an image.

Python with requests

import requests

response = requests.get(
    "https://api.grabz.it/convert",
    params={
        "key": "YOUR_APPLICATION_KEY",
        "url": "https://www.bbc.com/",
        "country": "US",
    },
    timeout=90,
)
response.raise_for_status()

with open("screenshot.jpg", "wb") as image_file:
    image_file.write(response.content)

Node.js with fetch

const params = new URLSearchParams({
  key: process.env.GRABZIT_APPLICATION_KEY,
  url: 'https://www.bbc.com/',
  country: 'US',
});

const response = await fetch(`https://api.grabz.it/convert?${params}`);
if (!response.ok) {
  throw new Error(`GrabzIt request failed: HTTP ${response.status}`);
}

const image = Buffer.from(await response.arrayBuffer());
await import('node:fs/promises').then(({ writeFile }) =>
  writeFile('screenshot.jpg', image)
);

Run Node.js code in a server-side environment and set GRABZIT_APPLICATION_KEY in that environment. Do not embed the key in frontend JavaScript. Consult the [REST reference] for current authentication and capture parameters.

Use the country option in a GrabzIt client library or online tool

If you already use a GrabzIt language library, pass the country through that library’s capture options rather than translating an enum or method name from another SDK. The official location guide provides language-specific examples; for example, its .NET example assigns Country.US to an ImageOptions object. The Node.js reference also accepts country in capture options. Check the documentation for your particular SDK version for exact setup and method names. [Language examples; Node.js technical documentation]

The online screenshot tool also supports location-specific screenshots. Select the country setting there if you want to make an occasional capture without integrating an API. The reviewed sources establish that the option is supported, but do not establish a pricing or feature comparison among the tool, REST API, and language libraries.

What country targeting changes—and what it does not

A country parameter selects a capture from one of GrabzIt’s documented regions. That can help inspect localized pages, regional advertisements, or region-locked sites. It does not by itself establish that the captured page matches a particular person’s complete browsing context.

  • Supported locations are limited: use only SG, UK, or US according to the reviewed docs. Do not assume arbitrary ISO country codes work.
  • Location is one variable: account state, cookies, language preferences, personalization, network conditions, and site behavior can affect what a page displays. The country option is not documented as simulating all of those conditions.
  • Other capture options are separate: viewport dimensions and delay can affect what appears in the image, but they do not change the selected country. Check the API or SDK reference for the options available in your interface.
  • Default selection is not deterministic by country: leaving country out selects the documented current fastest location, not a predictable country.

Troubleshooting

Symptom Likely cause What to do
The result appears to come from the wrong region. The country parameter was omitted, misspelled, or not passed through the SDK option. Set exactly SG, UK, or US and confirm the outgoing request or capture options include it.
A country value is rejected or has no effect. The value is not one of the documented options, or the client library expects a language-specific enum. Use a documented value and check the reference for the SDK and version you are using.
The page is blank or incomplete. The page may need time to render, may depend on browser state, or may block the capture environment. Inspect the target in a normal browser, check any available capture error details, and consult the relevant GrabzIt capture options for delay or viewport settings. Do not treat country selection as a fix for every page-rendering issue.
The saved file is not a readable image. The request may have returned an error response rather than capture data, or the selected output format and filename do not match. Check the HTTP status and response before saving, and verify the output format configured for the request.
The request fails with an authentication error. The application key is absent, invalid, or passed under the wrong parameter name. Confirm the key and the REST authentication instructions. Keep credentials server-side.
The required country is not available. The reviewed documentation lists only Singapore, the UK, and the US. Contact GrabzIt support and ask about availability; support says additional countries may be considered if demand warrants it, not that a request will be accepted.

Performance, reliability, and cost considerations

GrabzIt documents the fastest available location as the default and describes its three server regions as chosen to divide the globe into roughly equal areas. That is not a latency guarantee. A geographically closer capture server may be useful for regional content checks, but actual completion time can also depend on the target page and its resources.

For repeatable comparisons, keep the country, URL, viewport, and any relevant capture settings consistent between runs. If a regional page varies due to cookies, login state, or personalization, record and control those conditions separately where the workflow allows. The research sources reviewed for this guide do not establish GrabzIt pricing, quotas, or capture-time guarantees; check its current account and plan information before estimating cost.

Or skip the browser setup

ScreenshotNeo is a website screenshot API and MCP server from ScreenshotNeo. Its one-call API returns an image or PDF, and its documentation covers the available options. This is a general capture alternative; the ScreenshotNeo facts provided here do not establish country-specific capture, so use GrabzIt’s country option when a supported geographic region is required.

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

ScreenshotNeo removes cookie banners, popups, and chat widgets before the shot. Bot checks, blank pages, and failed loads are never billed. Its MCP server lets AI agents take screenshots. The free plan includes 1,000 screenshots a month with no card, and paid plans start at $5 for 3,000. Sign up for 1,000 free screenshots a month.

Frequently asked questions

Can I capture a website as it appears in any country?

The reviewed GrabzIt documentation lists Singapore, the UK, and the US. Ask support about other locations; availability is not guaranteed.

Does the country option change the visitor’s language?

The country setting selects a capture region. The cited documentation does not promise a particular language, account state, or personalization outcome.

Can I use country targeting for regional ad checks?

Yes, GrabzIt identifies regional-ad verification as a use case. Treat the result as a capture from the selected supported region, not proof of what every local user sees.

What happens if I leave out country?

GrabzIt documents the current fastest location as the default. That default does not select a predictable country.