Skip to main content
Piloterr
Back to library

Google Countries Finder API

Search the list of Google-supported countries by name or country code to use in Google Search API requests.

ActiveFreeGET/v2/finder/google-countries

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

The Google Countries Finder endpoint allows you to search for Piloterr-supported countries for use in Google Search API parameters. Results are ordered by reach: countries reaching the most people appear first. This endpoint is free to use.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/finder/google-countries?query=fr

ParametersLink to Parameters

Parameter Type Required Description
query string yes Case-insensitive search string to filter countries by name or code

Response fieldsLink to Response fields

Field Type Description
country_code string Two-letter ISO country code (e.g. fr, us)
country_name string Full country name (e.g. France)

NotesLink to Notes

  • Results are ordered by population reach
  • Use the country_code value as the gl parameter in Google Search API calls
  • Searching for "FR" returns France, French Guiana, French Polynesia, etc.

Main use casesLink to Main use cases

  • Resolve country names to codes before making localized Google Search requests
  • Build country pickers for Google SERP localization in search tools
  • Validate country inputs before passing them to downstream search APIs
  • Enumerate all available countries for geo-targeted search automation

Related APIs

Expand your data capabilities with these complementary tools.

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included