wbapi-async 0.8.0

Fast, lightweight async client for the Wildberries Seller API

---

Documentation: https://dev.wildberries.ru

Source Code: https://github.com/serdukow/wbapi-async

---

wbapi is a lightweight async client for the Wildberries Seller API, built on top of httpx.

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

Requirements

Python 3.10+

wbapi stands on the shoulders of giants:

• httpx for async HTTP.
• aiolimiter for rate limiting.

Installation

pip install wbapi-async

How to use

1. Register in the Wildberries seller personal account if you haven't already.
2. Go to store settings and create an API token.

Quick start

import asyncio
from wbapi import WbAPI

async def main():
    async with WbAPI(token="your_api_token") as api:
        # Simple request
        warehouses = await api.get("/api/v3/warehouses")

        # Auto-paginated — fetches all pages automatically
        all_cards = await api.post(
            "/content/v2/get/cards/list",
            body={
                "settings": {
                    "sort": {"ascending": True},
                    "cursor": {"limit": 100},
                    "filter": {"withPhoto": -1},
                }
            },
            paginate=True,
        )
        print(all_cards)

asyncio.run(main())

Pass paginate=True to any get or post call and the library fetches all pages automatically. Pagination strategy (cursor, token, or offset) is detected from the first response.

Base URL resolution and per-endpoint rate limiting are handled transparently.

License

This project is licensed under the terms of the MIT license.