SearchParams
- MOD1
The search query string
query string test
Possible values: [main
, images
, news
, videos
]
Default value: main
The type of search to perform, please note that type of search will have a slightly different json output format, for the extact format you can check out our documentation or use our playground where you can test the API
Possible values: >= 1
and <= 100
The page number of results to retrieve
Please note: Google does not serve more than 1000 results for any query.
Possible values: [desktop
, mobile
, tablet
]
Default value: desktop
The device type to simulate
location
object
The location to use for the search check our documentation about the location in order to see available values click here
Please note that for the best results, along with your location you should also set gl
and hl
parameters and/or cr
and lr
anyOf
string
Possible values: [google.ad
, google.ae
, google.al
, google.am
, google.as
, google.at
, google.az
, google.ba
, google.be
, google.bf
, google.bg
, google.bi
, google.bj
, google.bs
, google.bt
, google.by
, google.ca
, google.cd
, google.cf
, google.cg
, google.ch
, google.ci
, google.cl
, google.cm
, google.co.ao
, google.co.bw
, google.co.ck
, google.co.cr
, google.co.id
, google.co.il
, google.co.in
, google.co.jp
, google.co.ke
, google.co.kr
, google.co.ls
, google.co.ma
, google.co.mz
, google.co.nz
, google.co.th
, google.co.tz
, google.co.ug
, google.co.uk
, google.co.uz
, google.co.ve
, google.co.vi
, google.co.za
, google.co.zm
, google.co.zw
, google.com
, google.com.af
, google.com.ag
, google.com.ai
, google.com.ar
, google.com.au
, google.com.bd
, google.com.bh
, google.com.bn
, google.com.bo
, google.com.br
, google.com.bz
, google.com.co
, google.com.cu
, google.com.cy
, google.com.do
, google.com.ec
, google.com.eg
, google.com.et
, google.com.fj
, google.com.gh
, google.com.gi
, google.com.gt
, google.com.hk
, google.com.jm
, google.com.kh
, google.com.kw
, google.com.lb
, google.com.ly
, google.com.mm
, google.com.mt
, google.com.mx
, google.com.my
, google.com.na
, google.com.ng
, google.com.ni
, google.com.np
, google.com.om
, google.com.pa
, google.com.pe
, google.com.pg
, google.com.ph
, google.com.pk
, google.com.pr
, google.com.py
, google.com.qa
, google.com.sa
, google.com.sb
, google.com.sg
, google.com.sl
, google.com.sv
, google.com.tj
, google.com.tr
, google.com.tw
, google.com.ua
, google.com.uy
, google.com.vc
, google.com.vn
, google.cv
, google.cz
, google.de
, google.dj
, google.dk
, google.dm
, google.dz
, google.ee
, google.es
, google.fi
, google.fm
, google.fr
, google.ga
, google.ge
, google.gl
, google.gm
, google.gp
, google.gr
, google.gy
, google.hn
, google.hr
, google.ht
, google.hu
, google.ie
, google.iq
, google.is
, google.it
, google.je
, google.jo
, google.kg
, google.ki
, google.kz
, google.la
, google.li
, google.lk
, google.lt
, google.lu
, google.lv
, google.md
, google.mg
, google.mk
, google.ml
, google.mn
, google.ms
, google.mu
, google.mv
, google.mw
, google.ne
, google.nl
, google.no
, google.nr
, google.nu
, google.pl
, google.ps
, google.pt
, google.ro
, google.rs
, google.ru
, google.rw
, google.sc
, google.se
, google.sh
, google.si
, google.sk
, google.sm
, google.sn
, google.so
, google.sr
, google.td
, google.tg
, google.tk
, google.tl
, google.tm
, google.tn
, google.to
, google.tt
, google.vg
, google.vu
, google.ws
]
Default value: google.com
The Google domain to use for your search
Possible values: [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
, hk
, hu
, is
, in
, id
, ir
, iq
, ie
, il
, it
, je
, 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
, 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
, 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
, uk
, gb
, us
, um
, uy
, uz
, vu
, ve
, vn
, vg
, vi
, wf
, eh
, ye
, zm
, zw
]
The country code for the search, in order to use this param, you must also set hl
Possible values: [af
, ak
, sq
, ws
, am
, ar
, hy
, az
, eu
, be
, bem
, bn
, bh
, xx-bork
, bs
, br
, bg
, bt
, km
, ca
, chr
, ny
, zh-cn
, zh-tw
, co
, hr
, cs
, da
, nl
, xx-elmer
, en
, eo
, et
, ee
, fo
, tl
, fi
, fr
, fy
, gaa
, gl
, ka
, de
, el
, kl
, gn
, gu
, xx-hacker
, ht
, ha
, haw
, iw
, he
, hi
, hu
, is
, ig
, id
, ia
, ga
, it
, ja
, jw
, kn
, kk
, rw
, rn
, xx-klingon
, kg
, ko
, kri
, ku
, ckb
, ky
, lo
, la
, lv
, ln
, lt
, loz
, lg
, ach
, mk
, mg
, ms
, ml
, mt
, mv
, mi
, mr
, mfe
, mo
, mn
, sr-me
, my
, ne
, pcm
, nso
, no
, nn
, oc
, or
, om
, ps
, fa
, xx-pirate
, pl
, pt
, pt-br
, pt-pt
, pa
, qu
, ro
, rm
, nyn
, ru
, gd
, sr
, sh
, st
, tn
, crs
, sn
, sd
, si
, sk
, sl
, so
, es
, es-419
, su
, sw
, sv
, tg
, ta
, tt
, te
, th
, ti
, to
, lua
, tum
, tr
, tk
, tw
, ug
, uk
, ur
, uz
, vu
, vi
, cy
, wo
, xh
, yi
, yo
, zu
]
The language code for the search
Possible values: [countryAF
, countryAL
, countryDZ
, countryAS
, countryAD
, countryAO
, countryAI
, countryAQ
, countryAG
, countryAR
, countryAM
, countryAW
, countryAU
, countryAT
, countryAZ
, countryBS
, countryBH
, countryBD
, countryBB
, countryBY
, countryBE
, countryBZ
, countryBJ
, countryBM
, countryBT
, countryBO
, countryBA
, countryBW
, countryBV
, countryBR
, countryIO
, countryBN
, countryBG
, countryBF
, countryBI
, countryKH
, countryCM
, countryCA
, countryCV
, countryKY
, countryCF
, countryTD
, countryCL
, countryCN
, countryCX
, countryCC
, countryCO
, countryKM
, countryCG
, countryCD
, countryCK
, countryCR
, countryCI
, countryHR
, countryCU
, countryCY
, countryCZ
, countryDK
, countryDJ
, countryDM
, countryDO
, countryEC
, countryEG
, countrySV
, countryGQ
, countryER
, countryEE
, countryET
, countryFK
, countryFO
, countryFJ
, countryFI
, countryFR
, countryGF
, countryPF
, countryTF
, countryGA
, countryGM
, countryGE
, countryDE
, countryGH
, countryGI
, countryGR
, countryGL
, countryGD
, countryGP
, countryGU
, countryGT
, countryGN
, countryGW
, countryGY
, countryHT
, countryHM
, countryVA
, countryHN
, countryHK
, countryHU
, countryIS
, countryIN
, countryID
, countryIR
, countryIQ
, countryIE
, countryIL
, countryIT
, countryJE
, countryJM
, countryJP
, countryJO
, countryKZ
, countryKE
, countryKI
, countryKP
, countryKR
, countryKW
, countryKG
, countryLA
, countryLV
, countryLB
, countryLS
, countryLR
, countryLY
, countryLI
, countryLT
, countryLU
, countryMO
, countryMK
, countryMG
, countryMW
, countryMY
, countryMV
, countryML
, countryMT
, countryMH
, countryMQ
, countryMR
, countryMU
, countryYT
, countryMX
, countryFM
, countryMD
, countryMC
, countryMN
, countryMS
, countryMA
, countryMZ
, countryMM
, countryNA
, countryNR
, countryNP
, countryNL
, countryAN
, countryNC
, countryNZ
, countryNI
, countryNE
, countryNG
, countryNU
, countryNF
, countryMP
, countryNO
, countryOM
, countryPK
, countryPW
, countryPS
, countryPA
, countryPG
, countryPY
, countryPE
, countryPH
, countryPN
, countryPL
, countryPT
, countryPR
, countryQA
, countryRE
, countryRO
, countryRU
, countryRW
, countrySH
, countryKN
, countryLC
, countryPM
, countryVC
, countryWS
, countrySM
, countryST
, countrySA
, countrySN
, countryRS
, countrySC
, countrySL
, countrySG
, countrySK
, countrySI
, countrySB
, countrySO
, countryZA
, countryGS
, countryES
, countryLK
, countrySD
, countrySR
, countrySJ
, countrySZ
, countrySE
, countryCH
, countrySY
, countryTW
, countryTJ
, countryTZ
, countryTH
, countryTL
, countryTG
, countryTK
, countryTO
, countryTT
, countryTN
, countryTR
, countryTM
, countryTC
, countryTV
, countryUG
, countryUA
, countryAE
, countryUK
, countryGB
, countryUS
, countryUM
, countryUY
, countryUZ
, countryVU
, countryVE
, countryVN
, countryVG
, countryVI
, countryWF
, countryEH
, countryYE
, countryZM
, countryZW
]
The country code for the search
Possible values: [lang_af
, lang_ak
, lang_sq
, lang_ws
, lang_am
, lang_ar
, lang_hy
, lang_az
, lang_eu
, lang_be
, lang_bem
, lang_bn
, lang_bh
, lang_xx-bork
, lang_bs
, lang_br
, lang_bg
, lang_bt
, lang_km
, lang_ca
, lang_chr
, lang_ny
, lang_zh-cn
, lang_zh-tw
, lang_co
, lang_hr
, lang_cs
, lang_da
, lang_nl
, lang_xx-elmer
, lang_en
, lang_eo
, lang_et
, lang_ee
, lang_fo
, lang_tl
, lang_fi
, lang_fr
, lang_fy
, lang_gaa
, lang_gl
, lang_ka
, lang_de
, lang_el
, lang_kl
, lang_gn
, lang_gu
, lang_xx-hacker
, lang_ht
, lang_ha
, lang_haw
, lang_iw
, lang_he
, lang_hi
, lang_hu
, lang_is
, lang_ig
, lang_id
, lang_ia
, lang_ga
, lang_it
, lang_ja
, lang_jw
, lang_kn
, lang_kk
, lang_rw
, lang_rn
, lang_xx-klingon
, lang_kg
, lang_ko
, lang_kri
, lang_ku
, lang_ckb
, lang_ky
, lang_lo
, lang_la
, lang_lv
, lang_ln
, lang_lt
, lang_loz
, lang_lg
, lang_ach
, lang_mk
, lang_mg
, lang_ms
, lang_ml
, lang_mt
, lang_mv
, lang_mi
, lang_mr
, lang_mfe
, lang_mo
, lang_mn
, lang_sr-me
, lang_my
, lang_ne
, lang_pcm
, lang_nso
, lang_no
, lang_nn
, lang_oc
, lang_or
, lang_om
, lang_ps
, lang_fa
, lang_xx-pirate
, lang_pl
, lang_pt
, lang_pt-br
, lang_pt-pt
, lang_pa
, lang_qu
, lang_ro
, lang_rm
, lang_nyn
, lang_ru
, lang_gd
, lang_sr
, lang_sh
, lang_st
, lang_tn
, lang_crs
, lang_sn
, lang_sd
, lang_si
, lang_sk
, lang_sl
, lang_so
, lang_es
, lang_es-419
, lang_su
, lang_sw
, lang_sv
, lang_tg
, lang_ta
, lang_tt
, lang_te
, lang_th
, lang_ti
, lang_to
, lang_lua
, lang_tum
, lang_tr
, lang_tk
, lang_tw
, lang_ug
, lang_uk
, lang_ur
, lang_uz
, lang_vu
, lang_vi
, lang_cy
, lang_wo
, lang_xh
, lang_yi
, lang_yo
, lang_zu
]
The language code for the search