Google Search API Quick Start guide

SERPMaster processes search requests in real time, taking care of proxy management, captchas, retries, result localization and many other details in order to return 100% correct results in JSON or HTML format. Each search request can be tailored according to certain parameter values.

Performing a search is as simple as making a GET HTTPS request to the SERPMaster queries endpoint. In order to make a query, provide q (search query) and your authentication information (either an access_token or in your authentication header). With some integration options, you will also have to specify that you're sending application/json content.

Here's how you can submit a search for the term lorem ipsum:

https://rt.serpmaster.com/?q=lorem%20ipsum&access_token=ENTER_YOUR_TOKEN

curl -u username:password 'https://rt.serpmaster.com/' -d '{"q": "lorem ipsum", "geo": "New York,New York,United States"}' -H "Content-Type: application/json"

import requests
from pprint import pprint
// Specify content type and form the request body
headers = {'Content-Type': 'application/json'}
job_params = {
    'q': 'lorem ipsum',
}
// Post job and get response
response = requests.post(
    'https://rt.serpmaster.com/',
    headers=headers,
    json=job_params,
    auth=('user', 'pass1')
)
// Print the response body
pprint(response.json())

<?php
$ch = curl_init();
#Form the request body
$data = [
    "q" => "lorem ipsum",
];
# Set request headers, authentication and other parameters
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_USERPWD, "user" . ":" . "pass1");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_URL, "https://rt.serpmaster.com/");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$response = curl_exec($ch);
curl_close($ch);
$json = json_decode($response);
var_dump($json);
?>

Note that requests that do not specify a value for the parameter "scraper" will default to our Google Search API.

Searches can be tailored according to many different parameters:

Parameter	Value
`q`	Any.
`domain`	Any available Google domain.
`scraper`	`google_suggest` `google_search` `google_images` `google_scholar` `google_shopping_search` `google_shopping_pricing` `google_shopping_product`
`num`	Any integer value between `1` and `100`.
`geo`	Country-, state- or city-level location in Google’s canonical format, or coordinate set with latitude, longitude and radius.
`device`	`desktop`, `desktop_firefox`, `desktop_chrome`, `desktop_opera`, `desktop_edge`, `desktop_safari`, `mobile`, `mobile_android`, `mobile_ios`, `tablet`, `tablet_ios`.
`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).

This should be enough to get you started. To read about all available parameters and their values, check out our Parameter Values page!

We have created a full SERPMaster Walkthrough for those in need of a step-by-step guide!