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 Reverse Image Search API

Find visually similar images and pages using an image URL.

GET / POST https://api.litescrape.com/api/google/reverse-image-search

For background execution, use POST /api/google/reverse-image-search/async. Learn how to submit and poll async requests →

// from request to code

Integrate Google Reverse Image Search

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

APIGoogle Reverse Image Search
More options 12
Image and results

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 --request POST 'https://api.litescrape.com/api/google/reverse-image-search' \
  --header "Authorization: Bearer $LITESCRAPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "image_url": "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png",
  "num": 5
}'

JSON POST request example

POST to https://api.litescrape.com/api/google/reverse-image-search with Content-Type: application/json and your Authorization: Bearer header.

POST · application/json
{
  "image_url": "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png",
  "num": 5
}

// request reference

Google Reverse Image Search parameters

Send query parameters with GET /api/google/reverse-image-search. 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.

Image and results

image_url
Image URLRequired

Public HTTP(S) URL of the image to search with.

Type string · GET query or POST JSON

Example / input hint: https://example.com/photo.jpg

  • Minimum characters: 1
  • Maximum characters: 2048
hl
Interface languageOptional

Language of the results interface.

Type string · GET query or POST JSON · Default en

Example / input hint: en

  • Pattern: ^[a-z]{2,3}(?:-(?:[A-Za-z]{2,8}|[0-9]{3}))?$
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 results, or off to disable SafeSearch.

Type string · GET query or POST JSON

Example / input hint: active

Accepted valuesactiveoff
num
Result limitOptional

Maximum number of results to return.

Type integer · GET query or POST JSON · Default 20

Example / input hint: 20

  • Minimum: 1
  • Maximum: 100
q
Search textOptional

Text to refine the image search.

Type string · GET query or POST JSON

Example / input hint: red panda

  • Maximum characters: 2048
start
Result offsetOptional

Result offset for pagination.

Type integer · GET query or POST JSON · Default 0

Example / input hint: 10

  • Keep the same image and filters when requesting another page.
  • Offsets beyond the available matches return an empty list.
  • Minimum: 0
  • Maximum: 1000
lr
Result languagesOptional

Languages to include in results.

Type string · GET query or POST JSON

Example / input hint: lang_en|lang_fr

  • Separate language restrictions with |, for example lang_en|lang_fr.
  • Maximum characters: 256
  • Pattern: ^lang_[a-z]{2,3}(?:\|lang_[a-z]{2,3})*$
tbs
Advanced filtersOptional

Advanced search filters.

Type string · GET query or POST JSON

Example / input hint: qdr:y

  • For example, qdr:y requests results from the past year. Filter availability depends on the search.
  • Maximum characters: 4096
google_domain
Google domainOptional

Google country domain used for results.

Type string · GET query or POST JSON · Default google.com

Example / input hint: google.com

