---
title: "Get video details"
method: GET
path: "/youtube/video"
tags: ["YouTube"]
---

# Get video details

`GET /youtube/video`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/youtube/video`
- Auth: API key in header `X-API-KEY`

## Query parameters

- `video_id` string
- `videoId` string

## Response `200`

- object
  - `id` string, required
  - `videoId` string, required
  - `title` string, required
  - `description` string, required
  - `thumbnail` string, required
  - `duration` string, required
  - `viewCount` string, required
  - `shortViewCount` string, required
  - `likeCount` integer, required
  - `publishDate` string, required
  - `uploadDate` string, required
  - `channel` object, required
    - `id` string, required
    - `name` string, required
    - `thumbnail` string, nullable, required
    - `subscriberCount` string, nullable, required
    - `verified` boolean, required
  - `hashtags` string[], required
  - `keywords` string[], required
  - `category` string, required
  - `isLive` boolean, required
  - `isPremium` boolean, required
  - `isPrivate` boolean, required
  - `chapters` object[], required
    - `title` string, required
    - `startTime` integer, required
    - `startTimeMillis` integer, required
    - `thumbnail` string, nullable, required
  - `captions` array[], required
    - unknown[]
      - unknown
  - `comments` array[], nullable, required
    - unknown[]
      - unknown
  - `relatedVideos` array[], nullable, required
    - unknown[]
      - unknown
  - `annotations` array[], nullable, required
    - unknown[]
      - unknown
  - `autoplay` object, nullable, required
    - `countDownSecs` integer, required
    - `sets` integer, required
  - `cards` array[], nullable, required
    - unknown[]
      - unknown
  - `endScreen` object, nullable, required
    - `startMs` integer, required
    - `elements` array[], required
      - unknown[]
        - unknown
  - `hasStreamingData` boolean, required
  - `license` string, nullable, required
  - `merchandise` unknown[], nullable, required
    - unknown
  - `playerConfig` object, nullable, required
    - `audioConfig` unknown[], required
      - unknown
    - `maxBitrate` string, required
  - `playerOverlays` object, nullable, required
    - `endScreen` unknown[], required
      - unknown
    - `autoplay` unknown[], required
      - unknown
    - `shareButton` unknown[], required
      - unknown
    - `decoratedPlayerBar` unknown[], required
      - unknown
  - `streamingDataExpires` integer, nullable, required
  - `topComments` boolean, nullable, required

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: Validation error

---

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