yandex-market-api 0.1.0a1

Async Python SDK for Yandex Market Partner API

yandex-market-api

Async Python client for the Yandex Market Partner API (unofficial).

This library provides an asynchronous, resource-oriented interface for interacting with the Yandex Market Partner API. It is designed as a thin, explicit SDK that mirrors the API structure while following Python and async best practices.

⚠️ Important: this project is in alpha stage and is under active development. The public API may change, and not all endpoints are implemented yet.

---

Features

• Fully asynchronous HTTP client based on httpx
• Resource-oriented design (client.offers, client.campaigns, etc.)
• Explicit and predictable method naming
• Python 3.10+ support
• Designed to be extended with typed models (Pydantic) over time

---

Installation

The library can be installed from PyPI:

pip install yandex-market-api

Python 3.10 or newer is required.

---

Quick start

from yandex_market_api import YandexMarketClient
import asyncio

async def main() -> None:
    client = YandexMarketClient(token="YOUR_API_TOKEN")

    campaigns = await client.campaigns.list_campaigns()
    print(campaigns)

    await client.close()

asyncio.run(main())

The client is asynchronous, so it should be used inside an async context (e.g. with asyncio.run).

---

Project status

Alpha (work in progress)

• Some endpoints are not implemented yet
• Request and response schemas are mostly returned as plain dictionaries
• Error handling and retries are still evolving
• Backward compatibility is not guaranteed between alpha releases

The project is suitable for experimentation and internal tooling, but it is not yet recommended for production use.

---