Documentation Serp Google

Search

Here is everything you need to start using the Google Search Serp API.

Parameters

The various parameters listed below are elaborated upon in detail:

Parameter	Description
query	The keyword used to perform the search.
search_type	Specifies the type of search to perform.
page	Indicates the page of results to retrieve.
num	Determines the number of results per page.
gl	Specifies the Google country to use for the query.
hl	Determines the Google UI language to return results in.
lr	Limits the results to websites containing the specified language.
cr	Limits the results to websites in the specified country.
uule	Use to pass through a custom uule parameter to Google.
time_period	Sets the time period of the search results.
time_period_min	Specifies the minimum time for a custom time period.
time_period_max	Specifies the maximum time for a custom time period.
filter	Toggles the filters for similar and omitted results.
nfpr	Excludes results from auto-corrected queries if set to 1.
safe	Enables Safe Search when set to 'active'.
tbs	Adds a specific string to the Google tbs parameter.

Request

Integrating is just seamless. Choose your preferred language to see the code examples for Search SERP requests.

Python
Javascript
PHP

import requests

# HTTP request to MapleSerp API
api_result = requests.get(
    'https://mapleserp.io/api/serp/search',
    headers={'Authorization': 'Bearer YOUR_API_TOKEN'},
    params={
        'query': 'pizza',
        'engine': 'google'
    }
)

# Dump SERP results
print(api_result.json()['organic_results'])

// HTTP request to MapleSerp API
const apiResult = fetch('https://mapleserp.io/api/serp/search?query=pizza&engine=google', {
    headers: {'Authorization': 'Bearer YOUR_API_TOKEN'}
});

// Dump SERP results
apiResult
    .then(response => response.json())
    .then(data => console.log(data));

<?php

$ch = curl_init('https://mapleserp.io/api/serp/search?query=pizza&engine=google');
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Authorization: Bearer YOUR_API_TOKEN'));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// HTTP request to MapleSerp API
$api_result = curl_exec($ch);

curl_close($ch);

// Dump SERP results
var_dump($api_result['organic_results']);

Response

Familiarize yourself with the JSON structure of the Search SERP results to gain a better understanding of their layout.

{
    "organic_results": [
        {
            "position": 1,
            "title": "Burger King",
            "link": "https://www.bk.com/",
            "domain": "bk.com",
            "snippet": "Start your BK® order. · Home · Menu · My Code · Offers · Rewards."
        },
        {
            "position": 2,
            "title": "Burger",
            "link": "https://en.wikipedia.org/wiki/Burger",
            "domain": "wikipedia.org",
            "snippet": "Foods · Hamburger, a food consisting of one or more cooked beef patties, placed inside a sliced bread roll or bun roll. · Ground beef, minced beef used to make ..."
        },
        {
            "position": 3,
            "title": "In-N-Out Burger",
            "link": "https://www.in-n-out.com/",
            "domain": "in-n-out.com",
            "snippet": "At In-N-Out Burger, quality is everything. That's why in a world where food is often over-processed, prepackaged and frozen, In-N-Out makes everything the ..."
        },
        {
            "position": 4,
            "title": "Burger Boat Company - Custom Yachts | Luxury Boats",
            "link": "https://www.burgerboat.com/",
            "domain": "burgerboat.com",
            "snippet": "For over 160 years, Burger Boat Company has been renowned for designing and building custom yachts that embrace meaningful innovations, seamlessly integrate ..."
        },
        {
            "position": 5,
            "title": "BurgerFi I Chef-Crafted Burgers, Fresh-Cut Fries, and Craft Beer",
            "link": "https://www.burgerfi.com/",
            "domain": "burgerfi.com",
            "snippet": "BurgerFi 100% Natural Angus Beef Burgers, Fresh-Cut Fries, Colossal Beer Battered Onion Rings, our award-winning VegeFi® Burger & more."
        },
        {
            "position": 6,
            "title": "Home - Charburgers - Sandwiches - Salads - Habit Burger ...",
            "link": "https://www.habitburger.com/",
            "domain": "habitburger.com",
            "snippet": "American fast-casual restaurant that specializes in award-winning Charburgers grilled over an open flame."
        },
        {
            "position": 7,
            "title": "The Perfect Burger Recipe",
            "link": "https://www.food.com/recipe/the-perfect-burger-92021",
            "domain": "food.com",
            "snippet": "Here are the ingredients & the instructions to make the perfect burger! Although it may not be the healthiest, use medium ground beef for moistness &"
        },
        {
            "position": 8,
            "title": "Perfect Hamburger Recipe (VIDEO)",
            "link": "https://natashaskitchen.com/perfect-burger-recipe/",
            "domain": "natashaskitchen.com",
            "snippet": "Jun 27, 2023 — We love burger recipes from our Cheeseburger Sliders to Hamburger Soup, but we make these classic burgers most often. Watch the video tutorial ..."
        },
        {
            "position": 9,
            "title": "Shake Shack: Home Page",
            "link": "https://shakeshack.com/",
            "domain": "shakeshack.com",
            "snippet": "ShackBurger Box - 12 servings. The burger that started it all. Made with 100% Angus beef and topped with cheese, lettuce, tomato, and ShackSauce on a toasted ..."
        },
        {
            "position": 10,
            "title": "Burger King",
            "link": "https://www.facebook.com/burgerking/",
            "domain": "facebook.com",
            "snippet": "Burger King, NY. 8626224 likes · 12066 talking about this · 219772 were here. with every order, you can reign. you rule. Burger King U.S.."
        }
    ],
    "search_metadata": {
        "engine_url": "https://google.com/search?gl=us&hl=en&uule=w+CAIQICINVW5pdGVkIFN0YXRlcw&q=burger"
    },
    "search_information": {
        "total_results": 1680000000,
        "time_taken_displayed": 0.31,
        "original_query_yields_zero_results": false
    },
    "search_parameters": {
        "query": "burger"
    }
}

On this page

Parameters
Request
Response