Geo-targeting¶

The Search API supports two levels of geo-targeting: country/language via queryParameters, and domain selection via domain.

Country and language¶

Pass queryParameters to control the country and language of results.

Engine-specific (recommended)¶

Pass engine-native parameters using style: "engineSpecific":

{
    "domain": "search.engine.com",
    "query": "pizza restaurants",
    "queryParameters": {
        "style": "engineSpecific",
        "gl": "us",
        "hl": "en"
    }
}

Generic¶

Use the portable geolocation and locale fields:

{
    "domain": "search.engine.com",
    "query": "pizza restaurants",
    "queryParameters": {
        "style": "generic",
        "geolocation": "US",
        "locale": "en-US"
    }
}

Targeting a regional domain¶

To get results from a country-specific domain, change the domain field. The platform fetches from that domain directly:

{
    "domain": "search.engine.com",
    "query": "pizza restaurants",
    "queryParameters": {
        "style": "engineSpecific",
        "gl": "de",
        "hl": "de"
    }
}

Supported domains include regional variants such as google.com, google.co.uk, google.de, google.fr, google.co.jp, google.com.br. Unsupported domains return a 400 error.

City-level targeting¶

For city-level precision, pass a uule value in queryParameters:

{
    "domain": "search.engine.com",
    "query": "pizza restaurants",
    "queryParameters": {
        "style": "engineSpecific",
        "uule": "w+CAIQICINY2hpY2Fnbywgsuited"
    }
}

Note

The uule parameter uses the canonical w+ format. Generate a value from a city name using the uule_grabber Python library:

import uule_grabber
uule_grabber.uule("Chicago, USA")  # w+CAIQ...