---
title: "Search Similar Thumbnails"
description: "The Search Similar Thumbnails API enables you to find YouTube videos with visually similar thumbnails based on text descriptions or image analysis. This powerful tool helps identify thumbnail trends, discover content opportunities, and analyze successful thumbnail patterns using advanced visual similarity algorithms."
source: "https://dashboard.nexlev.io/docs/n8n/similar-thumbnails"
---

# Search Similar Thumbnails

The Search Similar Thumbnails API enables you to find YouTube videos with visually similar thumbnails based on text descriptions or image analysis. This powerful tool helps identify thumbnail trends, discover content opportunities, and analyze successful thumbnail patterns using advanced visual similarity algorithms.

## Overview

Use this API to find videos that have thumbnails matching a specific visual concept or style. This resource analyzes thumbnail imagery and returns a list of videos with similar thumbnails ranked by visual similarity, helping you understand thumbnail trends and discover content inspiration.

## Quick Start

Get started in 3 simple steps:

1. **Install NexLev**: Add the NexLev node to your n8n instance ([Installation Guide](/docs/n8n/quickstart))
2. **Get API Key**: Create your API key at [API Key](https://dashboard.nexlev.io/nexlev-api/create-api-key)
3. **Make Your First Request**:
   - Add NexLev node → Select "Similar Thumbnail" → Choose "Search Similar Thumbnails"
   - Select Search Type (Text or Image URL)
   - Enter your search query
   - Execute to get videos with similar thumbnails

**Example Result**: You'll receive a list of videos with thumbnails matching your search, ranked by visual similarity score.

### Endpoint Details

- **Resource**: Similar Thumbnail
- **Operations**: Search Similar Thumbnails
- **Authentication**: Required ([API Key](https://dashboard.nexlev.io/nexlev-api/create-api-key))
- **Pagination**: ❌ No
- **Search Types**: Text | Image URL
- **Returns**: Array of videos with similar thumbnails
- **Quota Cost**: 🥞 **10 quota** per request

### API Reference

> **Info**
>
> Full endpoint details, cURL example, and response schema live in the [Similar
> Thumbnails API reference](/docs/api/similar-thumbnails).

**Endpoint**: `POST /api/external/similar-thumbnails/search` · **Quota Cost**: 🥞 10 — see [Rate Limits & Quota](/docs/api/rate-limits)

> **Warning**
>
> **Authentication Required** — see [Authentication](/docs/api/authentication)
> for the required header format and how to get an API key.

## Configuration

### Parameters

| Parameter   | Type   | Required | Description                                                                               |
| ----------- | ------ | -------- | ----------------------------------------------------------------------------------------- |
| Search Type | string | Yes      | The type of search to perform (Text or Image URL)                                         |
| Text        | string | Yes\*    | Text description of the thumbnail you want to find (required when Search Type is "Text")  |
| Image URL   | string | Yes\*    | URL of an image to find similar thumbnails for (required when Search Type is "Image URL") |

\* One of Text or Image URL is required based on the selected Search Type.

### Search Type Options

The Search Type parameter determines how you want to search for similar thumbnails. You can choose between two search methods:

| Option    | Description                                                                                                                                                                                                                                |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Text      | Search for thumbnails based on a text description. Enter a descriptive phrase that represents the visual concept you're looking for (e.g., "Dogs playing in the Mars", "sunset over mountains", "tech gadget review with blue background") |
| Image URL | Search for thumbnails similar to a provided image URL. Provide a direct URL to an image, and the API will find YouTube thumbnails with similar visual characteristics                                                                      |

### Setup Steps

**Step 1: Add NexLev Node**

- Add the **NexLev** node to your workflow
- See [Quickstart Guide](/docs/n8n/quickstart) for installation instructions

**Step 2: Configure Resource**

- Under **Resource**, select **Similar Thumbnail**

**Step 3: Select Operation**

- Under **Operation**, select **Search Similar Thumbnails**

**Step 4: Authentication**

- Under **Credential to connect with**, select your **NexLev account**
- If not configured, create one using your [API Key](https://dashboard.nexlev.io/nexlev-api/create-api-key)

**Step 5: Choose Search Type** ✅ Required

- Under **Search Type**, select either:
  - **Text** - To search using a text description
  - **Image URL** - To search using an image URL

**Step 6: Enter Search Query** ✅ Required

Based on your Search Type selection:

- If **Text**: Enter a descriptive text of the thumbnail you want to find (e.g., "Dogs playing in the Mars", "tech gadget review with blue background")
- If **Image URL**: Enter the URL of the image you want to find similar thumbnails for

![Configure search similar thumbnails operation](https://dashboard.nexlev.io/images/documentation/search-similar-thumbnails.png)

### Execution

Click **Execute step** to retrieve a list of videos with similar thumbnails ranked by visual similarity score.

### Response

> **Tip**
>
> Full response schema and error codes: [Similar Thumbnails — API Reference
> →](/docs/api/similar-thumbnails#search-similar-thumbnails)

## Use Cases

Leverage similar thumbnail discovery in your workflows for:

- **Thumbnail Inspiration**: Find successful thumbnails that match your content concept for design inspiration
- **Trend Analysis**: Identify popular thumbnail styles and visual patterns in your niche
- **Competitor Research**: Discover how competitors are designing thumbnails for similar content
- **A/B Testing Ideas**: Find variations of thumbnail styles to test for your own videos
- **Content Discovery**: Find videos with similar visual themes for collaboration or research
- **Brand Consistency**: Ensure your thumbnails align with successful patterns in your category
- **Visual SEO**: Understand what thumbnail styles attract the most views in your niche
- **Outlier Detection**: Identify thumbnails that significantly outperform average engagement
- **Market Research**: Analyze thumbnail trends across different content categories
- **Creative Benchmarking**: Compare your thumbnail designs against top performers

## Examples

### Basic Text-Based Thumbnail Search

1. Add a [Manual Trigger](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.manualworkflowtrigger/) or [Schedule Trigger](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.scheduletrigger/) node
2. Add the **NexLev** node and configure it for **Search Similar Thumbnails** operation
3. Set **Search Type** to **Text**
4. Enter a descriptive text like "sunset over mountains with hiking"
5. Add a [Code](https://docs.n8n.io/code-examples/) node to filter results by similarity score (e.g., score > 0.7)
6. Add an output node (e.g., [Google Sheets](https://docs.n8n.io/integrations/builtin/app-nodes/n8n-nodes-base.googlesheets/), **Airtable**, [Webhook](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.webhook/))

### Image-Based Thumbnail Analysis

1. Add a [Manual Trigger](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.manualworkflowtrigger/) node
2. Add the **NexLev** node:
   - Operation: **Search Similar Thumbnails**
   - Search Type: **Image URL**
   - Image URL: URL of your reference thumbnail
3. Add a [Code](https://docs.n8n.io/code-examples/) node to analyze the results
4. Export to **Notion** or **Airtable** for reference

### Thumbnail Trend Monitoring

1. Add a [Schedule Trigger](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.scheduletrigger/) node (e.g., daily)
2. Add the **NexLev** node to search for thumbnails matching your niche keywords
3. Add a **Loop** node to process each result
4. Add a [Code](https://docs.n8n.io/code-examples/) node to extract thumbnail patterns and statistics
5. Add a [Google Sheets](https://docs.n8n.io/integrations/builtin/app-nodes/n8n-nodes-base.googlesheets/) node to track trends over time
6. Add a **Slack** or **Email** node to alert on significant changes

### Outlier Thumbnail Discovery

1. Add a [Manual Trigger](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.manualworkflowtrigger/) node
2. Add the **NexLev** node to search for similar thumbnails
3. Add a **Filter** node to select only results where `calculatedData.isOutlier` is true
4. Add a [Code](https://docs.n8n.io/code-examples/) node to analyze what makes these thumbnails successful
5. Export results to your preferred destination

### Competitive Thumbnail Analysis

1. Add a [Manual Trigger](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.manualworkflowtrigger/) node with competitor video URLs
2. Use a [Code](https://docs.n8n.io/code-examples/) node to extract thumbnail URLs from the videos
3. Add the **NexLev** node with **Image URL** search type
4. Add a **Loop** node to analyze each competitor thumbnail
5. Add a [Code](https://docs.n8n.io/code-examples/) node to compile competitive insights
6. Export to **Notion** or **Airtable** for strategic planning

## Related Resources

- [Quickstart Guide](/docs/n8n/quickstart) - Learn how to set up NexLev with n8n
- [Video Content](/docs/n8n/video-content) - Get comprehensive video information
- [Similar Videos](/docs/n8n/similar-videos) - Find videos similar to a given video
- [Channel Content](/docs/n8n/channel-content) - Retrieve channel information and video lists
- [Channel Analytics](/docs/n8n/channel-analytics) - Get detailed analytics data for channels

## Support

If you encounter issues or have questions about the Search Similar Thumbnails API, please contact our support team at [contact@nexlev.io](mailto:contact@nexlev.io) or refer to our troubleshooting guide.