Query with Geographic Location
This documentation explains how to use the uule parameter with the SERP API to specify a geographic location for your search. This can be helpful for getting location-specific search results.
Parameter for Geographic Location
The SERP API provides an optional parameter for specifying the geographic location:
uule(Optional): This parameter is the Google-encoded location you want to use for the search. You can generate a UULE value using the UULE Generator tool. The UULE represents a geographic location, such as a city or region.
Generating UULE
When working with the SERP API and you want to obtain location-specific search results, you can use a UULE parameter. This parameter represents a specific geographic location, allowing you to customize your API requests. This guide will walk you through the process of generating a UULE parameter using the site-analyzer.pro website.
Step 1: Visit the UULE Generator Website
Go to the UULE Generator website.
Step 2: Enter Your Desired Location
On the UULE Generator webpage, you'll find an input field or form where you can specify your desired geographic location. Enter the name of the city, region, or location you want to use for your search.
Step 3: Generate the UULE
Click on the "Generate" button or similar action on the website. The tool will process your input and generate a UULE value associated with the specified location.
Step 4: Copy the Generated UULE
Once the UULE has been generated, you'll typically see it displayed on the website interface. It may appear as a string of characters. Click on the UULE or use a provided button to copy it to your clipboard.
Step 5: Use the Generated UULE in Your API Request
Alternatively
Using the uule Parameter
uule ParameterTo customize your SERP API request with a specific geographic location, include the uule parameter in your GET request. Here's an example using various programming languages:
Bash
Javascript
Python
Go
curl -L 'https://serp-api.netnut.io/search?device=desktop&q=news&uule=w+CAIQICIFcGFyaXM' \
-H 'Accept: application/json' \
-H 'Authorization: Basic base64(username:password)'
Also, you can just write area, city or a country and we will automatically convert it into UULE
Bash
Javascript
Python
Go
curl -L 'https://serp-api.netnut.io/search?device=desktop&q=news&uule=paris' \
-H 'Accept: application/json' \
-H 'Authorization: Basic base64(username:password)'
API Response
The API will respond with a JSON object containing the search results. Here is an example of the response:
{
"url": "https://www.google.com/search?q=news&uule=w+CAIQICIFcGFyaXM",
"general": {
"searchEngine": "google",
"resultsCount": 25270000000,
"searchTime": 0.3,
"mobile": false,
"searchType": "text",
"pageTitle": "news - Google Search",
"timestamp": "2023-10-01T13:02:25.178Z"
},
"input": {
"originalUrl": "https://www.google.com/search?q=news&uule=w+CAIQICIFcGFyaXM",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36",
"jobId": "7afabd61-1b55-4570-b852-5d03428be51b"
},
"organic": [
{
"title": "Google News",
"description": "6 hours ago — Comprehensive up-to-date news coverage, aggregated from sources all over the world by Google News.",
"link": "https://news.google.com/",
"displayLink": "https://news.google.com",
"rank": 1,
"globalRank": 1
},
{
"title": "NBC News - Breaking News & Top Stories - Latest World, US ...",
"description": "Go to NBCNews.com for breaking news, videos, and the latest top stories in world news, business, politics, health and pop culture.",
"link": "https://www.nbcnews.com/",
"displayLink": "https://www.nbcnews.com",
"rank": 2,
"globalRank": 2
},
{
"title": "CNN: Breaking News, Latest News and Videos",
"description": "7 hours ago — View the latest news and breaking news today for U.S., world, weather, entertainment, politics and health at CNN.com.",
"link": "https://www.cnn.com/",
"displayLink": "https://www.cnn.com",
"rank": 3,
"globalRank": 3
},
{
"title": "Fox News - Breaking News Updates | Latest News Headlines ...",
"description": "23 hours ago — Breaking News, Latest News and Current News from FOXNews.com. Breaking news and video. Latest Current News: U.S., World, Entertainment, ...",
"link": "https://www.foxnews.com/",
"displayLink": "https://www.foxnews.com",
"rank": 4,
"globalRank": 4
},
{
"title": "ABC News - Breaking News, Latest News and Videos",
"description": "5 hours ago — Your trusted source for breaking news, analysis, exclusive interviews, headlines, and videos at ABCNews.com.",
"link": "https://abcnews.go.com/",
"displayLink": "https://abcnews.go.com",
"rank": 5,
"globalRank": 5
},
{
"title": "CBS News - Breaking news, 24/7 live streaming news & top ...",
"description": "5 hours ago — Watch CBS News live and get the latest, breaking news headlines of the day for national news and world news today.",
"link": "https://www.cbsnews.com/",
"displayLink": "https://www.cbsnews.com",
"rank": 6,
"globalRank": 6
},
{
"title": "Yahoo News - Latest News & Headlines",
"description": "7 hours ago — The latest news and headlines from Yahoo! News. Get breaking news stories and in-depth coverage with videos and photos.",
"link": "https://news.yahoo.com/",
"displayLink": "https://news.yahoo.com",
"rank": 7,
"globalRank": 7
},
{
"title": "Associated Press News: Breaking News, Latest Headlines ...",
"description": "6 hours ago — Read the latest headlines, breaking news, and videos at APNews.com, the definitive source for independent journalism from every corner of the globe.",
"link": "https://apnews.com/",
"displayLink": "https://apnews.com",
"rank": 8,
"globalRank": 8
}
],
"pagination": {
"currentPage": 1,
"nextPage": 2,
"nextPageLink": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=10&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAE",
"nextPageStart": 10,
"otherPages": {
"2": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=10&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAE",
"3": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=20&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAG",
"4": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=30&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAI",
"5": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=40&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAK",
"6": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=50&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAM",
"7": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=60&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAO",
"8": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=70&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAQ",
"9": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=80&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAS",
"10": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=90&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAU"
}
},
"related": [
{
"listGroup": false,
"link": "https://www.google.com/search?sca_esv=569845833&q=Local+news&sa=X&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q1QJ6BAgwEAE",
"text": "local news",
"rank": 1,
"globalRank": 9
},
{
"listGroup": false,
"link": "https://www.google.com/search?sca_esv=569845833&q=Breaking+news+headlines&sa=X&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q1QJ6BAgrEAE",
"text": "breaking news headlines",
"rank": 2,
"globalRank": 10
},
{
"listGroup": false,
"link": "https://www.google.com/search?sca_esv=569845833&q=News+Trump&sa=X&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q1QJ6BAgpEAE",
"text": "news trump",
"rank": 3,
"globalRank": 11
},
{
"listGroup": false,
"link": "https://www.google.com/search?sca_esv=569845833&q=Google+News&sa=X&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q1QJ6BAgnEAE",
"text": "google news",
"rank": 4,
"globalRank": 12
},
{
"listGroup": false,
"link": "https://www.google.com/search?sca_esv=569845833&q=News+today+in+the+world&sa=X&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q1QJ6BAglEAE",
"text": "news today in the world",
"rank": 5,
"globalRank": 13
},
{
"listGroup": false,
"link": "https://www.google.com/search?sca_esv=569845833&q=World+news&sa=X&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q1QJ6BAgjEAE",
"text": "world news",
"rank": 6,
"globalRank": 14
},
{
"listGroup": false,
"link": "https://www.google.com/search?sca_esv=569845833&q=Define+news&sa=X&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q1QJ6BAghEAE",
"text": "define news",
"rank": 7,
"globalRank": 15
},
{
"listGroup": false,
"link": "https://www.google.com/search?sca_esv=569845833&q=News+NYC&sa=X&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q1QJ6BAgfEAE",
"text": "news nyc",
"rank": 8,
"globalRank": 16
}
]
}Last updated