# Geo 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[​](https://serp-api.netnut.io/docs/SERP/API%20Examples/Query%20with%20Location#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](https://site-analyzer.pro/services-seo/uule/) tool. The UULE represents a geographic location, such as a city or region. #### Generating UULE[​](https://serp-api.netnut.io/docs/SERP/API%20Examples/Query%20with%20Location#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](https://site-analyzer.pro/services-seo/uule/) website. **Step 1: Visit the UULE Generator Website**[**​**](https://serp-api.netnut.io/docs/SERP/API%20Examples/Query%20with%20Location#step-1-visit-the-uule-generator-website) Go to the [UULE Generator website](https://site-analyzer.pro/services-seo/uule/). **Step 2: Enter Your Desired Location**[**​**](https://serp-api.netnut.io/docs/SERP/API%20Examples/Query%20with%20Location#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**[**​**](https://serp-api.netnut.io/docs/SERP/API%20Examples/Query%20with%20Location#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**[**​**](https://serp-api.netnut.io/docs/SERP/API%20Examples/Query%20with%20Location#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**[**​**](https://serp-api.netnut.io/docs/SERP/API%20Examples/Query%20with%20Location#step-5-use-the-generated-uule-in-your-api-request) Alt text #### Alternatively[​](https://serp-api.netnut.io/docs/SERP/API%20Examples/Query%20with%20Location#alternatively) ### Using the `uule` Parameter[​](https://serp-api.netnut.io/docs/SERP/API%20Examples/Query%20with%20Location#using-the-uule-parameter) To 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[​](https://serp-api.netnut.io/docs/SERP/API%20Examples/Query%20with%20Location#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 } ] } ``` [Previous](https://serp-api.netnut.io/docs/category/api-examples) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.netnut.io/netnut-documentation/netnut-scraper-apis/serp-api/google-scraper/google-search/geo-location.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.