---
title: "Retrieve video metadata & captions"
method: GET
path: "/youtube/video/{id}"
tags: ["YouTube"]
---

# Retrieve video metadata & captions

`GET /youtube/video/{id}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/youtube/video/{id}`
- Auth: API key in header `x-api-key`

Returns the metadata of a YouTube video by its 11-character `id`: title, description, channel id and title, publication time, duration in seconds, and view, like and comment counts. Some fields are best-effort.

## Path parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

Video details payload

- YoutubeVideoResponseDoc
  - `code` integer
  - `data` YoutubeVideoDetail
    - `channel_id` string: YouTube channel ID of the uploader.
    - `channel_title` string: Name of the channel that uploaded the video.
    - `comments_count` integer: Number of comments on the video; may be rounded when YouTube shows an abbreviated count. Omitted when unavailable.
    - `description` string: Full video description.
    - `dislikes_count` integer: may be hidden
    - `duration_seconds` number: length in seconds
    - `id` string: YouTube video ID.
    - `likes_count` integer: Number of likes on the video; may be rounded when YouTube shows an abbreviated count. Omitted when unavailable.
    - `published_at` string: Time the video was published, in RFC 3339.
    - `title` string: Video title as shown on YouTube.
    - `views_count` integer: Number of views of the video. Omitted when unavailable.
  - `msg` string

## Other responses

- `400`: Missing or invalid *id* parameter
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)