---
openapi: 3.1.0
info:
  title: Google Lens — SearchApi
  version: 3.1.0
  description: Generated from the SearchApi engine catalog. Parameters marked in the
    catalog as unverified are described from its records rather than from the vendor's
    specification.
servers:
- url: https://www.searchapi.io/api/v1
paths:
  "/search":
    get:
      operationId: google_lens
      summary: Google Lens
      parameters:
      - name: engine
        in: query
        required: true
        description: Engine that retrieves the data; fixed per API (see Apis::BY_ENGINE
          keys).
        schema:
          type: string
          const: google_lens
      - name: api_key
        in: query
        required: true
        description: 'SearchApi.io API key; alternatively send ''Authorization: Bearer
          <key>''.'
        schema:
          type: string
      - name: zero_retention
        in: query
        required: false
        description: 'Enterprise-only: disables all logging and persistent storage
          of the search.'
        schema:
          type: boolean
          default: false
      - name: url
        in: query
        required: true
        description: Publicly accessible URL of the image to analyze.
        schema:
          type: string
      - name: search_type
        in: query
        required: false
        description: 'Result tab: all (default), exact_matches, visual_matches or
          products.'
        schema:
          type: string
          enum:
          - all
          - exact_matches
          - visual_matches
          - products
          default: all
      - name: q
        in: query
        required: false
        description: Optional text query refining what to find on the image.
        schema:
          type: string
      - name: country
        in: query
        required: false
        description: Country of the search; supported values listed at docs/parameters/google-lens/country.
        schema:
          type: string
      - name: hl
        in: query
        required: false
        description: Interface language of the search (two-letter language code).
        schema:
          type: string
          enum:
          - af
          - ak
          - sq
          - am
          - ar
          - hy
          - az
          - eu
          - be
          - bem
          - bn
          - bh
          - bs
          - br
          - bg
          - km
          - ca
          - chr
          - ny
          - zh-CN
          - zh-TW
          - co
          - hr
          - cs
          - da
          - nl
          - en
          - eo
          - et
          - ee
          - fo
          - tl
          - fi
          - fr
          - fy
          - gaa
          - gl
          - ka
          - de
          - el
          - gn
          - gu
          - ht
          - ha
          - haw
          - iw
          - hi
          - hu
          - is
          - ig
          - id
          - ia
          - ga
          - it
          - ja
          - jw
          - kn
          - kk
          - rw
          - rn
          - kg
          - ko
          - kri
          - ku
          - ckb
          - ky
          - lo
          - la
          - lv
          - ln
          - lt
          - loz
          - lg
          - ach
          - mk
          - mg
          - ms
          - ml
          - mt
          - mi
          - mr
          - mfe
          - mo
          - mn
          - sr-ME
          - my
          - ne
          - pcm
          - nso
          - 'no'
          - nn
          - oc
          - or
          - om
          - ps
          - fa
          - pl
          - pt
          - pt-BR
          - pt-PT
          - pa
          - qu
          - ro
          - rm
          - nyn
          - ru
          - gd
          - sr
          - sh
          - st
          - tn
          - crs
          - sn
          - sd
          - si
          - sk
          - sl
          - so
          - es
          - es-419
          - su
          - sw
          - sv
          - tg
          - ta
          - tt
          - te
          - th
          - ti
          - to
          - lua
          - tum
          - tr
          - tk
          - tw
          - ug
          - uk
          - ur
          - uz
          - vi
          - cy
          - wo
          - xh
          - yi
          - yo
          - zu
          default: en
      responses:
        '200':
          description: A Google Lens result envelope.
