Skip to main content
Network status
Log in
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
Try endpoint for freeAutom

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.

View All
Chewy Products Finder/v2/finder/chewy-products

Find Chewy product URLs by product name, ID, or any combination of filters to use in product detail and rendering API calls.

GETFreeActive
Eleclerc Stores Finder/v2/finder/eleclerc-stores

Search Eleclerc stores by name or city to retrieve contact details, opening hours, and geolocation.

GETFreeActive
Google Languages Finder/v2/finder/google-languages

Search the list of Google-supported languages by name to retrieve language codes for use in Google Search API requests.

GETFreeActive
Google Locations Finder/v2/finder/google-locations

Search Google-supported locations by name to retrieve location IDs and GPS coordinates for geo-targeted search API calls.

GETFreeActive
Intermarché Stores Finder/v2/finder/intermarche-stores

Look up an Intermarché store before you search products. Pass a city, a postal code, or a store name and read the shop id that Search and Product expect.

GETFree
Leroy Merlin Products Finder/v2/finder/leroymerlin-products

Find Leroy Merlin product URLs by product name, ID, or any combination of filters to use in product detail and rendering API calls.

GETFreeActive
Leroy Merlin Stores Finder/v2/finder/leroymerlin-stores

Search Leroy Merlin stores by name, city or postal code to retrieve their store ID, slug, address and store locator URL.

GETFreeActive
LinkedIn Industries Finder/v2/finder/linkedin-industries

Search LinkedIn industry taxonomy to retrieve industry IDs and hierarchies for use in LinkedIn API calls and data enrichment.

GETFreeActive
Mr.Bricolage Stores Finder/v2/finder/mrbricolage-stores

Search Mr.Bricolage stores by name, city or postal code to retrieve their store ID, slug, contact information and geolocation.

GETFreeActive

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
Start free (+500 credits)AutomTalk to a data expert