A UULE code makes Google show results as if you were searching from a given place. Below are the v1 codes for 106 cities in Portugal with at least 15,000 people, largest first. Copy one, or open the search on Google to check it.
106 cities
| City | Region | Population | UULE (v1) | Use |
|---|---|---|---|---|
| Lisbon | Lisbon | 517,802 | w+CAIQICIdTGlzYm9uLExpc2JvbixMaXNib24sUG9ydHVnYWw= | |
| Porto | Porto District | 252,687 | w+CAIQICIdUG9ydG8sUG9ydG8gRGlzdHJpY3QsUG9ydHVnYWw= | |
| Braga | Braga | 193,324 | w+CAIQICIUQnJhZ2EsQnJhZ2EsUG9ydHVnYWw= | |
| Amadora | Lisbon | 178,858 | w+CAIQICIXQW1hZG9yYSxMaXNib24sUG9ydHVnYWw= | |
| Coimbra | Coimbra District | 140,796 | w+CAIQICIhQ29pbWJyYSxDb2ltYnJhIERpc3RyaWN0LFBvcnR1Z2Fs | |
| Leiria | Leiria District | 128,640 | w+CAIQICIfTGVpcmlhLExlaXJpYSBEaXN0cmljdCxQb3J0dWdhbA== | |
| Setubal | Setubal | 118,166 | w+CAIQICIYU2V0dWJhbCxTZXR1YmFsLFBvcnR1Z2Fs | |
| Funchal | Madeira | 105,795 | w+CAIQICIgRnVuY2hhbCxGdW5jaGFsLE1hZGVpcmEsUG9ydHVnYWw= | |
| Viseu | Viseu District | 103,502 | w+CAIQICIjVmlzZXUsVmlzZXUsVmlzZXUgRGlzdHJpY3QsUG9ydHVnYWw= | |
| Queluz | Lisbon | 103,399 | w+CAIQICIWUXVlbHV6LExpc2JvbixQb3J0dWdhbA== | |
| Aveiro | Aveiro District | 80,880 | w+CAIQICIfQXZlaXJvLEF2ZWlybyBEaXN0cmljdCxQb3J0dWdhbA== | |
| Vila Nova de Gaia | Porto District | 70,811 | w+CAIQICIpVmlsYSBOb3ZhIGRlIEdhaWEsUG9ydG8gRGlzdHJpY3QsUG9ydHVnYWw= | |
| Faro | Faro District | 70,347 | w+CAIQICIbRmFybyxGYXJvIERpc3RyaWN0LFBvcnR1Z2Fs | |
| Loures | Lisbon | 66,231 | w+CAIQICIdTG91cmVzLExvdXJlcyxMaXNib24sUG9ydHVnYWw= | |
| Felgueiras | Porto District | 58,065 | w+CAIQICIiRmVsZ3VlaXJhcyxQb3J0byBEaXN0cmljdCxQb3J0dWdhbA== | |
| Rio de Mouro | Lisbon | 54,695 | w+CAIQICIpUmlvIGRlIE1vdXJvLFJpbyBkZSBNb3VybyxMaXNib24sUG9ydHVnYWw= | |
| Odivelas | Lisbon | 54,624 | w+CAIQICIhT2RpdmVsYXMsT2RpdmVsYXMsTGlzYm9uLFBvcnR1Z2Fs | |
| Evora | Evora District | 53,591 | w+CAIQICIdRXZvcmEsRXZvcmEgRGlzdHJpY3QsUG9ydHVnYWw= | |
| Amora | Setubal | 52,577 | w+CAIQICIWQW1vcmEsU2V0dWJhbCxQb3J0dWdhbA== | |
| Corroios | Setubal | 52,520 | w+CAIQICIiQ29ycm9pb3MsQ29ycm9pb3MsU2V0dWJhbCxQb3J0dWdhbA== | |
| Barreiro | Setubal | 51,280 | w+CAIQICIZQmFycmVpcm8sU2V0dWJhbCxQb3J0dWdhbA== | |
| Rio Tinto | Porto District | 49,966 | w+CAIQICIrUmlvIFRpbnRvLFJpbyBUaW50byxQb3J0byBEaXN0cmljdCxQb3J0dWdhbA== | |
| Sao Domingos de Rana | Lisbon | 46,718 | w+CAIQICIkU2FvIERvbWluZ29zIGRlIFJhbmEsTGlzYm9uLFBvcnR1Z2Fs | |
| Figueira da Foz | Coimbra District | 46,600 | w+CAIQICIpRmlndWVpcmEgZGEgRm96LENvaW1icmEgRGlzdHJpY3QsUG9ydHVnYWw= | |
| Guimaraes | Braga | 40,604 | w+CAIQICIYR3VpbWFyYWVzLEJyYWdhLFBvcnR1Z2Fs | |
| Guarda | Guarda District | 40,126 | w+CAIQICImR3VhcmRhLEd1YXJkYSxHdWFyZGEgRGlzdHJpY3QsUG9ydHVnYWw= | |
| Ermesinde | Porto District | 39,420 | w+CAIQICIrRXJtZXNpbmRlLEVybWVzaW5kZSxQb3J0byBEaXN0cmljdCxQb3J0dWdhbA== | |
| Portimao | Faro District | 38,487 | w+CAIQICIfUG9ydGltYW8sRmFybyBEaXN0cmljdCxQb3J0dWdhbA== | |
| Cascais | Lisbon | 36,436 | w+CAIQICIfQ2FzY2FpcyxDYXNjYWlzLExpc2JvbixQb3J0dWdhbA== | |
| Maia | Porto District | 36,426 | w+CAIQICIhTWFpYSxNYWlhLFBvcnRvIERpc3RyaWN0LFBvcnR1Z2Fs | |
| Viana do Castelo | Viana do Castelo District | 36,148 | w+CAIQICJEVmlhbmEgZG8gQ2FzdGVsbyxWaWFuYSBkbyBDYXN0ZWxvLFZpYW5hIGRvIENhc3RlbG8gRGlzdHJpY3QsUG9ydHVnYWw= | |
| Braganca | Braganca District | 35,341 | w+CAIQICIjQnJhZ2FuY2EsQnJhZ2FuY2EgRGlzdHJpY3QsUG9ydHVnYWw= | |
| Oeiras | Lisbon | 35,000 | w+CAIQICIdT2VpcmFzLE9laXJhcyxMaXNib24sUG9ydHVnYWw= | |
| Beja | Beja District | 34,760 | w+CAIQICIbQmVqYSxCZWphIERpc3RyaWN0LFBvcnR1Z2Fs | |
| Almada | Setubal | 34,008 | w+CAIQICIeQWxtYWRhLEFsbWFkYSxTZXR1YmFsLFBvcnR1Z2Fs | |
| Lagos | Faro District | 33,494 | w+CAIQICIcTGFnb3MsRmFybyBEaXN0cmljdCxQb3J0dWdhbA== | |
| Castelo Branco | Castelo Branco District | 33,479 | w+CAIQICIvQ2FzdGVsbyBCcmFuY28sQ2FzdGVsbyBCcmFuY28gRGlzdHJpY3QsUG9ydHVnYWw= | |
| Alcabideche | Lisbon | 33,315 | w+CAIQICIbQWxjYWJpZGVjaGUsTGlzYm9uLFBvcnR1Z2Fs | |
| Espinho | Aveiro District | 32,786 | w+CAIQICIoRXNwaW5obyxFc3BpbmhvLEF2ZWlybyBEaXN0cmljdCxQb3J0dWdhbA== | |
| Arrentela | Setubal | 30,156 | w+CAIQICIaQXJyZW50ZWxhLFNldHViYWwsUG9ydHVnYWw= | |
| Montijo | Setubal | 30,011 | w+CAIQICIYTW9udGlqbyxTZXR1YmFsLFBvcnR1Z2Fs | |
| Santarem | Santarem District | 29,385 | w+CAIQICIsU2FudGFyZW0sU2FudGFyZW0sU2FudGFyZW0gRGlzdHJpY3QsUG9ydHVnYWw= | |
| Olhao | Faro District | 29,239 | w+CAIQICIiT2xoYW8sT2xoYW8sRmFybyBEaXN0cmljdCxQb3J0dWdhbA== | |
| Povoa de Varzim | Porto District | 29,044 | w+CAIQICInUG92b2EgZGUgVmFyemltLFBvcnRvIERpc3RyaWN0LFBvcnR1Z2Fs | |
| Senhora da Hora | Porto District | 28,930 | w+CAIQICInU2VuaG9yYSBkYSBIb3JhLFBvcnRvIERpc3RyaWN0LFBvcnR1Z2Fs | |
| Marinha Grande | Leiria District | 28,916 | w+CAIQICInTWFyaW5oYSBHcmFuZGUsTGVpcmlhIERpc3RyaWN0LFBvcnR1Z2Fs | |
| Povoa de Santa Iria | Lisbon | 28,901 | w+CAIQICIjUG92b2EgZGUgU2FudGEgSXJpYSxMaXNib24sUG9ydHVnYWw= | |
| Matosinhos | Porto District | 28,070 | w+CAIQICItTWF0b3NpbmhvcyxNYXRvc2luaG9zLFBvcnRvIERpc3RyaWN0LFBvcnR1Z2Fs | |
| Gondomar | Porto District | 27,691 | w+CAIQICIpR29uZG9tYXIsR29uZG9tYXIsUG9ydG8gRGlzdHJpY3QsUG9ydHVnYWw= | |
| Aguas Santas | Porto District | 27,686 | w+CAIQICIkQWd1YXMgU2FudGFzLFBvcnRvIERpc3RyaWN0LFBvcnR1Z2Fs | |
| Vila do Conde | Porto District | 27,642 | w+CAIQICIzVmlsYSBkbyBDb25kZSxWaWxhIGRvIENvbmRlLFBvcnRvIERpc3RyaWN0LFBvcnR1Z2Fs | |
| Caldas da Rainha | Leiria District | 27,378 | w+CAIQICIpQ2FsZGFzIGRhIFJhaW5oYSxMZWlyaWEgRGlzdHJpY3QsUG9ydHVnYWw= | |
| Sao Martinho | Madeira | 26,482 | w+CAIQICIdU2FvIE1hcnRpbmhvLE1hZGVpcmEsUG9ydHVnYWw= | |
| Sintra | Lisbon | 26,193 | w+CAIQICIdU2ludHJhLFNpbnRyYSxMaXNib24sUG9ydHVnYWw= | |
| Paco de Arcos | Lisbon | 25,974 | w+CAIQICIdUGFjbyBkZSBBcmNvcyxMaXNib24sUG9ydHVnYWw= | |
| Sao Mamede de Infesta | Porto District | 25,940 | w+CAIQICItU2FvIE1hbWVkZSBkZSBJbmZlc3RhLFBvcnRvIERpc3RyaWN0LFBvcnR1Z2Fs | |
| Torres Vedras | Lisbon | 24,443 | w+CAIQICIrVG9ycmVzIFZlZHJhcyxUb3JyZXMgVmVkcmFzLExpc2JvbixQb3J0dWdhbA== | |
| Quarteira | Faro District | 24,420 | w+CAIQICIqUXVhcnRlaXJhLFF1YXJ0ZWlyYSxGYXJvIERpc3RyaWN0LFBvcnR1Z2Fs | |
| Fanzeres | Porto District | 23,916 | w+CAIQICIgRmFuemVyZXMsUG9ydG8gRGlzdHJpY3QsUG9ydHVnYWw= | |
| Estoril | Lisbon | 23,700 | w+CAIQICIXRXN0b3JpbCxMaXNib24sUG9ydHVnYWw= | |
| Carnaxide | Lisbon | 23,698 | w+CAIQICIZQ2FybmF4aWRlLExpc2JvbixQb3J0dWdhbA== | |
| Porto de Mos | Leiria District | 23,648 | w+CAIQICIlUG9ydG8gZGUgTW9zLExlaXJpYSBEaXN0cmljdCxQb3J0dWdhbA== | |
| Pinhal Novo | Setubal | 23,510 | w+CAIQICIcUGluaGFsIE5vdm8sU2V0dWJhbCxQb3J0dWdhbA== | |
| Pontinha | Lisbon | 23,249 | w+CAIQICIYUG9udGluaGEsTGlzYm9uLFBvcnR1Z2Fs | |
| Portalegre | Portalegre District | 22,368 | w+CAIQICInUG9ydGFsZWdyZSxQb3J0YWxlZ3JlIERpc3RyaWN0LFBvcnR1Z2Fs | |
| Valadares | Porto District | 22,322 | w+CAIQICIhVmFsYWRhcmVzLFBvcnRvIERpc3RyaWN0LFBvcnR1Z2Fs | |
| Sao Joao da Madeira | Aveiro District | 22,079 | w+CAIQICIsU2FvIEpvYW8gZGEgTWFkZWlyYSxBdmVpcm8gRGlzdHJpY3QsUG9ydHVnYWw= | |
| Lavradio | Setubal | 21,877 | w+CAIQICIZTGF2cmFkaW8sU2V0dWJhbCxQb3J0dWdhbA== | |
| Azambuja | Lisbon | 21,422 | w+CAIQICIYQXphbWJ1amEsTGlzYm9uLFBvcnR1Z2Fs | |
| Valongo | Porto District | 21,328 | w+CAIQICInVmFsb25nbyxWYWxvbmdvLFBvcnRvIERpc3RyaWN0LFBvcnR1Z2Fs | |
| Caparica | Setubal | 21,167 | w+CAIQICIZQ2FwYXJpY2EsU2V0dWJhbCxQb3J0dWdhbA== | |
| Belas | Lisbon | 21,019 | w+CAIQICIVQmVsYXMsTGlzYm9uLFBvcnR1Z2Fs | |
| Linda-a-Velha | Lisbon | 20,895 | w+CAIQICIdTGluZGEtYS1WZWxoYSxMaXNib24sUG9ydHVnYWw= | |
| Trofa | Porto District | 20,692 | w+CAIQICIdVHJvZmEsUG9ydG8gRGlzdHJpY3QsUG9ydHVnYWw= | |
| Carcavelos | Lisbon | 20,366 | w+CAIQICIaQ2FyY2F2ZWxvcyxMaXNib24sUG9ydHVnYWw= | |
| Camarate | Lisbon | 20,177 | w+CAIQICIYQ2FtYXJhdGUsTGlzYm9uLFBvcnR1Z2Fs | |
| Ponta Delgada | Azores | 20,056 | w+CAIQICIrUG9udGEgRGVsZ2FkYSxQb250YSBEZWxnYWRhLEF6b3JlcyxQb3J0dWdhbA== | |
| Entroncamento | Santarem District | 19,887 | w+CAIQICIoRW50cm9uY2FtZW50byxTYW50YXJlbSBEaXN0cmljdCxQb3J0dWdhbA== | |
| Custoias | Porto District | 19,406 | w+CAIQICIgQ3VzdG9pYXMsUG9ydG8gRGlzdHJpY3QsUG9ydHVnYWw= | |
| Alges | Lisbon | 19,327 | w+CAIQICIVQWxnZXMsTGlzYm9uLFBvcnR1Z2Fs | |
| Tomar | Santarem District | 19,168 | w+CAIQICIgVG9tYXIsU2FudGFyZW0gRGlzdHJpY3QsUG9ydHVnYWw= | |
| Pedroso | Porto District | 18,963 | w+CAIQICIfUGVkcm9zbyxQb3J0byBEaXN0cmljdCxQb3J0dWdhbA== | |
| Sao Joao da Talha | Lisbon | 18,925 | w+CAIQICIhU2FvIEpvYW8gZGEgVGFsaGEsTGlzYm9uLFBvcnR1Z2Fs | |
| Santa Iria de Azoia | Lisbon | 18,573 | w+CAIQICIjU2FudGEgSXJpYSBkZSBBem9pYSxMaXNib24sUG9ydHVnYWw= | |
| Ovar | Aveiro District | 18,452 | w+CAIQICIdT3ZhcixBdmVpcm8gRGlzdHJpY3QsUG9ydHVnYWw= | |
| Vila Franca de Xira | Lisbon | 18,355 | w+CAIQICIjVmlsYSBGcmFuY2EgZGUgWGlyYSxMaXNib24sUG9ydHVnYWw= | |
| Leca da Palmeira | Porto District | 17,996 | w+CAIQICIoTGVjYSBkYSBQYWxtZWlyYSxQb3J0byBEaXN0cmljdCxQb3J0dWdhbA== | |
| Loule | Faro District | 17,930 | w+CAIQICIcTG91bGUsRmFybyBEaXN0cmljdCxQb3J0dWdhbA== | |
| Moita | Setubal | 17,795 | w+CAIQICIWTW9pdGEsU2V0dWJhbCxQb3J0dWdhbA== | |
| Sacavem | Lisbon | 17,718 | w+CAIQICIXU2FjYXZlbSxMaXNib24sUG9ydHVnYWw= | |
| Covilha | Castelo Branco District | 17,610 | w+CAIQICIwQ292aWxoYSxDb3ZpbGhhLENhc3RlbG8gQnJhbmNvIERpc3RyaWN0LFBvcnR1Z2Fs | |
| Ramada | Lisbon | 17,535 | w+CAIQICIWUmFtYWRhLExpc2JvbixQb3J0dWdhbA== | |
| Quelfes | Faro District | 17,253 | w+CAIQICIeUXVlbGZlcyxGYXJvIERpc3RyaWN0LFBvcnR1Z2Fs | |
| Ilhavo | Aveiro District | 17,236 | w+CAIQICIfSWxoYXZvLEF2ZWlybyBEaXN0cmljdCxQb3J0dWdhbA== | |
| Parede | Lisbon | 17,212 | w+CAIQICIWUGFyZWRlLExpc2JvbixQb3J0dWdhbA== | |
| Sao Pedro da Cova | Porto District | 17,011 | w+CAIQICIpU2FvIFBlZHJvIGRhIENvdmEsUG9ydG8gRGlzdHJpY3QsUG9ydHVnYWw= | |
| Vila Real | Vila Real District | 17,001 | w+CAIQICIlVmlsYSBSZWFsLFZpbGEgUmVhbCBEaXN0cmljdCxQb3J0dWdhbA== | |
| Palmela | Setubal | 16,934 | w+CAIQICIYUGFsbWVsYSxTZXR1YmFsLFBvcnR1Z2Fs | |
| Fafe | Braga | 16,868 | w+CAIQICIYRmFmZSxGYWZlLEJyYWdhLFBvcnR1Z2Fs | |
| Vialonga | Lisbon | 16,088 | w+CAIQICIYVmlhbG9uZ2EsTGlzYm9uLFBvcnR1Z2Fs | |
| Albufeira | Faro District | 15,851 | w+CAIQICIgQWxidWZlaXJhLEZhcm8gRGlzdHJpY3QsUG9ydHVnYWw= | |
| Baguim do Monte | Porto District | 15,850 | w+CAIQICI3QmFndWltIGRvIE1vbnRlLEJhZ3VpbSBkbyBNb250ZSxQb3J0byBEaXN0cmljdCxQb3J0dWdhbA== | |
| Alcobaca | Leiria District | 15,800 | w+CAIQICIhQWxjb2JhY2EsTGVpcmlhIERpc3RyaWN0LFBvcnR1Z2Fs | |
| Alfena | Porto District | 15,211 | w+CAIQICIlQWxmZW5hLEFsZmVuYSxQb3J0byBEaXN0cmljdCxQb3J0dWdhbA== | |
| Tavira | Faro District | 15,133 | w+CAIQICIdVGF2aXJhLEZhcm8gRGlzdHJpY3QsUG9ydHVnYWw= | |
| Torres Novas | Santarem District | 15,002 | w+CAIQICInVG9ycmVzIE5vdmFzLFNhbnRhcmVtIERpc3RyaWN0LFBvcnR1Z2Fs |
Send the code to /v1/google/search and you get structured results for that city. This example searches “florist” from Lisbon, the largest city in the list, with gl=pt and hl=pt-PT.
Request for Lisbon
curl -G "https://api.justserp.com/v1/google/search" \ -H "X-API-Key: YOUR_API_KEY" \ --data-urlencode "q=florist" \ --data-urlencode "uule=w+CAIQICIdTGlzYm9uLExpc2JvbixMaXNib24sUG9ydHVnYWw=" \ --data-urlencode "gl=pt" \ --data-urlencode "hl=pt-PT"
You do not have to encode anything. The location parameter takes the canonical name and JustSERP does the rest.
Request with location
curl -G "https://api.justserp.com/v1/google/search" \ -H "X-API-Key: YOUR_API_KEY" \ --data-urlencode "q=emergency vet" \ --data-urlencode "location=Lisbon,Lisbon,Lisbon,Portugal" \ --data-urlencode "gl=pt" \ --data-urlencode "hl=pt-PT"
Replace YOUR_API_KEY with your key. See the API docs for every parameter.
These are v1 codes, built from Google's canonical city name. A v2 code uses coordinates instead, so it can point at a street or a neighbourhood. The UULE generator and decoder creates one for any coordinates.
Canonical names from Google's public geo targets list. City list and population from GeoNames (CC BY 4.0). Only cities that match one Google location exactly are listed. Results can still differ from what a person in the city sees, because Google also personalises.
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].