Accepted valuesgoogle.adgoogle.aegoogle.algoogle.amgoogle.asgoogle.atgoogle.azgoogle.bagoogle.begoogle.bfgoogle.bggoogle.bigoogle.bjgoogle.bsgoogle.btgoogle.bygoogle.cagoogle.catgoogle.cdgoogle.cfgoogle.cggoogle.chgoogle.cigoogle.clgoogle.cmgoogle.cngoogle.co.aogoogle.co.bwgoogle.co.ckgoogle.co.crgoogle.co.idgoogle.co.ilgoogle.co.ingoogle.co.jpgoogle.co.kegoogle.co.krgoogle.co.lsgoogle.co.magoogle.co.mzgoogle.co.nzgoogle.co.thgoogle.co.tzgoogle.co.uggoogle.co.ukgoogle.co.uzgoogle.co.vegoogle.co.vigoogle.co.zagoogle.co.zmgoogle.co.zwgoogle.comgoogle.com.afgoogle.com.aggoogle.com.argoogle.com.augoogle.com.bdgoogle.com.bhgoogle.com.bngoogle.com.bogoogle.com.brgoogle.com.bzgoogle.com.cogoogle.com.cugoogle.com.cygoogle.com.dogoogle.com.ecgoogle.com.eggoogle.com.etgoogle.com.fjgoogle.com.ghgoogle.com.gigoogle.com.gtgoogle.com.hkgoogle.com.jmgoogle.com.khgoogle.com.kwgoogle.com.lbgoogle.com.lygoogle.com.mmgoogle.com.mtgoogle.com.mxgoogle.com.mygoogle.com.nagoogle.com.nggoogle.com.nigoogle.com.npgoogle.com.omgoogle.com.pagoogle.com.pegoogle.com.pggoogle.com.phgoogle.com.pkgoogle.com.prgoogle.com.pygoogle.com.qagoogle.com.sagoogle.com.sbgoogle.com.sggoogle.com.slgoogle.com.svgoogle.com.tjgoogle.com.trgoogle.com.twgoogle.com.uagoogle.com.uygoogle.com.vcgoogle.com.vngoogle.cvgoogle.czgoogle.degoogle.djgoogle.dkgoogle.dmgoogle.dzgoogle.eegoogle.esgoogle.figoogle.fmgoogle.frgoogle.gagoogle.gegoogle.gggoogle.glgoogle.gmgoogle.grgoogle.gygoogle.hngoogle.hrgoogle.htgoogle.hugoogle.iegoogle.imgoogle.iqgoogle.isgoogle.itgoogle.jegoogle.jogoogle.kggoogle.kigoogle.kzgoogle.lagoogle.ligoogle.lkgoogle.ltgoogle.lugoogle.lvgoogle.mdgoogle.megoogle.mggoogle.mkgoogle.mlgoogle.mngoogle.mugoogle.mvgoogle.mwgoogle.negoogle.nlgoogle.nogoogle.nrgoogle.nugoogle.plgoogle.pngoogle.psgoogle.ptgoogle.rogoogle.rsgoogle.rugoogle.rwgoogle.scgoogle.segoogle.shgoogle.sigoogle.skgoogle.smgoogle.sngoogle.sogoogle.srgoogle.stgoogle.tdgoogle.tggoogle.tlgoogle.tmgoogle.tngoogle.togoogle.ttgoogle.vugoogle.ws
device
DeviceOptional

Device profile for the search.

Type string · GET query or POST JSON · Default desktop

Example / input hint: desktop

Accepted valuesdesktoptabletmobile
location
LocationOptional

Named location used to localize results where available.

Type string · GET query or POST JSON

Example / input hint: Austin,Texas,United States

  • Use location or uule, not both. Geographic influence depends on the image search.
  • Maximum characters: 512
uule
Encoded locationOptional

Encoded geographic location used to localize results.

Type string · GET query or POST JSON

Example / input hint: w+CAIQICIYQXVzdGluLFRleGFzLFVuaXRlZCBTdGF0ZXM

  • Use location or uule, not both. Use gl with a coordinate-based location.
  • Maximum characters: 2048

// 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, image_results, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.

Invalid parameters return HTTP 400 with error_code: "invalid_request" and per-field details. Unavailable resources return HTTP 404 with error_code: "not_found". Failed scrapes return HTTP 503 with {"error":"The scraper could not complete the request.","error_code":"service_unavailable"}. Failed requests are not billed.

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

200 · application/json
{
  "search_metadata": {
    "id": "8f14e45fceea167a5a36dedd",
    "status": "Success",
    "created_at": "2026-11-13 16:35:00 UTC",
    "processed_at": "2026-11-13 16:35:02 UTC",
    "total_time_taken": 1.842
  },
  "search_parameters": {
    "image_url": "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png",
    "hl": "en",
    "num": 5
  },
  "image_results": [
    {
      "position": 1,
      "title": "Google logo",
      "link": "https://about.google/brand-resource-center/",
      "source": "about.google",
      "thumbnail": "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png",
      "original": "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png"
    }
  ],
  "submit_feedback_for_this_response_here": "https://api.litescrape.com/api/feedback/example-not-a-valid-token"
}

More Google APIs