Metadata-Version: 2.4
Name: 24ur-api
Version: 0.2.1
Summary: Unofficial 24ur API
Author-email: Amadej Kastelic <amadejkastelic7@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/amadejkastelic/24ur-api
Project-URL: Source, https://github.com/amadejkastelic/24ur-api
Project-URL: Tracker, https://github.com/amadejkastelic/24ur-api/issues
Keywords: 24ur,api,scraper
Requires-Python: ~=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp<4
Requires-Dist: beautifulsoup4<5
Provides-Extra: video
Requires-Dist: yt-dlp; extra == "video"
Provides-Extra: dev
Requires-Dist: black; extra == "dev"
Requires-Dist: flake; extra == "dev"
Requires-Dist: packaging; extra == "dev"
Provides-Extra: lint
Requires-Dist: flake8>=7.1.1; extra == "lint"
Requires-Dist: black>=24.1.0; extra == "lint"
Dynamic: license-file

# Unofficial 24ur API Client

[![License: MIT](https://img.shields.io/badge/license-MIT-C06524)](https://github.com/amadejkastelic/24ur-api/blob/main/LICENSE)
[![PyPI - Version](https://img.shields.io/pypi/v/24ur-api.svg)](https://pypi.org/project/24ur-api/)
[![Downloads](https://static.pepy.tech/badge/24ur-api)](https://pepy.tech/project/24ur-api)

## Installation

```bash
pip install 24ur-api
```
- With video download support
```bash
pip install 24ur-api[video]
```

## Usage

```python
from api_24ur import client

cl = client.Client()

# Get article by URL with 10 comments
article = await cl.get_article_by_url(url='<article_url>', num_comments=10)

# Download the first video of article with bitrate lower than 2000000b to current dir
await cl.download_video(stream_url=article.videos[0].url, download_path='.', max_bitrate=2000000)
# Or get bytes
await cl.download_video_bytes(stream_url=article.videos[0].url, max_bitrate=2000000)
```
