Name: Google Lens API: Reverse Image Search and Prices
Brand: s-r
SKU: api-s-r-google-lens
Availability: InStock
Author: API Market

# Google Lens API

## Overview

The Google Lens API runs a reverse image search on Google Lens and returns the visual matches as JSON. Send one or more image URLs and get one row per image with its matches: title, page URL, source domain, thumbnail and, when Lens shows one, a price and currency.

It is built for ecommerce teams, brand protection, marketplaces and research tools that need to find where an image appears online and at what price. Each call searches up to 10 images, and larger batches continue with a cursor.

## Features

*   **2 endpoints**: the same search as `POST /run` with a JSON body or `GET /run` with query parameters.
*   **Visual matches**: title, page URL, source, thumbnail and price when shown.
*   **Detected regions**: the regions Lens found in each image.
*   **Up to 10 images per call**: continue larger batches with `cursor`.
*   **Language**: `language` sets the Lens interface language.
*   **Rate limit**: 10 requests per second on Free and Basic, 20 on Pro, 50 on Plus.

## Use Cases

*   **Price research**: find where a product image is sold and for how much.
*   **Brand protection**: spot reused or copied product photos.
*   **Supplier matching**: match supplier photos to shop listings.
*   **Image verification**: check where an image appeared before.

## API Documentation

### Base URL

All requests go through the API.market proxy at this base URL:

```
https://prod.api.market/api/v1/s-r/google-lens
```

### Authentication

Every request must include your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Reverse image search (POST)

Returns the Google Lens matches for each image URL in the JSON body.

**Method:** `POST`

