Google Maps search
run_google_maps_searchRead-onlyIdempotent
Search Google Maps places by keyword and area: name, category, address, phone, website, rating, review count, coordinates and opening hours. Each active search filter (categories, name matching, minimum rating, website, skip closed) adds 2 points per place. 5 points per returned record.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City. e.g. New York | |
| state | No | State. e.g. New York | |
| county | No | County. e.g. New York County | |
| country | No | Country. Options: us = United States, af = Afghanistan, al = Albania, dz = Algeria, as = American Samoa, ad = Andorra, ao = Angola, ai = Anguilla, aq = Antarctica, ag = Antigua and Barbuda, ar = Argentina, am = Armenia, aw = Aruba, au = Australia, at = Austria, az = Azerbaijan, bs = Bahamas, bh = Bahrain, bd = Bangladesh, bb = Barbados, by = Belarus, be = Belgium, bz = Belize, bj = Benin, bm = Bermuda, bt = Bhutan, bo = Bolivia, ba = Bosnia and Herzegovina, bw = Botswana, bv = Bouvet Island, br = Brazil, io = British Indian Ocean Territory, bn = Brunei Darussalam, bg = Bulgaria, bf = Burkina Faso, bi = Burundi, kh = Cambodia, cm = Cameroon, ca = Canada, cv = Cape Verde, ky = Cayman Islands, cf = Central African Republic, td = Chad, cl = Chile, cn = China, cx = Christmas Island, cc = Cocos (Keeling) Islands, co = Colombia, km = Comoros, cg = Congo-Brazzaville, cd = Congo, Democratic Republic of the, ck = Cook Islands, cr = Costa Rica, ci = Cote D'ivoire, hr = Croatia, cu = Cuba, cy = Cyprus, cz = Czech Republic, dk = Denmark, dj = Djibouti, dm = Dominica, do = Dominican Republic, ec = Ecuador, eg = Egypt, sv = El Salvador, gq = Equatorial Guinea, er = Eritrea, ee = Estonia, et = Ethiopia, fk = Falkland Islands, fo = Faroe Islands, fj = Fiji, fi = Finland, fr = France, gf = French Guiana, pf = French Polynesia, tf = French Southern Territories, ga = Gabon, gm = Gambia, ge = Georgia, de = Germany, gh = Ghana, gi = Gibraltar, gr = Greece, gl = Greenland, gd = Grenada, gp = Guadeloupe, gu = Guam, gt = Guatemala, gn = Guinea, gw = Guinea-Bissau, gy = Guyana, ht = Haiti, hm = Heard Island and Mcdonald Islands, va = Vatican City State, hn = Honduras, hu = Hungary, is = Iceland, in = India, id = Indonesia, ir = Iran, iq = Iraq, ie = Ireland, il = Israel, it = Italy, jm = Jamaica, jp = Japan, jo = Jordan, kz = Kazakhstan, ke = Kenya, ki = Kiribati, kp = Korea, Democratic People's Republic of, kr = Korea, kw = Kuwait, kg = Kyrgyzstan, la = Laos, lv = Latvia, lb = Lebanon, ls = Lesotho, lr = Liberia, ly = Libyan Arab Jamahiriya, li = Liechtenstein, lt = Lithuania, lu = Luxembourg, mo = Macao, mk = Macedonia, mg = Madagascar, mw = Malawi, my = Malaysia, mv = Maldives, ml = Mali, mt = Malta, mh = Marshall Islands, mq = Martinique, mr = Mauritania, mu = Mauritius, yt = Mayotte, mx = Mexico, fm = Micronesia, md = Moldova, mc = Monaco, mn = Mongolia, me = Montenegro, ms = Montserrat, ma = Morocco, mz = Mozambique, mm = Myanmar, na = Namibia, nr = Nauru, np = Nepal, nl = Netherlands, an = Netherlands Antilles, nc = New Caledonia, nz = New Zealand, ni = Nicaragua, ne = Niger, ng = Nigeria, nu = Niue, nf = Norfolk Island, mp = Northern Mariana Islands, no = Norway, om = Oman, pk = Pakistan, pw = Palau, ps = Palestine, pa = Panama, pg = Papua New Guinea, py = Paraguay, pe = Peru, ph = Philippines, pn = Pitcairn, pl = Poland, pt = Portugal, pr = Puerto Rico, qa = Qatar, re = Reunion, ro = Romania, ru = Russian Federation, rw = Rwanda, sh = Saint Helena, kn = Saint Kitts and Nevis, lc = Saint Lucia, pm = Saint Pierre and Miquelon, vc = Saint Vincent and the Grenadines, ws = Samoa, sm = San Marino, st = Sao Tome and Principe, sa = Saudi Arabia, sn = Senegal, rs = Serbia, sc = Seychelles, sl = Sierra Leone, sg = Singapore, sk = Slovakia, si = Slovenia, sb = Solomon Islands, so = Somalia, za = South Africa, gs = South Georgia and the South Sandwich Islands, ss = South Sudan, es = Spain, lk = Sri Lanka, sd = Sudan, sr = Suriname, sj = Svalbard and Jan Mayen, sz = Swaziland, se = Sweden, ch = Switzerland, sy = Syrian Arab Republic, tw = Taiwan, tj = Tajikistan, tz = Tanzania, th = Thailand, tl = Timor-Leste, tg = Togo, tk = Tokelau, to = Tonga, tt = Trinidad and Tobago, tn = Tunisia, tr = Turkey, tm = Turkmenistan, tc = Turks and Caicos Islands, tv = Tuvalu, ug = Uganda, ua = Ukraine, ae = United Arab Emirates, gb = United Kingdom, um = United States Minor Outlying Islands, uy = Uruguay, uz = Uzbekistan, vu = Vanuatu, ve = Venezuela, vn = Viet Nam, vg = Virgin Islands, British, vi = Virgin Islands, U.S., wf = Wallis and Futuna, eh = Western Sahara, ye = Yemen, zm = Zambia, zw = Zimbabwe | |
| website | No | Website. Options: withWebsite = Only places with a website, withoutWebsite = Only places without a website | |
| language | No | Language. Options: af = Afrikaans, az = azərbaycan, id = BahasaIndonesia, ms = BahasaMelayu, bs = bosanski, ca = català, cs = Čeština, da = Dansk, de = Deutsch (Deutschland), et = eesti, es = Español (España), es-419 = Español (Latinoamérica), eu = euskara, fil = Filipino, fr = Français (France), gl = galego, hr = Hrvatski, zu = isiZulu, is = íslenska, it = Italiano, sw = Kiswahili, lv = latviešu, lt = lietuvių, hu = magyar, nl = Nederlands, no = norsk, uz = oʻzbekcha, pl = polski, pt-BR = Português (Brasil), pt-PT = Português (Portugal), ro = română, sq = shqip, sk = Slovenčina, sl = slovenščina, fi = Suomi, sv = Svenska, vi = TiếngViệt, tr = Türkçe, el = Ελληνικά, bg = български, ky = кыргызча, kk = қазақтілі, mk = македонски, mn = монгол, ru = Русский, sr = српски (ћирилица), uk = Українська, ka = ქართული, hy = հայերեն, iw = עברית, ur = اردو, ar = العربية, fa = فارسی, am = አማርኛ, ne = नेपाली, hi = हिन्दी, mr = मराठी, bn = বাংলা, pa = ਪੰਜਾਬੀ, gu = ગુજરાતી, ta = தமிழ், te = తెలుగు, kn = ಕನ್ನಡ, ml = മലയാളം, si = සිංහල, th = ไทย, lo = ລາວ, my = ဗမာ, km = ខ្មែរ, ko = 한국어, ja = 日本語, zh-CN = 简体中文, zh-TW = 繁體中文 | |
| location | No | Location. e.g. New York | |
| max_items | No | Places per search term (up to 1000) Default: 20. | |
| categories | No | Place categories. e.g. abbey, accountant, accounting | |
| min_rating | No | Minimum star rating. Options: two = 2+ stars, twoAndHalf = 2.5+ stars, three = 3+ stars, threeAndHalf = 3.5+ stars, four = 4+ stars, fourAndHalf = 4.5+ stars | |
| postal_code | No | Postal code. e.g. 10001 | |
| skip_closed | No | Skip closed places | |
| search_terms | Yes | Search terms (comma-separated, up to 5). e.g. restaurant, coffee shop | |
| search_matching | No | Name matching. Options: only_includes = Title includes the search term, only_exact = Title matches the search term exactly | |
| custom_geolocation | No | Custom search area (GeoJSON, coordinates as [longitude, latitude]). e.g. {"type": "Point", "coordinates": [-73.9857, 40.7484], "radiusKm": 2} |