---
title: "Image Search"
method: POST
path: "/search/images"
tags: ["Search"]
---

# Image Search

`POST /search/images`

## Request

- Base URL: `https://api.weblens.dev`
- URL: `https://api.weblens.dev/search/images`
- Auth: API key in header `Payment-Signature`

Google Images search. Returns direct image URLs with dimensions, thumbnails, and source pages. Price: $0.015.

## Request body

- object
  - `query` string, required: Search query
  - `limit` number: Maximum results to return

## Response `200`

Direct image URLs with dimensions and source pages.

- object
  - `query` string
  - `results` object[]: Images with position, title, imageUrl, thumbnail, sourcePage, source, width, height
    - `position` integer
    - `title` string
    - `imageUrl` string
    - `thumbnail` string
    - `sourcePage` string
    - `source` string
    - `width` integer
    - `height` integer
  - `searchedAt` string
  - `requestId` string

## Other responses

- `400`: The body failed validation
- `402`: Payment required — x402 v2 protocol. Parse the PAYMENT-REQUIRED response header (base64-encoded JSON), sign the payment with your wallet, then retry the request with the Payment-Signature request header.

---

[API](https://skmtc.dev/weblens/apis/weblens-api.md) · [All operations](https://skmtc.dev/weblens/apis/weblens-api/llms.txt) · [OpenAPI document](https://skmtc.dev/weblens/apis/weblens-api/revisions/63a7e81b6921?raw)