Litescrape sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.litescrape.com/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

← All documentation

// Google documentation

Google Images API

Image search results with original image URLs, thumbnails, dimensions, titles and source pages. Filter by country, language, SafeSearch and Google image filters.

GET / POST https://ecll-litescrape-v3--site-api-web.modal.run/api/google/images

// from request to code

Integrate Google Images

Build your request and copy it into your stack. Or let your coding agent set it up.

APIGoogle Images
More options 7
Query and filters
Results and pagination

Your request updates the code instantly.

Open the Playground →

Set LITESCRAPE_API_KEY on your server, then run this request.

request.sh
curl --fail-with-body --get 'https://ecll-litescrape-v3--site-api-web.modal.run/api/google/images' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --data-urlencode 'q=red panda' \
  --data-urlencode 'hl=en' \
  --data-urlencode 'gl=us' \
  --data-urlencode 'device=desktop' \
  --data-urlencode 'num=20'

Read all parameters →

JSON POST request example

POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/google/images with Content-Type: application/json and your Authorization: Bearer header.

POST · application/json
{
  "q": "red panda",
  "num": 20,
  "hl": "en",
  "gl": "us"
}

// request reference

Google Images parameters

Send query parameters with GET /api/google/images. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.

POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.

Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.

Query and filters

q
QueryRequired

Image search query, up to 2,048 characters.

Type string · GET query or POST JSON

Example / input hint: red panda

  • Minimum characters: 1
  • Maximum characters: 2048
hl
LanguageOptional

Language of the Google Images interface.

Type string · GET query or POST JSON · Default en

Example / input hint: en

  • Pattern: ^[a-z]{2,3}(?:-[A-Za-z]{2,8})?$
gl
CountryOptional

Two-letter country code used to localize results.

Type string · GET query or POST JSON

Example / input hint: us

  • Pattern: ^[a-z]{2}$
safe
SafeSearchOptional

Set active to filter explicit images, or off to disable SafeSearch.

Type string · GET query or POST JSON

Accepted valuesactiveoff
tbs
Image filtersOptional

Google image filters, such as isz:l for large images, itp:photo for photographs, or ic:trans for transparent images.

Type string · GET query or POST JSON

Example / input hint: isz:l

  • Maximum characters: 4096
device
DeviceOptional

Device profile used for the image search.

Type string · GET query or POST JSON · Default desktop

Accepted valuesdesktoptabletmobile

Results and pagination

start
Start offsetOptional

Google's page offset. For the next page, use pagination.next_start from the response and keep the same query and filters. This offset is independent of num and the number of returned images.

Type integer · GET query or POST JSON · Default 0

Example / input hint: 10

  • Minimum: 0
  • Maximum: 1000
num
Result limitOptional

Maximum number of images returned from this page, from 1 to 100. This limits the parsed response; Google may supply fewer images.

Type integer · GET query or POST JSON · Default 100

Example / input hint: 20

  • Minimum: 1
  • Maximum: 100

Fetch the next page

Send pagination.next_start from the response as start on your next request. Keep the same query, filters and device. Stop when the response has no pagination.next_start.

num limits how many images are returned from the current page. It does not set Google's page size or the next offset, so do not calculate start by adding num.

// response

Work with the complete JSON response

Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.

Response groups include search_metadata, search_parameters, images_results, pagination, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.

Each images_results entry includes its position, title, source page in link, source name, thumbnail URL and original image URL. Image dimensions are included when available. Positions start at 1 on each page.

Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.

Illustrative success response. Result groups and optional fields depend on upstream content.

200 · application/json
{
  "search_metadata": {
    "id": "aa0f4761a38c490b9635375d586df2ef",
    "status": "Success",
    "created_at": "2026-10-10T02:44:41.917851+00:00",
    "processed_at": "2026-10-10T02:44:41.963155+00:00",
    "total_time_taken": 0.045304298400878906,
    "google_images_url": "https://www.google.com/search?q=red%20panda&udm=2&hl=en&gl=us"
  },
  "search_parameters": {
    "q": "red panda",
    "hl": "en",
    "gl": "us",
    "start": "0",
    "num": "2",
    "device": "desktop"
  },
  "images_results": [
    {
      "position": 1,
      "title": "Red panda - Wikipedia",
      "link": "https://en.wikipedia.org/wiki/Red_panda",
      "source": "Wikipedia",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR4uYYm5fvNPU0Tzqjy66KfWvYLqXLkgsykJ5BNbGCntQ&s=10",
      "original": "https://thumb.wikimedia.org/wikipedia/commons/thumb/f/fd/Red_Panda%2C_Gentle_Tree-Dweller_of_the_Himalayas.jpg/1280px-Red_Panda%2C_Gentle_Tree-Dweller_of_the_Himalayas.jpg?utm_source=en.wikipedia.org&utm_campaign=index&utm_content=thumbnail",
      "original_width": 1280,
      "original_height": 853,
      "thumbnail_width": 547,
      "thumbnail_height": 365
    },
    {
      "position": 2,
      "title": "Red Panda | National Geographic Kids",
      "link": "https://kids.nationalgeographic.com/animals/mammals/facts/red-panda",
      "source": "National Geographic Kids",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTGvo_cV_NYgCn5uPBsrIsLRRcEFq8pGchNV9MXmHn1Ew&s=10",
      "original": "https://i.natgeofe.com/k/63b1a8a7-0081-493e-8b53-81d01261ab5d/red-panda-full-body_16x9.jpg?w=1200",
      "original_width": 1200,
      "original_height": 675,
      "thumbnail_width": 738,
      "thumbnail_height": 414
    }
  ],
  "pagination": {
    "next_start": 10
  },
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}

More Google APIs