Skip to main content

Google Search

GET 
/api/google

Perform a Google search with specified parameters.

Request​

Query Parameters

    query Queryrequired

    The search query string

    query string test

    search_type Search Type

    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

    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

    Possible values: [desktop, mobile, tablet]

    Default value: desktop

    The device type to simulate

    location any

    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

    google_domain Google Domain

    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

    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

    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

    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

    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

Responses​

OK

Schema

    any

Loading...