Create a Google UULE parameter from a location name or GPS coordinates, or decode one you already have. Encoding and decoding happen in your browser, and the tool is free.
Generate a UULE from a location name
Search for a city, region, country or postal code. We match against Google's list of canonical names, which is what UULE v1 needs.
You can generate from text you typed, but Google only honours exact canonical names. Pick a result from the list when you can.
Generate a UULE from GPS coordinates
UULE v2 targets a point on the map instead of a named place. Paste "40.7128, -74.0060" into the latitude field and we will split it for you.
A radius of -1 means unspecified.
Decode a UULE
Paste a UULE value, a uule= parameter, or a whole Google URL. We detect the format for you.
What is UULE?
UULE is the parameter Google uses to pin a search to a location. It is a short string added to the search URL, and it is how location-specific results can be checked from anywhere.
UULE v1 and v2
v1 starts with w+. It holds a canonical location name in a small binary format, then base64. The name must match Google's list exactly.
v2 starts with a+. It holds plain text with latitude and longitude scaled by ten million, a radius, and a timestamp in microseconds, then base64. Any point on the map works, which makes it handy when no named place fits.
Using UULE with gl and hl
Set gl to the two letter country code and hl to the language, then add uule. Keep the plus sign in the value as it is. Our examples above already do this.
UULE examples with the Google Search API
Each example pairs a canonical name with its UULE, a Google URL you can open, and a JustSERP request that sends the same UULE.
Coffee shops in Seattle
Check what a local searcher sees for a place-based query.
A v2 UULE includes a timestamp, so this value changes each time the page loads.
Frequently asked questions
What is a UULE?
UULE is a URL parameter that tells Google which location to use for a search. Add it to a Google search URL and the results are tailored to that place, no matter where the request comes from.
What is the difference between v1 and v2?
v1 values start with w+ and encode a canonical location name such as "Chicago,Illinois,United States". Google only accepts names from its own list. v2 values start with a+ and encode latitude and longitude, plus an optional radius and a timestamp. Because of the timestamp, a v2 value changes every time you make one.
How do I use a UULE with gl and hl?
gl sets the country and hl sets the interface language. UULE sets the place. Use all three together, for example gl=us&hl=en&uule=..., so the country, language and location agree with each other.
Why does my UULE not change the results?
The most common cause is a canonical name that is not exactly on Google's list, including wrong spacing or capitalisation. Pick a result from the search box above to get an exact name. Google may also ignore a UULE on some requests.
Do I need a UULE with the JustSERP API?
No. Pass a location name in the location parameter and we handle the rest. See our API docs for details.
JustSERP was born out of our own need to scrape google search results to parse data for analytical and processing needs. We have gone through the excruciating process of running automated web search queries by bypassing bot filters, solving captchas and parsing convoluted HTML. It is our pleasure to share our expertise with others through this affordable, fast and reliable SERP API. Don't hesitate to contact us with any questions at [email protected].
