reverse-image-search-api

KO | EN

gitlite — search

#hacktoberfest #go #android #machine-learning #linux #awesome #cli #kubernetes #vue #security #ios #mcp #openai #open-source

reverse-image-search-api

(★ 10)

Lenso.ai is an AI-powered reverse image search tool that recently launched its reverse image search API. Here you'll find example requests and common usage scenarios for lenso.ai’s reverse image search public API. The documentation includes endpoints for image-based searches by face or category, along with examples.

reverse-image-search-api 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<table align="center">
  <tr>
    <td>
      <a href="https://lenso.ai">AI Reverse Image Search with lenso.ai. Find places, people, duplicates, and more.</a>
    </td>
  </tr>
</table>

# 📸 [Lenso.ai](https://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.

<div align="center">
  <a href="https://lenso.ai/en/page/reverse-image-search">Reverse Image Search</a>
    ·
   <a href="https://lenso.ai/en/page/face-search">Face Search</a>
    ·
   <a href="https://lenso.ai/en/page/copyright-image-search">Copyright Image Search</a>  
    ·
    <a href="https://huggingface.co/LensoAI">Hugging Face</a>
    ·
    <a href="https://chromewebstore.google.com/detail/lensoai-reverse-image-sea/fdlopgpbkloofphfpbikfcdhfalkmpmp">Chrome Extension </a>  
</div>

## 📌 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:**

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

### 👤 Face Search

**Endpoint:**

```http
POST https://api.eyematch.ai/search
```
**Request parameters**
```json
{
    "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:**

```http
POST https://api.lenso.ai/search
```
**Request parameters**
```json
{
    "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
```json
{
    "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.                |

reverse-image-search-api

reverse-image-search-api 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

reverse-image-search-api

reverse-image-search-api 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README