# YouTube Video Info

Get comprehensive video metadata from YouTube including views, likes, description, and channel info.

- **Documentation:** [https://scrappa.co/docs/youtube-api/youtube_video](https://scrappa.co/docs/youtube-api/youtube_video)
- **API group:** YouTube API
- **Endpoint:** `GET https://scrappa.co/api/youtube/video`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `video_id` | string | Yes | YouTube video ID (alias: videoId) |
| `videoId` | string | Yes | YouTube video ID (alias: video_id) |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/youtube/video?video_id=dQw4w9WgXcQ"
```

## Example response

```json
{
    "id": "dQw4w9WgXcQ",
    "videoId": "dQw4w9WgXcQ",
    "title": "Rick Astley - Never Gonna Give You Up (Official Video)",
    "description": "The official video for Never Gonna Give You Up by Rick Astley.",
    "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
    "duration": "3:33",
    "viewCount": "1,741,182,393 views",
    "shortViewCount": null,
    "likeCount": 18788542,
    "publishDate": "Oct 25, 2009",
    "uploadDate": "16 years ago",
    "channel": {
        "id": "UCuAXFkgsw1L7xaCfnd5JJOw",
        "name": "Rick Astley",
        "thumbnail": "https://yt3.ggpht.com/example.jpg",
        "url": "https://www.youtube.com/@RickAstleyYT",
        "subscriberCount": "4.45M subscribers",
        "isVerified": false,
        "isVerifiedArtist": true,
        "badges": [
            {
                "type": "BADGE_STYLE_TYPE_VERIFIED_ARTIST",
                "tooltip": "Official Artist Channel"
            }
        ]
    },
    "hashtags": [
        "#RickAstley",
        "#NeverGonnaGiveYouUp"
    ],
    "keywords": [
        "rick astley",
        "Never Gonna Give You Up"
    ],
    "category": "Music",
    "isLiveContent": false,
    "isLive": false,
    "isUnlisted": false,
    "isFamilySafe": true,
    "isPremium": false,
    "isPrivate": false,
    "isAgeRestricted": false,
    "isCrawlable": true,
    "isUpcoming": false,
    "isPostLiveDvr": false,
    "isLiveDvrEnabled": false,
    "isLowLatencyLiveStream": false,
    "hasLivechat": false,
    "chapters": [],
    "captions": [
        {
            "language": "en",
            "name": "English",
            "isAutoGenerated": false,
            "isTranslatable": true
        }
    ],
    "embed": {
        "iframeUrl": "https://www.youtube.com/embed/dQw4w9WgXcQ",
        "width": 1280,
        "height": 720,
        "isEmbeddable": true
    },
    "relatedVideos": [
        {
            "id": "yPYZpwSpKmA",
            "title": "Rick Astley - Together Forever",
            "thumbnail": "https://i.ytimg.com/vi/yPYZpwSpKmA/hqdefault.jpg",
            "duration": "3:24",
            "viewCount": "196M views",
            "publishedTime": "16 years ago",
            "channel": {
                "name": "Rick Astley",
                "verified": false
            },
            "badges": [],
            "isLive": false
        }
    ],
    "storyboards": [
        {
            "templateUrl": "https://i.ytimg.com/sb/dQw4w9WgXcQ/storyboard3_L0/default.jpg",
            "thumbnailWidth": 48,
            "thumbnailHeight": 27,
            "thumbnailCount": 100,
            "columns": 10,
            "rows": 10
        }
    ],
    "regionInfo": {
        "availableCountries": null,
        "blockedCountries": null,
        "isPlayable": true,
        "status": "OK",
        "reason": null,
        "embeddable": true
    },
    "comments": {
        "count": "1.2M comments",
        "teaser": "Great song!"
    },
    "playabilityStatus": {
        "status": "OK",
        "reason": null,
        "embeddable": true,
        "audioOnlyPlayability": null
    },
    "annotations": [
        {
            "id": "5dad8f5d-0000-20c2-8451-883d24f8e7cc",
            "type": "PlayerAnnotationsExpanded",
            "allowSwipeDismiss": true,
            "featuredChannel": {
                "id": null,
                "name": null,
                "thumbnail": null
            }
        }
    ],
    "autoplay": {
        "countDownSecs": 5,
        "sets": 1
    },
    "cards": [
        {
            "id": null,
            "title": "",
            "subtitle": "",
            "thumbnail": null,
            "url": null,
            "type": "Card",
            "endpoint": null
        }
    ],
    "endScreen": {
        "startMs": 201451,
        "elements": [
            {
                "id": "720b1b77-5167-4d00-a42e-b8e715efaef1",
                "type": "EndscreenElement",
                "style": "CHANNEL",
                "title": "Rick Astley",
                "thumbnail": "https://yt3.ggpht.com/vewxKdtll-rntHAMDPY_Qa6hPac3-J2sCFFUwvGSSR0i7hB4g5rNfF39lCEcjGvsYI0RWx7V1A=s400-c-k-c0x00ffffff-no-rj",
                "endpoint": {
                    "type": "NavigationEndpoint",
                    "payload": {
                        "browseId": "UCuAXFkgsw1L7xaCfnd5JJOw"
                    }
                },
                "metadata": {
                    "text": "2026 UK & Ireland Reflection Tour\nTickets are on sale now.",
                    "rtl": false
                }
            }
        ]
    },
    "hasStreamingData": true,
    "license": null,
    "merchandise": null,
    "playerConfig": {
        "audioConfig": {
            "loudnessDb": 0.9899998,
            "perceptualLoudnessDb": -13.01,
            "enablePerFormatLoudness": true
        },
        "maxBitrate": "0"
    },
    "playerOverlays": {
        "endScreen": {
            "title": "You may also like...",
            "results": [
                {
                    "id": "yPYZpwSpKmA",
                    "title": "Rick Astley - Together Forever (Official Video) [4K Remaster]",
                    "thumbnail": "https://i.ytimg.com/vi/yPYZpwSpKmA/hqdefault.jpg",
                    "endpoint": {
                        "type": "NavigationEndpoint",
                        "name": "watchEndpoint",
                        "payload": {
                            "videoId": "yPYZpwSpKmA",
                            "playlistId": "RDyPYZpwSpKmA"
                        },
                        "metadata": {
                            "url": "/watch?v=yPYZpwSpKmA&list=RDyPYZpwSpKmA&start_radio=1",
                            "page_type": "WEB_PAGE_TYPE_WATCH",
                            "api_url": "/player"
                        }
                    }
                }
            ]
        },
        "autoplay": {
            "title": "Up next",
            "videoId": "VegzlNRGSvI",
            "videoTitle": "Rick Astley megamix",
            "shortViewCount": "4.8M views",
            "published": "8 years ago",
            "countDownSecsForFullscreen": 3,
            "preferImmediateRedirect": false,
            "author": {
                "id": "UCQWt05fNgL1uCvufSqXG3OQ",
                "name": "Gary Douglas",
                "thumbnail": null
            }
        },
        "shareButton": {
            "tooltip": "Share",
            "iconType": "SHARE",
            "isDisabled": false
        },
        "decoratedPlayerBar": {
            "markersMap": []
        }
    },
    "streamingDataExpires": [],
    "topComments": false
}
```

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)