# YouTube API: Get video

> Gets public details and statistics for one YouTube video by link, ID or title. A title selects the top search match.

Unofficial. Not affiliated with or endorsed by YouTube.

- Page: https://fous.com/methods/youtube.com/get-video
- Method: `youtube.com/get_video`, version 1
- Website: youtube.com
- Returns: title, channel, views, likes, comments, publish date, length, description, chapters, tags, captions
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `video` | string | yes | `"Python for Beginners – Full Course [Programming Tutorial]"` | YouTube video link, ID, or title, for example https://www.youtube.com/watch?v=dQw4w9WgXcQ. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "video": "Python for Beginners – Full Course [Programming Tutorial]"
}
```

Its output:

```json
{
  "tags": [],
  "likes": 87335,
  "title": "Python for Beginners – Full Course [Programming Tutorial]",
  "views": 4963507,
  "length": "4:39:59",
  "is_live": false,
  "category": "Education",
  "chapters": [
    {
      "title": "Introduction",
      "start_time": "0:00"
    },
    {
      "title": "RPS - Variables and Functions",
      "start_time": "3:11"
    },
    {
      "title": "RPS - Calling Functions",
      "start_time": "9:07"
    }
  ],
  "is_short": false,
  "video_id": "eWRfhZUzrAc",
  "channel_id": "UC8butISFwT-Wl7EV0hUK0BQ",
  "video_link": "https://www.youtube.com/watch?v=eWRfhZUzrAc",
  "description": "Learn the Python programming language in this full course for beginners! You will learn the fundamentals of Python and code two Python programs line-by-line. No previous programming experience is necessary before watching this course.\n\n🔗 Start using Replit: https://join.replit.com/python-students\n\n…",
  "channel_link": "https://www.youtube.com/@freecodecamp",
  "channel_name": "freeCodeCamp.org",
  "publish_date": "2022-08-09",
  "matched_video": "Python for Beginners – Full Course [Programming Tutorial]",
  "length_seconds": 16799,
  "thumbnail_link": "https://i.ytimg.com/vi/eWRfhZUzrAc/maxresdefault.jpg",
  "caption_languages": [
    "English"
  ],
  "number_of_comments": 2014,
  "channel_subscribers": "12M subscribers"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"youtube.com/get_video","input":{"video":"Python for Beginners – Full Course [Programming Tutorial]"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Can you pull up the views, likes, and comment count for https://www.youtube.com/watch?v=jNQXAC9IVRw?
- What's the channel name and publish date for the video with ID 9bZkp7q19f0?
- Get the chapters and description for the YouTube video titled 'How to Bake Sourdough at Home'.
- I need the length and tags of this video: https://youtu.be/kJQP7kiw5Fk
- Does the video 'Lo-fi Study Beats Mix 2023' have captions, and how many views does it have?

## Input schema

```json
{
  "type": "object",
  "required": [
    "video"
  ],
  "properties": {
    "video": {
      "type": "string",
      "minLength": 1,
      "description": "YouTube video link, ID, or title, for example https://www.youtube.com/watch?v=dQw4w9WgXcQ."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "title",
    "video_link",
    "video_id",
    "chapters",
    "tags",
    "caption_languages",
    "is_live",
    "is_short"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "likes": {
      "type": [
        "integer",
        "null"
      ]
    },
    "title": {
      "type": [
        "string",
        "null"
      ]
    },
    "views": {
      "type": [
        "integer",
        "null"
      ]
    },
    "length": {
      "type": [
        "string",
        "null"
      ]
    },
    "is_live": {
      "type": "boolean"
    },
    "category": {
      "type": [
        "string",
        "null"
      ]
    },
    "chapters": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "start_time": {
            "type": "string"
          }
        }
      }
    },
    "is_short": {
      "type": "boolean"
    },
    "video_id": {
      "type": "string"
    },
    "channel_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "video_link": {
      "type": "string"
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    },
    "channel_link": {
      "type": [
        "string",
        "null"
      ]
    },
    "channel_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "publish_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "matched_video": {
      "type": [
        "string",
        "null"
      ]
    },
    "length_seconds": {
      "type": [
        "integer",
        "null"
      ]
    },
    "thumbnail_link": {
      "type": [
        "string",
        "null"
      ]
    },
    "caption_languages": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "number_of_comments": {
      "type": [
        "integer",
        "null"
      ]
    },
    "channel_subscribers": {
      "type": [
        "string",
        "null"
      ]
    }
  }
}
```

## See more

- [YouTube API: Get video comments](https://fous.com/methods/youtube.com/get-video-comments.md): Gets public top-level comments on a YouTube video, found by link, video ID or title. Reply text is not included.
- [YouTube API: Get video transcript](https://fous.com/methods/youtube.com/get-video-transcript.md): Returns the spoken captions and timed segments of a YouTube video, given a video link or a title (top search match). Only captions the video has are returned.
- [YouTube API: Get channel](https://fous.com/methods/youtube.com/get-channel.md): Gets a public YouTube channel's profile, links and statistics from its name, @handle or link. Subscriber totals may be rounded as YouTube displays them.
- [YouTube API: List channel videos](https://fous.com/methods/youtube.com/list-channel-videos.md): Lists a YouTube channel's public videos, Shorts, or live uploads, newest first or most popular first, along with channel details. Counts and dates taken from displayed text may be approximate.
- [YouTube API: Find a company's channel](https://fous.com/methods/youtube.com/find-company-channel.md): Finds a company's verified YouTube channel by name and returns its name, link, subscriber count, description, country and official website when identifiable.
- [YouTube API: List top songs chart](https://fous.com/methods/youtube.com/list-top-songs.md): Lists the latest weekly YouTube Music Top Songs chart for a country or globally, with ranks, weekly views and video links.
- [Vimeo API: Get video details](https://fous.com/methods/vimeo.com/get-video.md): Gets a public Vimeo video's title, creator, play, like and comment counts, length, upload date, description, tags, thumbnail and link from its video link.
- [Bilibili API: Get video](https://fous.com/methods/bilibili.com/get-video.md): Gets public statistics and details for a Bilibili video from its link, BV number or title. A title selects the top video search match. Category may be missing when Bilibili does not show a label.
- [All YouTube methods](https://fous.com/methods/youtube.com.md)