Skip to main content
POST
Google Maps search

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
search_terms
string
required

Search terms (comma-separated, up to 5). e.g. restaurant, coffee shop

location
string

Location. e.g. New York, USA

language
enum<string>

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 = 繁體中文

Available options:
af,
az,
id,
ms,
bs,
ca,
cs,
da,
de,
et,
es,
es-419,
eu,
fil,
fr,
gl,
hr,
zu,
is,
it,
sw,
lv,
lt,
hu,
nl,
no,
uz,
pl,
pt-BR,
pt-PT,
ro,
sq,
sk,
sl,
fi,
sv,
vi,
tr,
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
max_items
integer
default:20

Places per search term (up to 1000)

Required range: 1 <= x <= 1000
categories
string[]

Place categories. e.g. abbey, accountant, accounting

search_matching
enum<string>

Name matching. Options: only_includes = Title includes the search term, only_exact = Title matches the search term exactly

Available options:
only_includes,
only_exact
min_rating
enum<string>

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

Available options:
two,
twoAndHalf,
three,
threeAndHalf,
four,
fourAndHalf
website
enum<string>

Website. Options: withWebsite = Only places with a website, withoutWebsite = Only places without a website

Available options:
withWebsite,
withoutWebsite
skip_closed
boolean

Skip closed places

country
enum<string>

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

Available options:
us,
af,
al,
dz,
as,
ad,
ao,
ai,
aq,
ag,
ar,
am,
aw,
au,
at,
az,
bs,
bh,
bd,
bb,
by,
be,
bz,
bj,
bm,
bt,
bo,
ba,
bw,
bv,
br,
io,
bn,
bg,
bf,
bi,
kh,
cm,
ca,
cv,
ky,
cf,
td,
cl,
cn,
cx,
cc,
co,
km,
cg,
cd,
ck,
cr,
ci,
hr,
cu,
cy,
cz,
dk,
dj,
dm,
do,
ec,
eg,
sv,
gq,
er,
ee,
et,
fk,
fo,
fj,
fi,
fr,
gf,
pf,
tf,
ga,
gm,
ge,
de,
gh,
gi,
gr,
gl,
gd,
gp,
gu,
gt,
gn,
gw,
gy,
ht,
hm,
va,
hn,
hu,
is,
in,
id,
ir,
iq,
ie,
il,
it,
jm,
jp,
jo,
kz,
ke,
ki,
kp,
kr,
kw,
kg,
la,
lv,
lb,
ls,
lr,
ly,
li,
lt,
lu,
mo,
mk,
mg,
mw,
my,
mv,
ml,
mt,
mh,
mq,
mr,
mu,
yt,
mx,
fm,
md,
mc,
mn,
me,
ms,
ma,
mz,
mm,
na,
nr,
np,
nl,
an,
nc,
nz,
ni,
ne,
ng,
nu,
nf,
mp,
no,
om,
pk,
pw,
ps,
pa,
pg,
py,
pe,
ph,
pn,
pl,
pt,
pr,
qa,
re,
ro,
ru,
rw,
sh,
kn,
lc,
pm,
vc,
ws,
sm,
st,
sa,
sn,
rs,
sc,
sl,
sg,
sk,
si,
sb,
so,
za,
gs,
ss,
es,
lk,
sd,
sr,
sj,
sz,
se,
ch,
sy,
tw,
tj,
tz,
th,
tl,
tg,
tk,
to,
tt,
tn,
tr,
tm,
tc,
tv,
ug,
ua,
ae,
gb,
um,
uy,
uz,
vu,
ve,
vn,
vg,
vi,
wf,
eh,
ye,
zm,
zw
city
string

City. e.g. New York

state
string

State. e.g. New York

county
string

County. e.g. New York County

postal_code
string

Postal code. e.g. 10001

custom_geolocation
string

Custom search area (GeoJSON, coordinates as [longitude, latitude]). e.g. {"type": "Point", "coordinates": [-73.9857, 40.7484], "radiusKm": 2}

Response

Run completed.

session_id
string

Session identifier for this run.

kind
string

Data source identifier for this endpoint.

search_terms
string[]
location
string
max_items
integer
language
string
categories
any[]
search_matching
string
min_rating
string
website
string
skip_closed
boolean
country
string
city
string
state
string
county
string
postal_code
string
custom_geolocation
any
human
string

Markdown summary of the result, for display.

machine
object

Structured result payload.

active_filters
any[]
points_per_place
integer
total_points
integer

Points charged for this run.