Real-Time Lens Data API

Real-Time Lens Data is a fast and reliable Google Lens API for searching by image in real-time. It returns visual matches, OCR text, and object data as structured JSON via REST.

What it returns: image search and visual matches, exact matches, object detection, and image-to-text (OCR).

This actor runs the same Real-Time Lens Data API that developers use on RapidAPI and OpenWeb Ninja, with the same endpoints, parameters and output.

What you can do with it

• Find products and visually similar items from a photo
• Track where an image appears on the web with exact matches
• Detect objects and extract text (OCR) from images
• Power visual search and shopping features

Endpoints

Pick the endpoint in the Endpoint field. Each run makes one call to that endpoint and writes its results to the dataset.

Image Search

GET /search

Search image by url and get visual matches, knowledge graph, and products found on the web. See it in action on - Google Lens.

Parameter	Required	Description
url	Yes	URL of an image with which to perform the search.
query	No	Search query to further refine the results.
language	No	Set the language of the results (Google's hl parameter). Allowed values: 2-letter language code, see ISO 639-1. Default: en.
country	No	Set the country for the search (Google's gl parameter). Allowed values: 2-letter country code, see ISO 3166. Default: us.

Visual Matches

GET /visual-matches

Get visual matches from the web for an image and optionally a query. This endpoint implements the "Visual Matches" on Google Lens.

Parameter	Required	Description
url	Yes	URL of an image for which to get visual matches.
query	No	Search query to further refine the results.
language	No	Set the language of the results (Google's hl parameter). Allowed values: 2-letter language code, see ISO 639-1. Default: en.
country	No	Set the country for the search (Google's gl parameter). Allowed values: 2-letter country code, see ISO 3166. Default: us.

Exact Matches

GET /exact-matches

Send an image URL and get the top 500 web pages with the same image (reverse image search). This endpoint implements the "Exact Matches" tab on Google Lens.

Parameter	Required	Description
url	Yes	URL of the image for which to find sources
limit	No	Maximum number of results to return. Default: 500.
safe_search	No	How to show explicit content in your search results, like sexual activity and graphic violence. Values: off, blur. Default: blur.

Object Detection

GET /object-detection

Detect landmarks, places, plants, animals, products, and other objects in an image, including bounding boxes, labels / types and confidence score.

Parameter	Required	Description
url	Yes	URL of an image to perform Google Lens object detection.

Image to Text

GET /ocr

Extract text from an image and get paragraph, sentence and word level text detections from Google Lens.

Parameter	Required	Description
url	Yes	URL of an image from which to extract text.
language	No	Set the language of the results. Allowed values: 2-letter language code, see ISO 639-1. Default: en.

Example input

{
  "endpoint": "/search",
  "url": "https://i.imgur.com/HBrB8p0.png"
}

Example output

One dataset item per result. A Image Search item looks like this (trimmed):

{
  "position": 1,
  "title": "Amazon.com | Nike mens Air Jordan 1 Mid Shoes, Cement Grey ...",
  "link": "https://www.amazon.com/Grey-Cement-White-True-Jordan/dp/B0G625STJX",
  "source": "www.amazon.com",
  "source_name": "Amazon.com",
  "source_icon": "https://encrypted-tbn2.gstatic.com/faviconV2?url=https://www.amazon.com&client=HORIZON&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL&nfrp=2",
  "thumbnail": "https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcT9wC6dsXmBCk0GgIOG9d0zt6vDEqYkdiRHYsjew8hrc-7f9tEU",
  "thumbnail_width": 225,
  "thumbnail_height": 225,
  "image": "https://images-na.ssl-images-amazon.com/images/I/61dLDXdOEhL._AC_UL600_SR600,600_.jpg",
  "image_width": 600,
  "image_height": 600
}

The run's key-value store OUTPUT record holds the request parameters, the request id and any non-list fields of the response (for example a pagination cursor).

Pricing

Pay per event: you pay per API request, at the same rates as our API plans. Most runs are one request; some parameters (such as fetching several pages at once) count as several, exactly as they do on the API.

Apify plan	Price per 1,000 requests
Free	$5.00
Starter (Bronze)	$2.50
Scale (Silver)	$1.50
Business (Gold) and above	$0.75

A request that fails is not charged.

Using it from code

Run it through the Apify API or a client library, with the input above as the JSON body:

curl -X POST "https://api.apify.com/v2/acts/openweb-ninja~real-time-lens-data/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"endpoint":"/search","url":"https://i.imgur.com/HBrB8p0.png"}'

Need higher volume or a direct REST API? Real-Time Lens Data API is also available as an API on OpenWeb Ninja and RapidAPI.

Support

For custom plans, high volumes or anything else:

• Email: support@openwebninja.com
• Discord: https://discord.gg/wxJxGsZgha