# YouTube video

## Overview

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

## Description

Unlock YouTube video data with Piloterr API: access titles, views, likes, comments, and more for smarter decisions.

## 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/video' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "tags": [
    "tag1",
    "tag2",
    "tag3"
  ],
  "title": "Sample YouTube Video Title",
  "videoId": "yYDb9Jig6q0",
  "duration": "PT10M30S",
  "videoUrl": "https://www.youtube.com/watch?v=yYDb9Jig6q0",
  "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
  "likeCount": "8901",
  "viewCount": "1234567",
  "description": "This is a sample description of the YouTube video, providing an overview of the content.",
  "publishedAt": "2021-01-01T00:00:00Z",
  "channelTitle": "Sample Channel Name",
  "commentCount": "567",
  "dislikeCount": "234",
  "thumbnailUrl": "https://i.ytimg.com/vi/yYDb9Jig6q0/maxresdefault.jpg"
}
```

## Documentation

## Overview
Unlock YouTube video data with Piloterr API: access titles, views, likes, comments, and more for smarter decisions.

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

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

## Main use cases
- Integrate YouTube video 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