Available Countries

Retrieve the list of countries supported for geo-targeted SERP parsing.

Endpoint

GET /api/parsing/geo/countries

Example Request

curl https://app.scrapering.com/api/parsing/geo/countries \
  --header 'Authorization: Bearer YOUR_API_KEY'

Example Response

{
  "countries": [
    {
      "code": "GB",
      "name": "United Kingdom",
      "canonical_name": "United Kingdom"
    },
    {
      "code": "US",
      "name": "United States",
      "canonical_name": "United States"
    }
  ]
}

Response Fields

Field	Type	Description
countries[].code	string	ISO country code (e.g. `US`, `GB`)
countries[].name	string	Country name in English
countries[].canonical_name	string	Canonical name used for Google geo-targeting

Using Country Data

Pass code.toLowerCase() as gl in Google SERP requests for country-level geo-targeting:

{
  "q": "pizza delivery",
  "count": 10,
  "gl": "us"
}

For city-level targeting, use the Available cities endpoint.

Next steps

Available cities — look up cities and Yandex region codes within a country
Google SERP Scraper — use gl for country-level targeting
Yandex SERP Scraper — use region for city-level targeting