# YouTube Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/youtube/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/youtube-search |

## Description

Unlock YouTube search data for content strategy, market research, and optimized marketing campaigns with our API.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/youtube/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "videos": [
    {
      "link": "https://www.youtube.com/watch?v=example1",
      "title": "House Tour: A Beautiful Contemporary Home",
      "views": "1.2M views",
      "channel": "Dream Homes",
      "uploaded": "3 days ago",
      "thumbnail": "https://example.com/thumbnail1.jpg"
    },
    {
      "link": "https://www.youtube.com/watch?v=example2",
      "title": "What $500k Buys You in Different Cities",
      "views": "983K views",
      "channel": "Real Estate Insider",
      "uploaded": "5 days ago",
      "thumbnail": "https://example.com/thumbnail2.jpg"
    },
    {
      "link": "https://www.youtube.com/watch?v=example3",
      "title": "Tiny House Living: Pros and Cons",
      "views": "672K views",
      "channel": "Tiny House Giant Journey",
      "uploaded": "1 week ago",
      "thumbnail": "https://example.com/thumbnail3.jpg"
    },
    {
      "link": "https://www.youtube.com/watch?v=example4",
      "title": "Top 10 Luxurious Mansions",
      "views": "2.1M views",
      "channel": "Luxury Listings",
      "uploaded": "2 weeks ago",
      "thumbnail": "https://example.com/thumbnail4.jpg"
    },
    {
      "link": "https://www.youtube.com/watch?v=example5",
      "title": "Buying a House in 2023: Tips and Tricks",
      "views": "850K views",
      "channel": "Smart Home Shopper",
      "uploaded": "1 month ago",
      "thumbnail": "https://example.com/thumbnail5.jpg"
    },
    {
      "link": "https://www.youtube.com/watch?v=example6",
      "title": "Affordable Beach Houses Under $300k",
      "views": "900K views",
      "channel": "Coastal Homes",
      "uploaded": "1 month ago",
      "thumbnail": "https://example.com/thumbnail6.jpg"
    }
  ],
  "related_searches": [
    {
      "link": "https://www.youtube.com/results?search_query=modern+house+tour",
      "query": "modern house tour"
    },
    {
      "link": "https://www.youtube.com/results?search_query=tiny+house+tour",
      "query": "tiny house tour"
    },
    {
      "link": "https://www.youtube.com/results?search_query=luxury+homes",
      "query": "luxury homes"
    },
    {
      "link": "https://www.youtube.com/results?search_query=affordable+houses",
      "query": "affordable houses"
    }
  ]
}
```

## Documentation

## Overview
Unlock YouTube search data for content strategy, market research, and optimized marketing campaigns with our API.

## Quickstart
```
GET https://api.piloterr.com/v2/youtube/search?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate YouTube Search data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Youtube without maintaining scrapers
- Power internal dashboards and workflow automations with live Youtube data