The SERP Master Developer Hub

Welcome to the SERP Master developer hub. You'll find comprehensive guides and documentation to help you start working with SERP Master as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    API Reference

Parameter values

Parameter

Description

Default value

q

Any.

domain

Any available Google domain.

com

parse

true will return parsed output in JSON format. Leave blank for HTML.

token

Your access token. Only required for One-Liner (other methods use Basic Authentication method via username:password combination).

device

desktop,
desktop_firefox,
desktop_chrome,
desktop_opera,
desktop_edge,
desktop_safari,
mobile,
mobile_android,
mobile_ios,
tablet,
tablet_ios.

desktop

geo

There are four geo parameter value types you can use:

  1. Canonical City location names, ex. Boston,Massachusetts,United States,
  2. Canonical State location names, ex. California,United States,
  3. Canonical Country names, ex. United States,
  4. Coordinates and Radius, ex. lat: 48.8583, lng: 2.2922, rad: 25000
    You can find Google's canonical location list here.

locale

Any single Accept-Language header value without q-factor. See this page for examples.

en-us

page

Lets you choose which results page you would like us to return. By default, you will get the 1st results page.

1

callback_url

Only used with Callback. Specify the URL to which we should POST the job completion notification.

nfpr

Lets you specify whether Google should auto-correct spelling mistakes. Set this parameter to false to get the SERP for a misspelled search term.

true

results_language

Only show results in a particular language.
Available values:
af, ar, hy, be, bg, ca,zh-CN, zh-TW, hr, cs, da, nl, en, eo, et, tl, fi, fr, de, el, iw, hi, hu, is, id, it, ja, ko, lv, lt, no, fa, pl, pt, ro, ru, sr, sk, sl, es, sw, sv, th, tr, uk, vi.

tbm

This parameter lets you filter Google Search results for specific types of content, such as, apps, books, news, patents places and videos.
Parsed output is only available with pts parameter value.
Raw HTML output is available with app, bks, nws, pts, plcs & vid values.

js

Specifies that JavaScript should be executed before returning the SERP. For most use cases, this is an excessive measure, as the majority of SERP content loads without rendering JavaScript.
Set this parameter to true to render JS. Please note that we charge x2 for SERPs with rendered JavaScript.

false

Updated 2 months ago

Parameter values


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.