Documentation Serp Google

Images

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

Parameters

There are a number of parameters which are explained in detail within the index below:

Parameter	Description
query	The keyword used to perform the search.
search_type	Specifies the type of search to perform.
images_page	Determines the page of results to get when search_type=images.
images_color	Allows you to set the color of the images returned.
images_size	Allows you to set the size of the images returned.
images_type	Allows you to set the type of the images returned.
images_usage	Allows you to specify the usage rights of the images returned.
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.
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 Images 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',
        'search_type': 'images'
    }
)

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

// HTTP request to MapleSerp API
const apiResult = fetch('https://mapleserp.io/api/serp/search?query=pizza&engine=google&search_type=images', {
    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&search_type=images');
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['image_results']);

Response

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

{
    "image_results": [
        {
            "position": 1,
            "title": "The Perfect Basic Burger",
            "link": "https://www.allrecipes.com/recipe/25473/the-perfect-basic-burger/",
            "image": "https://www.allrecipes.com/thmb/5JVfA7MxfTUPfRerQMdF-nGKsLY=/1500x0/filters:no_upscale():max_bytes(150000):strip_icc()/25473-the-perfect-basic-burger-DDMFS-4x3-56eaba3833fd4a26a82755bcd0be0c54.jpg",
            "domain": "allrecipes.com"
        },
        {
            "position": 2,
            "title": "Stovetop Burgers - How to Cook Burgers on the Stove",
            "link": "https://www.thecookierookie.com/stovetop-burgers/",
            "image": "https://www.thecookierookie.com/wp-content/uploads/2023/04/featured-stovetop-burgers-recipe.jpg",
            "domain": "thecookierookie.com"
        },
        {
            "position": 3,
            "title": "Best Burger Ever",
            "link": "https://www.allrecipes.com/recipe/19863/best-burger-ever/",
            "image": "https://www.allrecipes.com/thmb/RTo6ddljby-5lAszPdMRwQ-aVh0=/1500x0/filters:no_upscale():max_bytes(150000):strip_icc()/19863best-burger-everFranceC4x3-c9c7d5cae40b4a58a110a33e04b531d1.jpg",
            "domain": "allrecipes.com"
        },
        {
            "position": 4,
            "title": "Crispy Comté Frico Cheeseburgers",
            "link": "https://www.foodandwine.com/recipes/crispy-comte-cheeseburgers",
            "image": "https://www.foodandwine.com/thmb/DI29Houjc_ccAtFKly0BbVsusHc=/1500x0/filters:no_upscale():max_bytes(150000):strip_icc()/crispy-comte-cheesburgers-FT-RECIPE0921-6166c6552b7148e8a8561f7765ddf20b.jpg",
            "domain": "foodandwine.com"
        },
        {
            "position": 5,
            "title": "Your Best Grilled Burger",
            "link": "https://www.thespruceeats.com/your-best-grilled-burger-recipe-7511041",
            "image": "https://www.thespruceeats.com/thmb/UpVWAcHnFEe_KvQpYsR1a7U-WY0=/1500x0/filters:no_upscale():max_bytes(150000):strip_icc()/SES-your-best-grilled-burger-recipe-7511041-hero-C-c5080fa5f97c4c2b908968527f8a851b.jpg",
            "domain": "thespruceeats.com"
        },
        {
            "position": 6,
            "title": "Classic Smashed Cheeseburger",
            "link": "https://www.epicurious.com/recipes/food/views/classic-smashed-cheeseburger-51261810",
            "image": "https://assets.epicurious.com/photos/5c745a108918ee7ab68daf79/1:1/w_2560%2Cc_limit/Smashburger-recipe-120219.jpg",
            "domain": "epicurious.com"
        },
        {
            "position": 7,
            "title": "Ultra Crunchy Fried Chicken Burger",
            "link": "https://www.recipetineats.com/crispy-fried-chicken-burger/",
            "image": "https://www.recipetineats.com/wp-content/uploads/2023/09/Crispy-fried-chicken-burgers_5.jpg",
            "domain": "recipetineats.com"
        },
        {
            "position": 8,
            "title": "Classic Cheeseburger Recipe",
            "link": "https://www.modernhoney.com/classic-cheeseburger/",
            "image": "https://www.modernhoney.com/wp-content/uploads/2022/05/Double-Double-Cheeseburger-with-Fries-Recipe-scaled.jpg",
            "domain": "modernhoney.com"
        },
        {
            "position": 9,
            "title": "The Best Juicy Burger",
            "link": "https://www.inspiredtaste.net/23659/no-fuss-hamburger-recipe/",
            "image": "https://www.inspiredtaste.net/wp-content/uploads/2023/06/Easy-Hamburger-Recipe-Video.jpg",
            "domain": "inspiredtaste.net"
        },
        {
            "position": 10,
            "title": "High-Protein Air-Fryer Burgers",
            "link": "https://www.eatingwell.com/recipe/8056326/air-fryer-burgers/",
            "image": "https://www.eatingwell.com/thmb/aKA6WL4j01orJ6F7v9bF4PH6B7Y=/1500x0/filters:no_upscale():max_bytes(150000):strip_icc()/air-fryer-cheeseburgers-9e0cf0071bcb4b8d9bc806cabfb61347.jpg",
            "domain": "eatingwell.com"
        }
    ],
    "search_metadata": {
        "engine_url": "https://google.com/search?tbm=isch&gl=us&hl=en&uule=w+CAIQICINVW5pdGVkIFN0YXRlcw&q=burger"
    },
    "search_information": {
        "original_query_yields_zero_results": false,
        "experimental_images_intitle_removal": true
    },
    "search_parameters": {
        "query": "burger",
        "search_type": "images"
    }
}

On this page

Parameters
Request
Response