---
title: "Google Lens visual search"
method: GET
path: "/google/lens"
tags: ["Google Lens"]
---

# Google Lens visual search

`GET /google/lens`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/google/lens`
- Auth: API key in header `X-API-KEY`

## Query parameters

- `url` string, required
- `q` string, nullable
- `type` 'all' | 'products' | 'exact_matches' | 'visual_matches' | 'null', nullable

## Response `200`

- union
  - string
  - object
    - `search_parameters` object, required
      - `url` string, required
      - `q` string, nullable, required
      - `type` string, required
    - `visual_matches` object[], required
    - `exact_matches` object[], required
    - `related_content` object[], required

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: The URL is unsafe or the image is invalid. Not billed.
- `500`
- `503`: Google blocked the request. Not billed and retryable. Google returned an unexpected result layout. Not billed and retryable.

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/2f4af6143d10?raw)