ytscrape 0.1.0__tar.gz

ytscrape-0.1.0/.gitignore

@@ -0,0 +1,32 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+.eggs/
+wheels/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# uv
+.uv/
+
+# Caches / tooling
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.cache/
+
+# IDE
+.idea/
+*.iml
+
+# OS
+.DS_Store

ytscrape-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hural
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ytscrape-0.1.0/PKG-INFO

@@ -0,0 +1,235 @@
+Metadata-Version: 2.4
+Name: ytscrape
+Version: 0.1.0
+Summary: YouTube scraper for Python — search videos, channels and playlists and fetch video metadata via the InnerTube API, no API key required.
+Project-URL: Homepage, https://github.com/hural/ytscraper
+Project-URL: Repository, https://github.com/hural/ytscraper
+Project-URL: Issues, https://github.com/hural/ytscraper/issues
+Author: hural
+License: MIT License
+        
+        Copyright (c) 2026 hural
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: crawler,free,innertube,no-api-key,scraper,scraping,search,video,youtube,youtube-api,youtube-data,youtube-scraper
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: build>=1.5.0
+Requires-Dist: pycountry>=22.3.5
+Requires-Dist: requests>=2.28
+Requires-Dist: twine>=7.0.0
+Description-Content-Type: text/markdown
+
+# ytscraper — Free YouTube Scraper for Python
+
+[![PyPI version](https://img.shields.io/pypi/v/ytscraper.svg)](https://pypi.org/project/ytscraper/)
+[![Python versions](https://img.shields.io/pypi/pyversions/ytscraper.svg)](https://pypi.org/project/ytscraper/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+> **Free, open-source YouTube scraper library for Python.** Scrape YouTube
+> search results — videos, channels, playlists and Shorts — plus detailed video
+> metadata, **without an official YouTube Data API key** and **without any quota
+> limits**.
+
+`ytscraper` is a **free YouTube scraper and crawler** for Python built on top of
+the internal YouTube *InnerTube* API. Use it to **search YouTube**, **extract
+video, channel and playlist data**, and **fetch video metadata** — all with
+**transparent pagination** and no API key required.
+
+Whether you need to **scrape YouTube videos**, **collect channel data**, **mine
+YouTube search results**, or build a **YouTube data extractor** or **dataset**,
+`ytscraper` gives you a simple, Pythonic interface and a clean, extensible
+architecture that is easy to grow with new endpoints and data sources.
+
+**Keywords:** free youtube scraper, youtube scraper python, youtube data
+extractor, youtube api without key, scrape youtube videos, youtube channel
+scraper, youtube search scraper, youtube crawler, youtube metadata, python
+youtube scraping library, open source youtube scraper.
+
+> ⚠️ This library talks to YouTube's private endpoints. Use it responsibly and
+> at your own risk; the endpoints and `params` values may change over time.
+
+## Why ytscraper?
+
+- ✅ **Free & open source** (MIT) — no paid plans, no sign-up, no rate-limit
+  tiers.
+- 🔑 **No YouTube Data API key required** and **no quota** to worry about.
+- 🐍 **Pure Python** with full type hints and a tiny, dependency-light install.
+- ⚡ Simple, Pythonic API — start scraping YouTube in just a few lines.
+
+## Features
+
+- 🔎 Search videos, channels and playlists with a clean `SearchFilter` enum
+  (no magic `EgIQAQ==` strings in your code).
+- 📄 **Transparent pagination** — just iterate; continuation tokens are handled
+  for you.
+- 🎬 Fetch detailed video metadata from an id or any YouTube URL.
+- 🌍 **Language & country support** — localise results with the `Language`
+  and `Country` value objects (thin wrappers around raw ISO codes, no
+  hard-coded lists) bundled in a small `Locale` object; codes are validated
+  with `pycountry`, so typos fail fast.
+- 🧱 Extensible OOP design (facade + factory methods + strategy) and full type
+  hints — easy to build on.
+- 🖥️ A tiny CLI: `python -m ytscraper ...`.
+
+## Installation
+
+```bash
+pip install ytscraper
+```
+
+From source:
+
+```bash
+pip install .
+```
+
+## Quick start
+
+```python
+from ytscraper import YouTube, SearchFilter
+
+with YouTube() as yt:
+    # Search videos and iterate over as many pages as needed.
+    for video in yt.search("python", filter=SearchFilter.VIDEOS, max_results=20):
+        print(video.title, "-", video.url)
+
+    # Search channels.
+    for channel in yt.search("python", filter=SearchFilter.CHANNELS, max_results=5):
+        print(channel.title, channel.url)
+
+    # Fetch details for a single video (id or URL both work).
+    details = yt.video("https://www.youtube.com/watch?v=dQw4w9WgXcQ")
+    print(details.title, details.channel, details.views)
+```
+
+### Search filters
+
+| Filter                     | Description         |
+| -------------------------- | ------------------- |
+| `SearchFilter.ALL`         | Everything (default)|
+| `SearchFilter.VIDEOS`      | Videos only         |
+| `SearchFilter.CHANNELS`    | Channels only       |
+| `SearchFilter.PLAYLISTS`   | Playlists only      |
+| `SearchFilter.SHORTS`      | Shorts only         |
+| `SearchFilter.MOVIES`      | Movies only         |
+
+You can also pass the string form: `yt.search("python", filter="videos")`.
+
+### Language & country
+
+YouTube localises results by *interface language* (`hl`) and *content region*
+(`gl`). Configure both when creating `YouTube`, passing plain ISO codes (or the
+`Language` / `Country` value objects, which wrap the same codes):
+
+```python
+from ytscraper import YouTube, Language, Country, Locale
+
+# Just pass raw ISO codes — they are validated and normalised for you.
+with YouTube(language="uk", region="UA") as yt:
+    for video in yt.search("музика", max_results=10):
+        print(video.title, video.url)
+
+# The Language / Country value objects are equivalent (and reusable).
+yt = YouTube(language=Language("de"), region=Country("DE"))
+
+# Invalid codes are rejected early (validated with pycountry).
+YouTube(region="XX")  # ValueError: Unknown country code 'XX'. ...
+
+# Or pass a ready-made Locale.
+yt = YouTube(locale=Locale(language="fr", country="FR"))
+print(yt.locale.language.code, yt.locale.country.code)  # fr FR
+```
+
+`Language` and `Country` are thin, self-validating value objects around a raw
+ISO 639-1 / ISO 3166-1 alpha-2 code — there is no hard-coded list of languages
+or countries, so any valid code works. Codes are validated with
+[`pycountry`](https://pypi.org/project/pycountry/): an unknown language or
+country code raises a `ValueError` instead of silently producing a broken
+request. The chosen locale is sent both in the request context (`hl` / `gl`)
+and as the `Accept-Language` HTTP header.
+
+### Pagination
+
+Pagination is transparent — iterating over the result object automatically
+loads the next page:
+
+```python
+results = yt.search("python")
+
+for item in results:      # loads pages on demand
+    print(item.title)
+```
+
+You can also page manually:
+
+```python
+results = yt.search("python")
+print(len(results.fetch_next_page()))  # explicitly load one more page
+print(results.has_more)                # is there another page?
+```
+
+Use `max_results` to cap how many items you consume.
+
+## Use cases
+
+`ytscraper` is a great fit when you want to:
+
+- **Scrape YouTube search results** for a keyword or topic.
+- **Extract YouTube video data** (title, channel, views, duration, thumbnails).
+- **Collect YouTube channel and playlist listings** at scale.
+- **Build a YouTube dataset** for research, analytics or machine learning.
+- **Monitor YouTube** content for a niche without hitting API quotas.
+
+## Command line
+
+```bash
+# Search
+python -m ytscraper search "python tutorial" --filter videos --max 10
+
+# Localised search (Ukrainian interface, Ukrainian region)
+python -m ytscraper --language uk --region UA search "музика" --max 10
+
+# Video details
+python -m ytscraper video https://www.youtube.com/watch?v=dQw4w9WgXcQ
+```
+
+After installing, a `ytscraper` console script is also available:
+
+```bash
+ytscraper search "python" --filter channels --max 5
+```
+
+## License
+
+[MIT](LICENSE)

ytscrape-0.1.0/README.md

@@ -0,0 +1,183 @@
+# ytscraper — Free YouTube Scraper for Python
+
+[![PyPI version](https://img.shields.io/pypi/v/ytscraper.svg)](https://pypi.org/project/ytscraper/)
+[![Python versions](https://img.shields.io/pypi/pyversions/ytscraper.svg)](https://pypi.org/project/ytscraper/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+> **Free, open-source YouTube scraper library for Python.** Scrape YouTube
+> search results — videos, channels, playlists and Shorts — plus detailed video
+> metadata, **without an official YouTube Data API key** and **without any quota
+> limits**.
+
+`ytscraper` is a **free YouTube scraper and crawler** for Python built on top of
+the internal YouTube *InnerTube* API. Use it to **search YouTube**, **extract
+video, channel and playlist data**, and **fetch video metadata** — all with
+**transparent pagination** and no API key required.
+
+Whether you need to **scrape YouTube videos**, **collect channel data**, **mine
+YouTube search results**, or build a **YouTube data extractor** or **dataset**,
+`ytscraper` gives you a simple, Pythonic interface and a clean, extensible
+architecture that is easy to grow with new endpoints and data sources.
+
+**Keywords:** free youtube scraper, youtube scraper python, youtube data
+extractor, youtube api without key, scrape youtube videos, youtube channel
+scraper, youtube search scraper, youtube crawler, youtube metadata, python
+youtube scraping library, open source youtube scraper.
+
+> ⚠️ This library talks to YouTube's private endpoints. Use it responsibly and
+> at your own risk; the endpoints and `params` values may change over time.
+
+## Why ytscraper?
+
+- ✅ **Free & open source** (MIT) — no paid plans, no sign-up, no rate-limit
+  tiers.
+- 🔑 **No YouTube Data API key required** and **no quota** to worry about.
+- 🐍 **Pure Python** with full type hints and a tiny, dependency-light install.
+- ⚡ Simple, Pythonic API — start scraping YouTube in just a few lines.
+
+## Features
+
+- 🔎 Search videos, channels and playlists with a clean `SearchFilter` enum
+  (no magic `EgIQAQ==` strings in your code).
+- 📄 **Transparent pagination** — just iterate; continuation tokens are handled
+  for you.
+- 🎬 Fetch detailed video metadata from an id or any YouTube URL.
+- 🌍 **Language & country support** — localise results with the `Language`
+  and `Country` value objects (thin wrappers around raw ISO codes, no
+  hard-coded lists) bundled in a small `Locale` object; codes are validated
+  with `pycountry`, so typos fail fast.
+- 🧱 Extensible OOP design (facade + factory methods + strategy) and full type
+  hints — easy to build on.
+- 🖥️ A tiny CLI: `python -m ytscraper ...`.
+
+## Installation
+
+```bash
+pip install ytscraper
+```
+
+From source:
+
+```bash
+pip install .
+```
+
+## Quick start
+
+```python
+from ytscraper import YouTube, SearchFilter
+
+with YouTube() as yt:
+    # Search videos and iterate over as many pages as needed.
+    for video in yt.search("python", filter=SearchFilter.VIDEOS, max_results=20):
+        print(video.title, "-", video.url)
+
+    # Search channels.
+    for channel in yt.search("python", filter=SearchFilter.CHANNELS, max_results=5):
+        print(channel.title, channel.url)
+
+    # Fetch details for a single video (id or URL both work).
+    details = yt.video("https://www.youtube.com/watch?v=dQw4w9WgXcQ")
+    print(details.title, details.channel, details.views)
+```
+
+### Search filters
+
+| Filter                     | Description         |
+| -------------------------- | ------------------- |
+| `SearchFilter.ALL`         | Everything (default)|
+| `SearchFilter.VIDEOS`      | Videos only         |
+| `SearchFilter.CHANNELS`    | Channels only       |
+| `SearchFilter.PLAYLISTS`   | Playlists only      |
+| `SearchFilter.SHORTS`      | Shorts only         |
+| `SearchFilter.MOVIES`      | Movies only         |
+
+You can also pass the string form: `yt.search("python", filter="videos")`.
+
+### Language & country
+
+YouTube localises results by *interface language* (`hl`) and *content region*
+(`gl`). Configure both when creating `YouTube`, passing plain ISO codes (or the
+`Language` / `Country` value objects, which wrap the same codes):
+
+```python
+from ytscraper import YouTube, Language, Country, Locale
+
+# Just pass raw ISO codes — they are validated and normalised for you.
+with YouTube(language="uk", region="UA") as yt:
+    for video in yt.search("музика", max_results=10):
+        print(video.title, video.url)
+
+# The Language / Country value objects are equivalent (and reusable).
+yt = YouTube(language=Language("de"), region=Country("DE"))
+
+# Invalid codes are rejected early (validated with pycountry).
+YouTube(region="XX")  # ValueError: Unknown country code 'XX'. ...
+
+# Or pass a ready-made Locale.
+yt = YouTube(locale=Locale(language="fr", country="FR"))
+print(yt.locale.language.code, yt.locale.country.code)  # fr FR
+```
+
+`Language` and `Country` are thin, self-validating value objects around a raw
+ISO 639-1 / ISO 3166-1 alpha-2 code — there is no hard-coded list of languages
+or countries, so any valid code works. Codes are validated with
+[`pycountry`](https://pypi.org/project/pycountry/): an unknown language or
+country code raises a `ValueError` instead of silently producing a broken
+request. The chosen locale is sent both in the request context (`hl` / `gl`)
+and as the `Accept-Language` HTTP header.
+
+### Pagination
+
+Pagination is transparent — iterating over the result object automatically
+loads the next page:
+
+```python
+results = yt.search("python")
+
+for item in results:      # loads pages on demand
+    print(item.title)
+```
+
+You can also page manually:
+
+```python
+results = yt.search("python")
+print(len(results.fetch_next_page()))  # explicitly load one more page
+print(results.has_more)                # is there another page?
+```
+
+Use `max_results` to cap how many items you consume.
+
+## Use cases
+
+`ytscraper` is a great fit when you want to:
+
+- **Scrape YouTube search results** for a keyword or topic.
+- **Extract YouTube video data** (title, channel, views, duration, thumbnails).
+- **Collect YouTube channel and playlist listings** at scale.
+- **Build a YouTube dataset** for research, analytics or machine learning.
+- **Monitor YouTube** content for a niche without hitting API quotas.
+
+## Command line
+
+```bash
+# Search
+python -m ytscraper search "python tutorial" --filter videos --max 10
+
+# Localised search (Ukrainian interface, Ukrainian region)
+python -m ytscraper --language uk --region UA search "музика" --max 10
+
+# Video details
+python -m ytscraper video https://www.youtube.com/watch?v=dQw4w9WgXcQ
+```
+
+After installing, a `ytscraper` console script is also available:
+
+```bash
+ytscraper search "python" --filter channels --max 5
+```
+
+## License
+
+[MIT](LICENSE)

ytscrape-0.1.0/pyproject.toml

@@ -0,0 +1,66 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ytscrape"
+version = "0.1.0"
+description = "YouTube scraper for Python — search videos, channels and playlists and fetch video metadata via the InnerTube API, no API key required."
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.10"
+keywords = [
+    "youtube",
+    "youtube-scraper",
+    "scraper",
+    "crawler",
+    "innertube",
+    "youtube-api",
+    "youtube-data",
+    "video",
+    "scraping",
+    "search",
+    "free",
+    "no-api-key",
+]
+authors = [{ name = "hural" }]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "requests>=2.28",
+    "pycountry>=22.3.5",
+    "build>=1.5.0",
+    "twine>=7.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/hural/ytscraper"
+Repository = "https://github.com/hural/ytscraper"
+Issues = "https://github.com/hural/ytscraper/issues"
+
+[project.scripts]
+ytscraper = "ytscraper.__main__:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ytscraper"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/ytscraper",
+    "README.md",
+    "LICENSE",
+]

ytscrape-0.1.0/src/ytscraper/__init__.py

@@ -0,0 +1,54 @@
+"""ytscraper -- a small, object-oriented YouTube scraper.
+
+The package exposes a single high level facade, :class:`YouTube`, together with
+the data models and the :class:`SearchFilter` enum::
+
+    from ytscraper import YouTube, SearchFilter
+
+    with YouTube() as yt:
+        for video in yt.search("python", filter=SearchFilter.VIDEOS,
+                               max_results=20):
+            print(video.title, video.url)
+
+        details = yt.video("dQw4w9WgXcQ")
+        print(details.title, details.views)
+"""
+
+from __future__ import annotations
+
+from .client import InnerTubeClient
+from .context import ContextExtractor, InnerTubeContext
+from .exceptions import (
+    ContextExtractionError,
+    ParseError,
+    RequestError,
+    YtScraperError,
+)
+from .filters import SearchFilter
+from .locale import Country, Language, Locale
+from .models import Channel, Playlist, Video, VideoDetails
+from .results import SearchResults
+from .youtube import YouTube
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "YouTube",
+    "SearchFilter",
+    "Language",
+    "Country",
+    "Locale",
+    "SearchResults",
+    "Video",
+    "Channel",
+    "Playlist",
+    "VideoDetails",
+    "InnerTubeClient",
+    "InnerTubeContext",
+    "ContextExtractor",
+    "YtScraperError",
+    "ContextExtractionError",
+    "RequestError",
+    "ParseError",
+    "__version__",
+]

ytscrape-0.1.0/src/ytscraper/__main__.py

@@ -0,0 +1,92 @@
+"""Minimal command line interface: ``python -m ytscraper``.
+
+Examples:
+    python -m ytscraper search "python tutorial" --filter videos --max 10
+    python -m ytscraper video https://www.youtube.com/watch?v=dQw4w9WgXcQ
+"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+
+from . import YouTube, __version__
+from .exceptions import YtScraperError
+from .filters import SearchFilter
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="ytscraper",
+        description="Scrape YouTube search results and video metadata.",
+    )
+    parser.add_argument(
+        "--version", action="version", version=f"ytscraper {__version__}"
+    )
+    parser.add_argument(
+        "--language",
+        default="en",
+        metavar="HL",
+        help="Interface language (hl), e.g. en, uk, de.",
+    )
+    parser.add_argument(
+        "--region",
+        default="US",
+        metavar="GL",
+        help="Content region / country (gl), e.g. US, UA, DE.",
+    )
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    search = sub.add_parser("search", help="Search YouTube.")
+    search.add_argument("query", help="Search query.")
+    search.add_argument(
+        "--filter",
+        choices=[f.value for f in SearchFilter],
+        default=SearchFilter.ALL.value,
+        help="Type of results to return.",
+    )
+    search.add_argument(
+        "--max",
+        type=int,
+        default=10,
+        dest="max_results",
+        help="Maximum number of results to print.",
+    )
+
+    video = sub.add_parser("video", help="Fetch details for a single video.")
+    video.add_argument("video", help="Video id or URL.")
+
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    """Entry point for the console script and ``python -m ytscraper``."""
+    args = _build_parser().parse_args(argv)
+
+    try:
+        with YouTube(language=args.language, region=args.region) as yt:
+            if args.command == "search":
+                results = yt.search(
+                    args.query,
+                    filter=args.filter,
+                    max_results=args.max_results,
+                )
+                for item in results:
+                    title = getattr(item, "title", None)
+                    print(f"{title}\t{item.url}")
+            elif args.command == "video":
+                details = yt.video(args.video)
+                print(f"Title:   {details.title}")
+                print(f"Channel: {details.channel}")
+                print(f"Views:   {details.views}")
+                print(f"Length:  {details.length_seconds}s")
+                print(f"URL:     {details.url}")
+    except YtScraperError as exc:
+        print(f"error: {exc}", file=sys.stderr)
+        return 1
+
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())