**Endpoint:** `/run`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| image_urls | body | Direct image URLs, at most 10 per call | array of strings | Yes | - | 10 |
| language | body | Lens interface language; affects titles and result order. | string | No | en | - |
| retries | body | Number of additional attempts when Google Lens cannot complete the search. | integer | No | 4 | 8 |
| cursor | body | Image index returned as next_cursor. Omit for the first batch. | integer | No | - | 100 |
| completed_indices | body | Previously delivered image indices to skip when continuing a batch. Comma-separated or JSON array. | string | No | - | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/s-r/google-lens/run' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "image_urls": [
    "https://upload.wikimedia.org/wikipedia/commons/thumb/8/85/Tour_Eiffel_Wikimedia_Commons_%28cropped%29.jpg/330px-Tour_Eiffel_Wikimedia_Commons_%28cropped%29.jpg"
  ],
  "language": "en",
  "retries": 2
}'
```

**Example Response (200 OK):**

```json
{
  "data": {
    "items": [
      {
        "image_url": "https://upload.wikimedia.org/wikipedia/commons/thumb/8/85/Tour_Eiffel_Wikimedia_Commons_%28cropped%29.jpg/330px-Tour_Eiffel_Wikimedia_Commons_%28cropped%29.jpg",
        "matches": [
          {
            "title": "File:Tour Eiffel Wikimedia Commons.jpg - Wikipedia",
            "page_url": "https://www.google.com/goto?url=CAESgQEBxCJF10uKObpLBPfmWz_XbHEq4f6YK5uTFvYMSiNUbAUN7Of3QKCYatNXoJ3UqQD_NtlzINxuRHnfiyLBWBSlPfPBThFxbfj-1cv8ssB3rDJPQNk7Yoa46q63j8sVTa7v57q6kUUTjjl20bxfXIfkVUlHPrnQNJ6XtkJG-xh_FGQ&gsessionid=DOrDtc1G5487MGyF9...",
            "source_domain": "Wikipedia",
            "thumbnail": "",
            "price": "",
            "currency": "",
            "link_is_redirect": true,
            "position": 1,
            "url": "https://www.google.com/goto?url=CAESgQEBxCJF10uKObpLBPfmWz_XbHEq4f6YK5uTFvYMSiNUbAUN7Of3QKCYatNXoJ3UqQD_NtlzINxuRHnfiyLBWBSlPfPBThFxbfj-1cv8ssB3rDJPQNk7Yoa46q63j8sVTa7v57q6kUUTjjl20bxfXIfkVUlHPrnQNJ6XtkJG-xh_FGQ&gsessionid=DOrDtc1G5487MGyF9..."
          },
          {
            "title": "Eiffel Tower - Wikipedia",
            "page_url": "https://www.google.com/goto?url=CAESZwHEIkXXTWRCOuiKaC1T8b0NK4xajfcFc5a8AZ1ZME1iDONvuOHbk4IIQvb5iyzUhw2tcp1Z-XpDdgDZq3UVHiSU8JwczcdXPYAGmBG8os1W-Lgfr4d6TOkEC11BkDlNkg6qyOLfZFc&gsessionid=DOrDtc1G5487MGyF9xPRTPu8l5wunEbZNT_GBAzvvQ00Spg2i1SaF...",
            "source_domain": "Wikipedia",
            "thumbnail": "",
            "price": "",
            "currency": "",
            "link_is_redirect": true,
            "position": 2,
            "url": "https://www.google.com/goto?url=CAESZwHEIkXXTWRCOuiKaC1T8b0NK4xajfcFc5a8AZ1ZME1iDONvuOHbk4IIQvb5iyzUhw2tcp1Z-XpDdgDZq3UVHiSU8JwczcdXPYAGmBG8os1W-Lgfr4d6TOkEC11BkDlNkg6qyOLfZFc&gsessionid=DOrDtc1G5487MGyF9xPRTPu8l5wunEbZNT_GBAzvvQ00Spg2i1SaF..."
          }
        ],
        "match_count": 59,
        "regions": [
          {
            "label": "SalientRegion-Top",
            "box_cxcywh": [
              0.49545,
              0.47636
            ]
          },
          {
            "label": "DetectedObject-RepresentsWholeImage",
            "box_cxcywh": [
              0.5,
              0.52636
            ]
          }
        ],
        "search_url": "https://www.google.com/search?vsrid=CLiT1ee345S8zgEQAhgBIiRlMDkyNWZiZi00Zjc4LTRiYmQtYTNlNC1hNGYzMzNlYmI5NDgygQEiAmx1KC9CcwoubGZlLWR1bW15Ojg4YWJlNWExLTBlYjktNDY1My04YWIzLWZmNzI5MzVkM2FlMRJBCj8vYm5zL2x1L2JvcmcvbHUvYm5zL2xlbnMtZnJvbnRlbmQtYXBp...",
        "attempts": 1,
        "source": "google-lens",
        "engine": "google_lens",
        "fetched_at": "2026-11-05T21:22:26.959Z",
        "language": "en",
        "input_index": 0,
        "fetched_in_seconds": 18.25
      }
    ],
    "billing": {
      "image_search": 1
    },
    "errors": [],
    "partial": false,
    "warnings": [],
    "next_cursor": null,
    "deferred_indices": [],
    "summary": {
      "withMatches": 1
    }
  },
  "meta": {
    "request_id": "192926cd-c1c0-411e-8965-7105e38de326",
    "duration_ms": 18252,
    "units": 1,
    "cached": false
  }
}
```

#### 2. Reverse image search (GET)

The same search with query parameters. Pass several URLs comma-separated. It returns the same rows as the POST endpoint.

**Method:** `GET`

**Endpoint:** `/run`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| image_urls | query | Direct image URLs, or one URL per line. The first 100 non-empty URLs are searched; duplicates are preserved. Comma-separated or JSON array. At most 10 per call. | string | Yes | - | - |
| language | query | Lens interface language; affects titles and result order. | string | No | en | - |
| retries | query | Number of additional attempts when Google Lens cannot complete the search. | integer | No | 4 | 8 |
| cursor | query | Image index returned as next_cursor. Omit for the first batch. | integer | No | - | 100 |
| completed_indices | query | Previously delivered image indices to skip when continuing a batch. Comma-separated or JSON array. | string | No | - | - |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/s-r/google-lens/run?image_urls=https%3A%2F%2Fm.media-amazon.com%2Fimages%2FI%2F61bK6PMOC3L._AC_SL1500_.jpg&language=en' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the response body holds the result. |
| 400 | Bad Request | A required parameter is missing or a value is invalid. Check the parameter table for the endpoint. |
| 401 | Unauthorized | The `x-api-market-key` header is missing or the key is not valid. |
| 403 | Forbidden | Your key is valid but your subscription does not allow this request, for example an endpoint outside your plan. |
| 404 | Not Found | The path does not exist, or the resource you asked for was not found. |
| 429 | Too Many Requests | You sent more than your plan's requests per second (10 on Free and Basic, 20 on Pro, 50 on Plus). Slow down and retry, honouring the `Retry-After` header. |
| 500 | Internal Server Error | Something went wrong while processing the request. Retry after a short wait. |
| 503 | Service Unavailable | The service or its upstream data source is temporarily unavailable. Retry with backoff. |

## Rate Limits

The Free and Basic plans allow up to 10 requests per second, Pro allows 20 and Plus allows 50. Each plan also has a monthly call quota shown on the pricing page. Going over your plan's per-second limit returns `429 Too Many Requests`. Throttle your client to stay under it, back off and retry when you get a 429, and honour the `Retry-After` header when it is present.

## FAQ

*   **Why do some matches have no price?**

    Lens shows a price only for shopping results. Other matches have `price` empty.

*   **How do I search more than 10 images?**

    Send the first 10, then continue with the returned `next_cursor` and `completed_indices`.

*   **How many results does the Free plan return?**

    Free plans return at most 10 results per call. Paid plans return the full result set up to the endpoint's limit.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Reverse image search on Google Lens: send image URLs and get visual matches with title, page link, source and price as JSON.