Google Images API

Our Google Images API allows you to scrape results from the Google Images page. The API is accessed through the following endpoint: /search?engine=google_images.

Api Details

Endpoint GET https://serpapi.abcproxy.com/search

Description Retrieve comprehensive user profile including basic info, account status and optional permission sets.

Request

HTTP Request

curl -X GET "https://serpapi.abcproxy.com/search" \
  -d "engine=google_images" \
  -d "q=Coffee" \
  -d "no_cache=false" \
  -d "api_key=YOUR_API_KEY"

import requests

params = {
    "engine": "google_images",
    "q": "Coffee",
    "no_cache": "false",
    "api_key": "YOUR_API_KEY"
}
response = requests.get("https://serpapi.abcproxy.com/search", params=params)
print(response.json())

const axios = require('axios');

const params = {
  engine: "google_images",
  q: "Coffee",
  no_cache: "false",
  api_key: "YOUR_API_KEY"
};

axios.get("https://serpapi.abcproxy.com/search", { params })
  .then(response => console.log(response.data));

GET /search?engine=google_images&q=Coffee&no_cache=false&api_key=YOUR_API_KEY HTTP/1.1
Host: serpapi.abcproxy.com

<?php
$client = new \GuzzleHttp\Client();
$response = $client->get('https://serpapi.abcproxy.com/search', [
    'query' => [
        'engine' => 'google_images',
        'q' => 'Coffee',
        'no_cache' => 'false',
        'api_key' => 'YOUR_API_KEY'
    ]
]);
echo $response->getBody();

package main

import (
    "net/http"
    "io/ioutil"
    "log"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://serpapi.abcproxy.com/search", nil)
    
    q := req.URL.Query()
    q.Add("engine", "google_images")
    q.Add("q", "Coffee")
    q.Add("no_cache", "false")
    q.Add("api_key", "YOUR_API_KEY")
    req.URL.RawQuery = q.Encode()

    resp, _ := client.Do(req)
    body, _ := ioutil.ReadAll(resp.Body)
    log.Println(string(body))
}

using System;
using System.Net.Http;

class Program
{
    static async Task Main()
    {
        var client = new HttpClient();
        var query = System.Web.HttpUtility.ParseQueryString(string.Empty);
        query["engine"] = "google_images";
        query["q"] = "Coffee";
        query["no_cache"] = "false";
        query["api_key"] = "YOUR_API_KEY";
        
        var response = await client.GetAsync(
            $"https://serpapi.abcproxy.com/search?{query}"
        );
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

import java.net.*;
import java.io.*;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://serpapi.abcproxy.com/search" +
            "?engine=google_images" +
            "&q=Coffee" +
            "&no_cache=false" +
            "&api_key=YOUR_API_KEY";
        
        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
        conn.setRequestMethod("GET");
        
        BufferedReader in = new BufferedReader(
            new InputStreamReader(conn.getInputStream())
        );
        String response = in.lines().collect(Collectors.joining());
        System.out.println(response);
    }
}

API Parameters

Search Query

Name

Type

Required

Description

Example

q

string

Yes

Parameter defines the query you want to search. You can use anything that you would use in a regular Google Images search.

coffee

Geographic Location

Name

Type

Required

Description

Example

location

string

Parameter defines from where you want the search to originate. If several locations match the location requested, we'll pick the most popular one. Head to the /locations.json API if you need more precise control. The location and uule parameters can't be used together. It is recommended to specify location at the city level in order to simulate a real user’s search. If location is omitted, the search may take on the location of the proxy.

Korea

uule

string

Search using a Google-coded location.uule and location parameters can't be used together.

Localization

Name

Type

Required

Description

Example

google_domain

string

Parameter defines the Google domain to use. It defaults to google.com. Head to the Google domains page for a full list of supported Google domains.

gl

string

Parameter defines the country to use for the Google search. It is a two-letter country code. (e.g., us for the United States, uk for United Kingdom, or fr for France). Head to the Google countries page for a full list of supported Google countries.

Amgola-ao

hl

string

Parameter defines the language to use for the Google search. It is a two-letter language code. (e.g., en for English, es for Spanish, or fr for French). Head to the Google languages page for a full list of supported Google languages.

Akan-ak

Advabced Filters

Name

Type

Required

Description

Example

chips

string

Parameter enables to filter image search. It’s a string provided by Google as suggested search. Chips are provided under the section: suggested_searches when ijn = 0. Both chips and serpapi_link values are provided for each suggested search.

