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

Quick Start guide

This page will help you get started with SERPMaster. You'll be up and running in no time!

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=SEARCH_TERM&access_token=ENTER_YOUR_TOKEN
curl -u username:password 'https://rt.serpmaster.com/' -d '{"q": "restaurants near me", "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': 'SEARCH TERM',
}
// 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" => "SEARCH TERM",
];
# 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);
?>

Searches can be tailored according to many different parameters:

Parameter

Value

q

Any.

domain

Any available Google domain.

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!

Updated 2 months ago


What's Next

Integration

Quick Start guide


This page will help you get started with SERPMaster. You'll be up and running in no time!

Suggested Edits are limited on API Reference Pages

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