AI Reverse Image Search with lenso.ai. Find places, people, duplicates, and more.

📸 Lenso.ai Reverse Image Search API examples

Lenso.ai provides a powerful reverse image search API. It features simple integration and a variety of tools to help meet your needs, including:

• Search by image within specific categories: People, Duplicates & Copyrights, Places, Similar, or Related images
• Domain filtering: Narrow results by specifying a particular domain.
• Advanced sorting options: Sort results by best match, worst match, newest, or oldest.

Additionally, you can easily monitor your API usage directly from the lenso.ai dashboard.

For tailored solutions or custom API plans, please contact our support team at contact@lenso.ai.

Reverse Image Search · Face Search · Copyright Image Search · Hugging Face · Chrome Extension

📌 Table of Contents

• 🔍 Overview
• 🛡️ Authorization
• 📡 Reverse image search API endpoints
  • 🛠️ Usage
  • 👤 Face Search
  • 📂 Category Search
• ✅ Sample Response
• ❗ Error Handling

---

🔍 Overview

This project includes:

• Usage examples of the Lenso.ai reverse image search API
• JSON request/response formats
• Authorization headers
• Supported parameters and error responses

The API allows developers to send images in base64 format and receive search results based on face similarity or predefined categories such as duplicates or places.

---

🛡️ Authorization

Replace <your_access_token> with your actual access token obtained from lenso.ai website.

Header	Type	Description
Authorization	string	Bearer token required for authentication. Format: Bearer <your_access_token>.

---

📡 Reverse image search API endpoints

🛠️ Usage

Endpoint:

GET https://api.lenso.ai/usage

👤 Face Search

Endpoint:

POST https://api.eyematch.ai/search

Request parameters

{
    "image": "base64-encoded string",
    "sortType": "string",
    "domain": "string",
    "page": "integer (starts from 1)",
    "multiPage": "list of integers (starts from 1)",
    "domainsToInclude": "set of string" (Limited to 100),
    "domainsToExclude": "set of string" (Limited to 100),
    "fromDate": "string",
    "toDate": "string"
}

Request Parameters Explanation

Parameter	Type	Description
image	string	A base64-encoded string of the image you want to search for
sortType	string	The sorting method for search results. Valid sort types are: "QUALITY_DESCENDING","QUALITY_ASCENDING","DATE_DESCENDING","DATE_ASCENDING"
domain	string	An optional field specifying the domain of the search
page	integer	The page number for search results. One page have a limit up to 20 results. "multiPage and "page" cannot be null at the same time.
multiPage	list of integers	Returns results from multiple pages. 1 returned page counts as 1 request. 1 page returns up to 20 results. "multiPage and "page"cannot be null at the same time.
domainsToInclude	set of string	(Optional) Includes results whose source URL or domain contains any of the specified keywords. (Limited to 100)
domainsToExclude	set of string	(Optional) Excludes results whose source URL or domain contains any of the specified keywords. (Limited to 100)
fromDate	string	(Optional) Returns search results that have been indexed after this date. ISO 8601 [yyyy-MM-dd] ]
toDate	string	(Optional) Returns search results that have been indexed before this date. ISO 8601 [yyyy-MM-dd]

📂 Category Search

Endpoint:

POST https://api.lenso.ai/search

Request parameters

{
    "image": "base64-encoded string",
    "sortType": "string",
    "domain": "string",
    "category": "string",
    "page": "integer (starts from 1)",
    "multiPage": "list of integers (starts from 1)",
    "domainsToInclude": "set of string" (Limited to 100),
    "domainsToExclude": "set of string" (Limited to 100),
    "fromDate": "string",
    "toDate": "string"
}

Request Parameters Explanation

Parameter	Type	Description
image	string	A base64-encoded string of the image you want to search for
sortType	string	The sorting method for search results. Valid sort types are: "QUALITY_DESCENDING","QUALITY_ASCENDING","DATE_DESCENDING","DATE_ASCENDING"
domain	string	An optional field specifying the domain of the search
category	string	The category to filter search results. Valid categories are: "duplicates","landmarks","similar","related"
page	integer	The page number for search results. One page have a limit up to 20 results. "multiPage and "page" cannot be null at the same time.
multiPage	list of integers	Returns results from multiple pages. 1 returned page counts as 1 request. 1 page returns up to 20 results. "multiPage and "page"cannot be null at the same time.
domainsToInclude	set of string	(Optional) Includes results whose source URL or domain contains any of the specified keywords. (Limited to 100)
domainsToExclude	set of string	(Optional) Excludes results whose source URL or domain contains any of the specified keywords. (Limited to 100)
fromDate	string	(Optional) Returns search results that have been indexed after this date. ISO 8601 [yyyy-MM-dd] ]
toDate	string	(Optional) Returns search results that have been indexed before this date. ISO 8601 [yyyy-MM-dd]

---

✅ Sample Response

{
    "results": [
        {
            "urlList": [
                {
                    "imageUrl": "https://example.com/image1.jpg",
                    "sourceUrl": "https://example.com/source1",
                    "title": "Example Image 1"
                }
            ],
            "base64Image": "iVBORw0KGgoAAAANSUhEUg...",
            "confidenceScore": (0-100),
            "date":"2025-01-30"
        }
    ],
    "availablePages": 5,
    "multiPage": [1,3,4]
}

Field	Type	Description
results	Array	List of search results
results[].urlList	Array	List of objects containing image data
results[].urlList[].imageUrl	String (URL)	URL of the image
results[].urlList[].sourceUrl	String (URL)	URL of the source page where the image is hosted
results[].urlList[].title	String	Title of the image
results[].base64Image	String (base64)	Image encoded in base64 format
results[].confidenceScore	Number (0-100)	Confidence score of the result
results[].date	string	Indexing date
availablePages	Number	Number of available pages with results
multiPage	List of numbers	List of page numbers form which results were merged

---

❗ Error Handling

Error Code	Message
400	Request cannot be null or empty.
400	Image cannot be null or blank.
400	Image must be encoded in Base64 format.
400	Category cannot be null or blank.
400	Invalid sort type. Valid sort types are "QUALITY_DESCENDING", "QUALITY_ASCENDING", "DATE_DESCENDING", "DATE_ASCENDING".
400	Sort type cannot be null or blank.
400	Invalid category name. Valid categories are "duplicates", "landmarks", "similar", "related".
400	Page number and multiPage cannot be null at the same time.
400	Invalid date format. Valid format is ISO 8601 [yyyy-MM-dd].
400	Invalid page number.
400	API access request limit reached.
400	Domain count exceeds the limit of 100.
401	Unable to authorize. Invalid access token.
401	API access expired.
404	Requested resource not found.
429	You have exceeded the allowed number of requests. Please try again later.
500	Internal server error. Try again.