red apple

tbs

string

(to be searched) parameter defines advanced search parameters that aren’t possible in the regular query field.

imgar

string

Parameter defines the set aspect ratio of images. s - Square t - Tall w - Wide xw - Panoramic

safe

string

Parameter defines the level of filtering for adult content. It can be set to active or off, by default Google will blur explicit content.

active or off

nfpr

boolean

Parameter defines the exclusion of results from an auto-corrected query when the original query is spelled wrong. It can be set to 1 to exclude these results, or 0 to include them (default). Note that this parameter may not prevent Google from returning results for an auto-corrected query if no other results are available.

trueorfalse

filter

boolean

Parameter defines if the filters for "Similar Results" and "Omitted Results" are on or off. It can be set to 1 (default) to enable these filters, or 0 to disable these filters.

trueorfalse

Pagination

Name

Type

Required

Description

Example

ijn

int

Parameter defines the page number for Google Images. There are 100 images per page. This parameter is equivalent to start (offset) = ijn * 100.

2

Serpapi Parameters

Name

Type

Required

Description

Example

engine

string

Yes

Set parameter to google_images to use the Google Images API engine.

google_images

no_cache

boolean

Parameter will force SerpApi to fetch the Google Images results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.

trueorfalse

api_key

string

Yes

Parameter defines the SerpApi private key to use.

YOUR_API_KEY

Response

Success 200

Response Body

{
  "code": 200,
  "search_metadata":
    {				 
        "raw_html_file":"https://webserp.abcproxy.com/files/6d8b6424c4c37f2d/d3bb5a81-7bb9-4dee-8f75-001b526c0313.html",
        "xray_html_file":"https://webserp.abcproxy.com/files/6d8b6424c4c37f2d/d3bb5a81-7bb9-4dee-8f75-001b526c0313.xray",
        "total_time_taken":"41.3979",
        "id":"d3bb5a81-7bb9-4dee-8f75-001b526c0313",
        "json_endpoint":"https://webserp.abcproxy.com/files/6d8b6424c4c37f2d/d3bb5a81-7bb9-4dee-8f75-001b526c0313.json",
        "created_at":"2025-04-03 11:24:30",
        "google_images_url":"requestUrl",
    },
  "search_parameters":
    {
        "engine":"google_images",
        "api_key":"YOUR_API_KEY",
        "q":"Coffee",
        "reviews":true,
    },
    "images_results":
    [
        {
            "source":"Wikipedia",
            "title":"Coffee - Wikipedia",
            "link":"https://en.wikipedia.org/wiki/Coffee",
            "related_content_id":"Y0hoQW1Kcnc4RXRiV01cIixcIlU2b0pNbkYtZWVWVEFN",
            "related_content_link":"https://en.wikipedia.org/wiki/Coffee",
            "position":1,
            "original":"https://upload.wikimedia.org/wikipedia/commons/e/e4/Latte_and_dark_coffee.jpg",
            "original_width":3200,
            "original_height":2000,
            "thumbnail":"https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRkRapDtN6JSis1bWCnMbqn3pmIEDeDY9t8tg&s",
        },
        ......,
    ],
    "related_searches":
    [
        {
            "thumbnail":"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/....fQelKVj8ftftq8nrLdUpSttlv/Z",
            "query":"clip art coffee",
            "link":"https://www.google.com/search?sca_esv=e93cf3c.....AxU-MVkFHbpzAUcQrNwCegQIaxAA",
            "highlighted_words":
            [
                "clip art",
            ],
        },
        ......,
    ],
}

Response Fields

Name

Type

Remark

search_metadata

object

Contains timing and status information

search_parameters

object

Contains query parameters and search context

image_results

object []

Main image search results area

related_searches

object []

After similar search results

SuggestedSearch

object []

Error Responses

Common Errors

HTTP Status

Error Code

Description

200

400

API Key can not be empty

200

401

Param error

200

402

API Key error

200

403

Insufficient Balance

200

404

Deduction failed

200

405

Failed to record usage count

200

406

Unsupported engine

200

407

Network error

200

408

File not found

200

409

Limit param error

200

410

Build url error

200

411

Failed to QueryRecentRecord

200

412

Failed to find json

200

413

Get html error

200

414

HTML is empty

200

429

Too many request

Error Example

{
  "code": 400,
  "message": "API Key can not be empty"
}

PreviousGoogle Product API NextGoogle Lens Search API

Last updated 2 months ago