Metadata-Version: 2.4
Name: wbapi-async
Version: 0.10.0
Summary: Fast, lightweight async client for the Wildberries Seller API
Project-URL: Documentation, https://serdukow.github.io/wbapi-async/
Project-URL: Repository, https://github.com/serdukow/wbapi-async
Project-URL: Changelog, https://github.com/serdukow/wbapi-async/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/serdukow/wbapi-async/issues
Author-email: Andrei Serdiukov <asyncdf@gmail.com>
Maintainer-email: Andrei Serdiukov <asyncdf@gmail.com>
License: MIT
License-File: LICENSE
Keywords: api,async,client,wb,wildberries
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: AsyncIO
Classifier: Framework :: Pydantic :: 2
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
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: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: <3.14,>=3.11
Requires-Dist: aiolimiter<2.0.0,>=1.2.1
Requires-Dist: httpx<0.29.0,>=0.28.1
Provides-Extra: dev
Requires-Dist: pre-commit<5.0.0,>=4.3.0; extra == 'dev'
Requires-Dist: ruff<0.15.0,>=0.14.1; extra == 'dev'
Provides-Extra: docs
Requires-Dist: mkdocs-material>=9.6.0; extra == 'docs'
Requires-Dist: mkdocstrings[python]>=0.29.0; extra == 'docs'
Provides-Extra: lint
Requires-Dist: pre-commit<5.0.0,>=4.3.0; extra == 'lint'
Requires-Dist: ruff<0.15.0,>=0.14.1; extra == 'lint'
Provides-Extra: test
Requires-Dist: pytest-asyncio<2.0.0,>=1.2.0; extra == 'test'
Requires-Dist: pytest-httpx<0.37.0,>=0.35.0; extra == 'test'
Requires-Dist: pytest<9.0.0,>=8.4.2; extra == 'test'
Requires-Dist: python-dotenv<2.0.0,>=1.2.1; extra == 'test'
Description-Content-Type: text/markdown

<p align="center">
  <a href="https://dev.wildberries.ru"><img src="https://i.postimg.cc/q7qHdnRF/svgviewer-output-2-1-3.png" alt="wbapi"></a>
</p>

<p align="center">
<a href="https://img.shields.io/pypi/v/wbapi-async.svg">
<img src="https://img.shields.io/pypi/v/wbapi-async.svg" alt="Version">
</a>
<a href="https://pypi.python.org/pypi/wbapi-async">
<img src="https://img.shields.io/pypi/dm/wbapi-async.svg" alt="Downloads">
</a>
<a href="https://pypi.python.org/pypi/wbapi-async">
<img src="https://img.shields.io/badge/status-stable-52C72D.svg?logo=git&logoColor=52C72D" alt="Status">
</a>
<a href="https://pypi.org/project/wbapi-async">
<img src="https://img.shields.io/pypi/pyversions/wbapi-async.svg" alt="Python">
</a>
</p>

---

**Documentation**: [https://dev.wildberries.ru](https://dev.wildberries.ru)

**Source Code**: [https://github.com/serdukow/wbapi-async](https://github.com/serdukow/wbapi-async)

---

**wbapi** is a lightweight async client for the Wildberries Seller API, built on top of [httpx](https://www.python-httpx.org/).

It handles pagination, rate limiting — so you can focus on your business logic instead of HTTP boilerplate.

## Installation

```bash
pip install wbapi-async
```

## How to use

1. Register in the Wildberries seller [personal account](https://seller.wildberries.ru/) if you haven't already.
2. Go to store settings and [create an API token](https://dev.wildberries.ru/en/docs/openapi/api-information#tag/Authorization/How-to-create-a-personal-access-base-or-test-token).

## Quick start

```python
import asyncio
from wbapi import WbAPI

async def main():
    async with WbAPI(token="your_api_token") as api:
        my_cards = await api.post(
            "/content/v2/get/cards/list",
            body={
                "settings": {
                    "sort": {"ascending": True},
                    "cursor": {"limit": 100},
                    "filter": {"withPhoto": -1},
                }
            },
            paginate=True,
        )
        print(my_cards[0].nmID)

asyncio.run(main())
```

## License

This project is licensed under the terms of the [MIT license](https://github.com/serdukow/wbapi-async/blob/main/LICENSE).
