---
title: "YouTube"
description: "YouTube videos whose title or description names your keyword."
canonical: https://docs.mentio.dev/platforms/youtube
markdown: https://docs.mentio.dev/platforms/youtube.mdx
---

# YouTube

YouTube videos whose title or description names your keyword.

Mentio searches YouTube for new videos whose title or description contains your keyword.

| `platform`                    | `youtube`                     |
| ----------------------------- | ----------------------------- |
| What is found                 | Video titles and descriptions |
| Freshness                     | About every 12 hours          |
| Last 30 days on a new keyword | Yes, the newest 10            |

## Track it [#track-it]

Create a keyword limited to YouTube. Leave `platforms` out to search every platform.

TypeScript:

```ts
const response = await fetch('https://api.mentio.dev/v1/keywords', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MENTIO_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "term": "Acme",
    "kind": "brand",
    "platforms": [
      "youtube"
    ]
  }),
});

const data = await response.json();
console.log(data);
```

Python:

```python
import os
import requests

response = requests.post(
    "https://api.mentio.dev/v1/keywords",
    headers={"Authorization": f"Bearer {os.environ['MENTIO_API_KEY']}"},
    json={
      "term": "Acme",
      "kind": "brand",
      "platforms": [
        "youtube"
      ]
    },
)
print(response.json())
```

cURL:

```bash
curl -X POST "https://api.mentio.dev/v1/keywords" \
  -H "Authorization: Bearer $MENTIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "term": "Acme",
  "kind": "brand",
  "platforms": [
    "youtube"
  ]
}'
```

## Read its mentions [#read-its-mentions]

Filter the mentions list to YouTube. `minViews=1000` keeps the videos with at least a thousand views.

TypeScript:

```ts
const response = await fetch('https://api.mentio.dev/v1/mentions?platforms=youtube&minViews=1000', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.MENTIO_API_KEY}`,
  },
});

const data = await response.json();
console.log(data);
```

Python:

```python
import os
import requests

response = requests.get(
    "https://api.mentio.dev/v1/mentions?platforms=youtube&minViews=1000",
    headers={"Authorization": f"Bearer {os.environ['MENTIO_API_KEY']}"},
)
print(response.json())
```

cURL:

```bash
curl -X GET "https://api.mentio.dev/v1/mentions?platforms=youtube&minViews=1000" \
  -H "Authorization: Bearer $MENTIO_API_KEY"
```

Response (trimmed):

```json
{
  "data": [
    {
      "id": "mm_8f2k1x9q",
      "status": "open",
      "relevant": true,
      "keyword": {
        "id": "kw_123",
        "term": "Acme"
      },
      "post": {
        "publishedAt": "2026-11-07T14:32:10.000Z",
        "platform": "youtube",
        "kind": "post",
        "url": "https://www.youtube.com/watch?v=dQw4abcd123",
        "title": "Acme review after 6 months",
        "text": "An honest look at Acme after six months running our support on it.",
        "engagement": {
          "likes": 940,
          "replies": 120,
          "views": 38100
        }
      },
      "author": {
        "name": "Tool Talk",
        "handle": "@tooltalk",
        "url": "https://www.youtube.com/@tooltalk",
        "followers": 51200
      },
      "classification": {
        "relevance": 82,
        "sentiment": "positive",
        "intents": [
          "praise"
        ],
        "note": "A user recommends Acme by name."
      }
    }
  ],
  "nextCursor": "eyJ0IjoxNzMxMDAwMDAwfQ"
}
```

## What a mention carries [#what-a-mention-carries]

* `post.text`: the title and the full description.
* `author`: the channel name and link.

The rest is the same on every platform: relevance, sentiment and intent from the classifier, your triage, and the keyword it matched. See the [mention shape](/api).

## Mute an author [#mute-an-author]

A channel link, `youtube.com/channel/UC…`. An `@handle` link is accepted but cannot match: mentions carry the channel link and name. See [Mute authors](/alerts#mute-authors).

## Limits [#limits]

* What is said in a video (captions, speech) is not searched.
* YouTube lists new videos in search up to a few days late, so a video can arrive after its publish date.
* Comments are not read.