# Google Countries Finder

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/finder/google-countries` |
| **Base URL** | `https://api.autom.dev` |
| **Credit Cost** | 0 credits per call |
| **Documentation** | https://www.piloterr.com/library/finder-google-countries |

## Description

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

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.autom.dev/register

## Example Request

```bash
curl --location --request GET 'https://api.autom.dev/v2/finder/google-countries' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search by query 'fr'

```json
[
  {
    "country_code": "fr",
    "country_name": "France"
  },
  {
    "country_code": "gf",
    "country_name": "French Guiana"
  },
  {
    "country_code": "pf",
    "country_name": "French Polynesia"
  },
  {
    "country_code": "tf",
    "country_name": "French Southern Territories"
  }
]
```

## Documentation

## 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.

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

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

## 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`) |

## 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 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