Skip to main content

SearchParams

    query Query (string)required

    The search query string

    query string test

    search_type Search Type (string)

    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

    page Page (integer)

    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.

    device Device (string)

    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

    google_domain Google Domain (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

    gl Gl (string)

    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

    hl Hl (string)

    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

    cr Cr (string)

    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

    lr Lr (string)

    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