Google Lens Search API

Our Google Lens API allows you to scrape results from the Google Lens page when performing an image search. The results related to the image could contain visual matches and other data.

The API is accessed through the following endpoint: /search?engine=google_lens

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_lens" \
  -d "url=https://i.imgur.com/HBrB8p0.png" \
  -d "no_cache=false" \
  -d "api_key=YOUR_API_KEY"

import requests

params = {
    "engine": "google_lens",
    "url": "https://i.imgur.com/HBrB8p0.png",
    "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_lens",
  url: "https://i.imgur.com/HBrB8p0.png",
  no_cache: "false",
  api_key: "YOUR_API_KEY"
};

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

<?php
$client = new \GuzzleHttp\Client();
$response = $client->get('https://serpapi.abcproxy.com/search', [
    'query' => [
        'engine' => 'google_lens',
        'url' => 'https://i.imgur.com/HBrB8p0.png',
        '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_lens")
    q.Add("url", "https://i.imgur.com/HBrB8p0.png")
    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_lens";
        query["url"] = "https://i.imgur.com/HBrB8p0.png";
        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_lens" +
            "&url=https://i.imgur.com/HBrB8p0.png" +
            "&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

url

string

Yes

Parameter defines the URL of an image to perform the Google Lens search.

https://i.imgur.com/HBrB8p0.png

Geographic Location

Name

Type

Required

Description

Example

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

country

string

Parameter defines the specific country location to use for the Google Lens Image Sources search. It’s a two-letter country code. (e.g., us for United States, fr for France, or de for Germany). Head to the Google Lens countries page for a full list of supported Google Lens countries.

Benin-bj

Serpapi Parameters

Name

Type

Required

Description

Example

engine

string

Yes

Set parameter to google_lens to use the Google Lens API engine.

google_lens

no_cache

boolean

Parameter will force SerpApi to fetch the Google Lens 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/670bafd55f489382/66a89f7f-1e72-4524-92a4-12f18e277db0.html",
        "xray_html_file":"https://webserp.abcproxy.com/files/670bafd55f489382/66a89f7f-1e72-4524-92a4-12f18e277db0.xray",
        "total_time_taken":"8.6289",
        "id":"66a89f7f-1e72-4524-92a4-12f18e277db0",
        "json_endpoint":"https://webserp.abcproxy.com/files/670bafd55f489382/66a89f7f-1e72-4524-92a4-12f18e277db0.json",
        "created_at":"2025-04-03 11:51:03",
        "google_lens_url":"https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fi.imgur.com%2FHBrB8p0.png",
    },
  "search_parameters":
    {
        "engine":"google_lens",
        "api_key":"YOUR_API_KEY",
        "url":"https://i.imgur.com/HBrB8p0.png",
        "reviews":true,
		"no_cache":true,
    },
    "visual_matches":
    [
        {
        "link":"/search?sca_esv=e93cf3ca433b1dba&lns_surface=26&udm=48&si=APYL9buGmpQYpE633.....0nX2w5/VcNChQI//9k=",
        "image_width":"206",
        "image_height":"245",
        "position":1,
        "title":"Danny DeVito - Wikipedia",
        },
        .....
    ],
}

Response Fields

Name

Type

Remark

search_metadata

object

Contains timing and status information

search_parameters

object

Contains query parameters and search context

visual_matches

object []

visual matching

exact_matches

object []

exact match

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 Images API NextGoogle Play Product API

Last updated 8 months ago

hashtagGoogle Lens Search API

hashtagApi Details

hashtagRequest

hashtagResponse

hashtagSuccess 200

hashtagError Responses