# 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]
```

## Building

### Nix

```bash
nix build .#default
```

## Development

```bash
nix develop
```

## 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)
```
