wbapi-async 0.3.0__tar.gz → 0.3.2__tar.gz

wbapi_async-0.3.2/.gitignore

@@ -0,0 +1,101 @@
+### macOS ###
+# General macOS system files
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# iCloud generated files
+*.icloud
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Virtual environments
+.venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+.python-version
+.env
+
+# Unit test / coverage reports
+.tox/
+.coverage
+.coverage.*
+.pytest_cache/
+.nox/
+cache/
+htmlcov/
+hypothesis/
+.cover
+*.py,cover
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# Mypy, Pytype, Pyre caches
+.mypy_cache/
+.pytype/
+.pyre/
+
+# PyInstaller
+*.spec
+*.manifest
+*.exe
+
+# Flask / Django
+instance/
+.webassets-cache
+db.sqlite3
+db.sqlite3-journal
+
+
+# Documentation
+docs/_build/
+site/
+
+### IDEs ###
+# JetBrains / PyCharm
+.idea
+.idea/
+*.iml
+*.xml
+.idea_modules/
+# VSCode
+.vscode/
+.claude/
+
+### macOS Patch ###
+._*
+
+# General files from Python tools (pip, distutils, eggs)
+build/
+dist/
+*.egg-info/
+.eggs/
+wheels/
+downloads/
+lib/
+lib64/
+parts/
+sdist/
+var/
+share/python-wheels/
+node_modules/
+
+
+### LSP config files ###
+pyrightconfig.json
+
+### Ruff ###
+.ruff_cache/
+
+internal/
+TODO.md

wbapi_async-0.3.2/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: wbapi-async
+Version: 0.3.2
+Summary: Asynchronous client for Wildberries 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.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
+Requires-Dist: pydantic<2.12.2,>=2.4.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://upload.wikimedia.org/wikipedia/commons/4/41/Wildberries_2023_Pink.svg" alt="WbAPI"></a>
+</p>
+
+<div align="center">
+
+## Asynchronous client for Wildberries API
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![PyPI version](https://img.shields.io/pypi/v/wild-api.svg)](https://pypi.org/project/wild-api/)
+[![Downloads](https://img.shields.io/pypi/dm/wild-api.svg)](https://pypi.python.org/pypi/wild-api)
+[![Docs](https://img.shields.io/badge/docs-serdukow.github.io-blue.svg)](https://serdukow.github.io/wbapi-async/)
+[![Status](https://img.shields.io/badge/status-beta-8B5CF6.svg?logo=git&logoColor=white)]()
+
+</div>
+
+> [!CAUTION]
+> The library is under active development and **is currently not recommended for use in production environments**
+
+## Features
+
+- **Fully async** — built on `httpx` and `asyncio`
+- **Type-safe** — Pydantic v2 models with `py.typed` marker
+- **Auto-pagination** — fetch all pages with a single `await paginate(...)`
+- **Rate limiting** — per-method limits with `aiolimiter`
+- **Auto-retry** — automatic retry on HTTP 429
+- **Always up to date** — methods are [auto-generated](https://github.com/serdukow/wbapi-codegen) from [wb api](https://dev.wildberries.ru) as soon as they change
+
+## Docs
+
+**[wbapi-async](https://serdukow.github.io/wbapi-async/)**
+
+**[WB API](https://dev.wildberries.ru)**

wbapi_async-0.3.2/pyproject.toml

@@ -0,0 +1,126 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "wbapi-async"
+version = "0.3.2"
+description = "Asynchronous client for Wildberries API"
+authors = [
+    { name = "Andrei Serdiukov", email = "asyncdf@gmail.com" },
+]
+maintainers = [
+    { name = "Andrei Serdiukov", email = "asyncdf@gmail.com" },
+]
+readme = "README.md"
+requires-python = ">=3.11,<3.14"
+license = {text = "MIT"}
+keywords = ["wb", "wildberries", "api", "client", "async"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Framework :: AsyncIO",
+    "Framework :: Pydantic :: 2",
+    "Typing :: Typed",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "aiolimiter (>=1.2.1,<2.0.0)",
+    "httpx (>=0.28.1,<0.29.0)",
+    "pydantic (>=2.4.1,<2.12.2)",
+]
+
+[project.optional-dependencies]
+dev = [
+    "ruff (>=0.14.1,<0.15.0)",
+    "pre-commit (>=4.3.0,<5.0.0)",
+]
+
+test = [
+    "pytest (>=8.4.2,<9.0.0)",
+    "pytest-asyncio (>=1.2.0,<2.0.0)",
+    "pytest-httpx (>=0.35.0,<0.37.0)",
+    "python-dotenv (>=1.2.1,<2.0.0)"
+]
+
+lint = [
+    "ruff (>=0.14.1,<0.15.0)",
+    "pre-commit (>=4.3.0,<5.0.0)",
+]
+
+docs = [
+    "mkdocs-material (>=9.6.0)",
+    "mkdocstrings[python] (>=0.29.0)",
+]
+
+[project.urls]
+Documentation = "https://serdukow.github.io/wbapi-async/"
+Repository = "https://github.com/serdukow/wbapi-async"
+Changelog = "https://github.com/serdukow/wbapi-async/blob/main/CHANGELOG.md"
+Issues = "https://github.com/serdukow/wbapi-async/issues"
+
+[tool.hatch.build.targets.sdist]
+only-include = [
+    "src/wbapi_async",
+    "README.md",
+    "pyproject.toml"
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/wbapi_async"]
+
+[tool.ruff]
+exclude = [
+    ".git",
+    "build",
+    "dist",
+    "venv",
+    ".venv",
+    "docs",
+    "tests",
+    "dev",
+    "scripts",
+    "*.egg-info",
+]
+line-length = 110
+target-version = "py313"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "C4", "B", "RUF100"]
+fixable = ["ALL"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["wbapi_async"]
+force-sort-within-sections = true
+order-by-type = true
+combine-as-imports = true
+section-order = ["future", "standard-library", "third-party", "first-party", "local-folder"]
+lines-between-types = 1
+lines-after-imports = 2
+
+[tool.ruff.lint.pep8-naming]
+classmethod-decorators = ["classmethod"]
+staticmethod-decorators = ["staticmethod"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+line-ending = "lf"
+skip-magic-trailing-comma = false
+docstring-code-format = true
+docstring-code-line-length = 60
+
+
+[tool.pytest.ini_options]
+addopts = "-vv -s --log-cli-level=DEBUG"
+asyncio_mode = "auto"
+markers = [
+    "unit: unit tests",
+    "integration: integration tests",
+    "slow: slow running tests"
+]

wbapi_async-0.3.2/src/wbapi_async/analytics/__init__.py

@@ -0,0 +1,72 @@
+from .types.comparison import Comparison
+from .types.conversions import Conversions
+from .types.create_the_report_response import CreateTheReportResponse
+from .types.float_graph_by_period_item import FloatGraphByPeriodItem
+from .types.group_data_item import GroupDataItem
+from .types.grouped_product_cards_statistics_per_days_item import GroupedProductCardsStatisticsPerDaysItem
+from .types.history import History
+from .types.main_page_response import MainPageResponse
+from .types.metrics import Metrics
+from .types.offices_item import OfficesItem
+from .types.order_by import OrderBy
+from .types.orders_and_positions_by_product_search_texts_response import (
+    OrdersAndPositionsByProductSearchTextsResponse,
+)
+from .types.pagination_by_groups_response import PaginationByGroupsResponse
+from .types.pagination_by_products_within_agroup_response import PaginationByProductsWithinAGroupResponse
+from .types.product import Product
+from .types.product_cards_statistics_per_days_response import ProductCardsStatisticsPerDaysResponse
+from .types.product_cards_statistics_per_period_item import ProductCardsStatisticsPerPeriodItem
+from .types.product_data_item import ProductDataItem
+from .types.regenerate_the_report_response import RegenerateTheReportResponse
+from .types.sale_rate import SaleRate
+from .types.search_texts_by_product_response import SearchTextsByProductResponse
+from .types.selected import Selected
+from .types.selected_period import SelectedPeriod
+from .types.size_data_item import SizeDataItem
+from .types.statistic import Statistic
+from .types.stocks import Stocks
+from .types.table_product_item_st import TableProductItemSt
+from .types.tag import Tag
+from .types.the_report_response import TheReportResponse
+from .types.the_reports_list_item import TheReportsListItem
+from .types.time_to_ready import TimeToReady
+from .types.warehouse_data_item import WarehouseDataItem
+from .types.wb_club import WbClub
+
+
+__all__ = (
+    "Comparison",
+    "Conversions",
+    "CreateTheReportResponse",
+    "FloatGraphByPeriodItem",
+    "GroupDataItem",
+    "GroupedProductCardsStatisticsPerDaysItem",
+    "History",
+    "MainPageResponse",
+    "Metrics",
+    "OfficesItem",
+    "OrderBy",
+    "OrdersAndPositionsByProductSearchTextsResponse",
+    "PaginationByGroupsResponse",
+    "PaginationByProductsWithinAGroupResponse",
+    "Product",
+    "ProductCardsStatisticsPerDaysResponse",
+    "ProductCardsStatisticsPerPeriodItem",
+    "ProductDataItem",
+    "RegenerateTheReportResponse",
+    "SaleRate",
+    "SearchTextsByProductResponse",
+    "Selected",
+    "SelectedPeriod",
+    "SizeDataItem",
+    "Statistic",
+    "Stocks",
+    "TableProductItemSt",
+    "Tag",
+    "TheReportResponse",
+    "TheReportsListItem",
+    "TimeToReady",
+    "WarehouseDataItem",
+    "WbClub",
+)

wbapi_async-0.3.2/src/wbapi_async/analytics/methods/__init__.py

@@ -0,0 +1,36 @@
+from .get_create_the_report import GetCreateTheReport
+from .get_group_data import GetGroupData
+from .get_grouped_product_cards_statistics_per_days import GetGroupedProductCardsStatisticsPerDays
+from .get_main_page import GetMainPage
+from .get_orders_and_positions_by_product_search_texts import GetOrdersAndPositionsByProductSearchTexts
+from .get_pagination_by_groups import GetPaginationByGroups
+from .get_pagination_by_products_within_agroup import GetPaginationByProductsWithinAGroup
+from .get_product_cards_statistics_per_days import GetProductCardsStatisticsPerDays
+from .get_product_cards_statistics_per_period import GetProductCardsStatisticsPerPeriod
+from .get_product_data import GetProductData
+from .get_regenerate_the_report import GetRegenerateTheReport
+from .get_search_texts_by_product import GetSearchTextsByProduct
+from .get_size_data import GetSizeData
+from .get_the_report import GetTheReport
+from .get_the_reports_list import GetTheReportsList
+from .get_warehouse_data import GetWarehouseData
+
+
+__all__ = (
+    "GetCreateTheReport",
+    "GetGroupData",
+    "GetGroupedProductCardsStatisticsPerDays",
+    "GetMainPage",
+    "GetOrdersAndPositionsByProductSearchTexts",
+    "GetPaginationByGroups",
+    "GetPaginationByProductsWithinAGroup",
+    "GetProductCardsStatisticsPerDays",
+    "GetProductCardsStatisticsPerPeriod",
+    "GetProductData",
+    "GetRegenerateTheReport",
+    "GetSearchTextsByProduct",
+    "GetSizeData",
+    "GetTheReport",
+    "GetTheReportsList",
+    "GetWarehouseData",
+)

wbapi_async-0.3.2/src/wbapi_async/analytics/methods/get_group_data.py

@@ -0,0 +1,34 @@
+from pydantic import Field
+
+from ...methods.base import WbMethod
+from ...types import GroupDataItem, OrderBy, RequestLimit, SelectedPeriod
+
+
+class GetGroupData(WbMethod):
+    """
+    Forms a dataset for inventory by product group. The product group is described by a tuple of
+    `subjectID,brandName, tagID`.
+
+    Source: https://dev.wildberries.ru/en/docs/openapi/analytics#tag/Stocks-Report/paths/~1api~1v2~1stocks-report~1products~1groups/post
+    """
+
+    __return__ = GroupDataItem
+    __api__ = "seller-analytics-api"
+    __method__ = "api/v2/stocks-report/products/groups"
+    __http_method__ = "POST"
+    __data_key__ = "data.groups"
+    __pagination__ = "offset"
+
+    request_limit: RequestLimit = RequestLimit(period=60, limit=10, interval=600, burst=5)
+
+    nm_ids: list[int] | None = Field(None, alias="nmIDs")
+    subject_ids: list[int] | None = Field(None, alias="subjectIDs")
+    brand_names: list[str] | None = Field(None, alias="brandNames")
+    tag_ids: list[int] | None = Field(None, alias="tagIDs")
+    current_period: SelectedPeriod = Field(alias="currentPeriod")
+    stock_type: str = Field(alias="stockType")
+    skip_deleted_nm: bool = Field(alias="skipDeletedNm")
+    availability_filters: list[str] = Field(alias="availabilityFilters")
+    order_by: OrderBy = Field(alias="orderBy")
+    limit: int | None = Field(100, alias="limit")
+    offset: int = Field(alias="offset")

wbapi_async-0.3.2/src/wbapi_async/analytics/methods/get_grouped_product_cards_statistics_per_days.py

@@ -0,0 +1,28 @@
+from pydantic import Field
+
+from ...methods.base import WbMethod
+from ...types import GroupedProductCardsStatisticsPerDaysItem, RequestLimit, SelectedPeriod
+
+
+class GetGroupedProductCardsStatisticsPerDays(WbMethod):
+    """
+    The method returns statistics for product cards by day or by week. Product cards are grouped by
+    subjects,brands and tags. You can get data for a maximum of the last week.
+
+    Source: https://dev.wildberries.ru/en/docs/openapi/analytics#tag/Sales-Funnel/paths/~1api~1analytics~1v3~1sales-funnel~1grouped~1history/post
+    """
+
+    __return__ = GroupedProductCardsStatisticsPerDaysItem
+    __api__ = "seller-analytics-api"
+    __method__ = "api/analytics/v3/sales-funnel/grouped/history"
+    __http_method__ = "POST"
+    __data_key__ = "data"
+
+    request_limit: RequestLimit = RequestLimit(period=60, limit=10, interval=600, burst=5)
+
+    selected_period: SelectedPeriod = Field(alias="selectedPeriod")
+    brand_names: list[str] | None = Field(None, alias="brandNames")
+    subject_ids: list[int] | None = Field(None, alias="subjectIds")
+    tag_ids: list[int] | None = Field(None, alias="tagIds")
+    skip_deleted_nm: bool | None = Field(None, alias="skipDeletedNm")
+    aggregation_level: str | None = Field("day", alias="aggregationLevel")

wbapi_async-0.3.2/src/wbapi_async/analytics/methods/get_main_page.py

@@ -0,0 +1,34 @@
+from pydantic import Field
+
+from ...methods.base import WbMethod
+from ...types import MainPageResponse, OrderBy, RequestLimit, SelectedPeriod
+
+
+class GetMainPage(WbMethod):
+    """
+    Forms a dataset for the main report page with: - General information - Product positions - Data
+    onvisibility and transitions to the product card - Data for the table by groups
+
+    Source: https://dev.wildberries.ru/en/docs/openapi/analytics#tag/Search-Queries-for-Your-Items/paths/~1api~1v2~1search-report~1report/post
+    """
+
+    __return__ = MainPageResponse
+    __api__ = "seller-analytics-api"
+    __method__ = "api/v2/search-report/report"
+    __http_method__ = "POST"
+    __pagination__ = "offset"
+
+    request_limit: RequestLimit = RequestLimit(period=60, limit=10, interval=600, burst=5)
+
+    current_period: SelectedPeriod = Field(alias="currentPeriod")
+    past_period: SelectedPeriod | None = Field(None, alias="pastPeriod")
+    nm_ids: list[int] | None = Field(None, alias="nmIds")
+    subject_ids: list[int] | None = Field(None, alias="subjectIds")
+    brand_names: list[str] | None = Field(None, alias="brandNames")
+    tag_ids: list[int] | None = Field(None, alias="tagIds")
+    position_cluster: str = Field(alias="positionCluster")
+    order_by: OrderBy = Field(alias="orderBy")
+    include_substituted_skus: bool | None = Field(True, alias="includeSubstitutedSKUs")
+    include_search_texts: bool | None = Field(True, alias="includeSearchTexts")
+    limit: int = Field(alias="limit")
+    offset: int = Field(alias="offset")

wbapi_async-0.3.2/src/wbapi_async/analytics/methods/get_orders_and_positions_by_product_search_texts.py

@@ -0,0 +1,24 @@
+from pydantic import Field
+
+from ...methods.base import WbMethod
+from ...types import OrdersAndPositionsByProductSearchTextsResponse, RequestLimit, SelectedPeriod
+
+
+class GetOrdersAndPositionsByProductSearchTexts(WbMethod):
+    """
+    Forms data for a table on the number of orders and positions by queries. The data is specified
+    withina period for a specific product.
+
+    Source: https://dev.wildberries.ru/en/docs/openapi/analytics#tag/Search-Queries-for-Your-Items/paths/~1api~1v2~1search-report~1product~1orders/post
+    """
+
+    __return__ = OrdersAndPositionsByProductSearchTextsResponse
+    __api__ = "seller-analytics-api"
+    __method__ = "api/v2/search-report/product/orders"
+    __http_method__ = "POST"
+
+    request_limit: RequestLimit = RequestLimit(period=60, limit=10, interval=600, burst=5)
+
+    period: SelectedPeriod = Field(alias="period")
+    nm_id: int = Field(alias="nmId")
+    search_texts: list[str] = Field(alias="searchTexts")

wbapi_async-0.3.2/src/wbapi_async/analytics/methods/get_pagination_by_groups.py

@@ -0,0 +1,34 @@
+from pydantic import Field
+
+from ...methods.base import WbMethod
+from ...types import OrderBy, PaginationByGroupsResponse, RequestLimit, SelectedPeriod
+
+
+class GetPaginationByGroups(WbMethod):
+    """
+    Pagination by groups in the report. It is possible only if there is a filter by brand, subject,
+    ortag.
+
+    Source: https://dev.wildberries.ru/en/docs/openapi/analytics#tag/Search-Queries-for-Your-Items/paths/~1api~1v2~1search-report~1table~1groups/post
+    """
+
+    __return__ = PaginationByGroupsResponse
+    __api__ = "seller-analytics-api"
+    __method__ = "api/v2/search-report/table/groups"
+    __http_method__ = "POST"
+    __pagination__ = "offset"
+
+    request_limit: RequestLimit = RequestLimit(period=60, limit=10, interval=600, burst=5)
+
+    current_period: SelectedPeriod = Field(alias="currentPeriod")
+    past_period: SelectedPeriod | None = Field(None, alias="pastPeriod")
+    nm_ids: list[int] | None = Field(None, alias="nmIds")
+    subject_ids: list[int] | None = Field(None, alias="subjectIds")
+    brand_names: list[str] | None = Field(None, alias="brandNames")
+    tag_ids: list[int] | None = Field(None, alias="tagIds")
+    order_by: OrderBy = Field(alias="orderBy")
+    position_cluster: str = Field(alias="positionCluster")
+    include_substituted_skus: bool | None = Field(True, alias="includeSubstitutedSKUs")
+    include_search_texts: bool | None = Field(True, alias="includeSearchTexts")
+    limit: int = Field(alias="limit")
+    offset: int = Field(alias="offset")

wbapi_async-0.3.2/src/wbapi_async/analytics/methods/get_pagination_by_products_within_agroup.py

@@ -0,0 +1,33 @@
+from pydantic import Field
+
+from ...methods.base import WbMethod
+from ...types import OrderBy, PaginationByProductsWithinAGroupResponse, RequestLimit, SelectedPeriod
+
+
+class GetPaginationByProductsWithinAGroup(WbMethod):
+    """
+    Pagination by products within a group. It is possible regardless of the presence of filters.
+
+    Source: https://dev.wildberries.ru/en/docs/openapi/analytics#tag/Search-Queries-for-Your-Items/paths/~1api~1v2~1search-report~1table~1details/post
+    """
+
+    __return__ = PaginationByProductsWithinAGroupResponse
+    __api__ = "seller-analytics-api"
+    __method__ = "api/v2/search-report/table/details"
+    __http_method__ = "POST"
+    __pagination__ = "offset"
+
+    request_limit: RequestLimit = RequestLimit(period=60, limit=10, interval=600, burst=5)
+
+    current_period: SelectedPeriod = Field(alias="currentPeriod")
+    past_period: SelectedPeriod | None = Field(None, alias="pastPeriod")
+    subject_id: int | None = Field(None, alias="subjectId")
+    brand_name: str | None = Field(None, alias="brandName")
+    tag_id: int | None = Field(None, alias="tagId")
+    nm_ids: list[int] | None = Field(None, alias="nmIds")
+    order_by: OrderBy = Field(alias="orderBy")
+    position_cluster: str = Field(alias="positionCluster")
+    include_substituted_skus: bool | None = Field(True, alias="includeSubstitutedSKUs")
+    include_search_texts: bool | None = Field(True, alias="includeSearchTexts")
+    limit: int = Field(alias="limit")
+    offset: int = Field(alias="offset")

wbapi_async-0.3.2/src/wbapi_async/analytics/methods/get_product_cards_statistics_per_days.py

@@ -0,0 +1,25 @@
+from pydantic import Field
+
+from ...methods.base import WbMethod
+from ...types import ProductCardsStatisticsPerDaysResponse, RequestLimit, SelectedPeriod
+
+
+class GetProductCardsStatisticsPerDays(WbMethod):
+    """
+    The method returns statistics for product cards by day or by week. You can get data for a
+    maximumof the last week.
+
+    Source: https://dev.wildberries.ru/en/docs/openapi/analytics#tag/Sales-Funnel/paths/~1api~1analytics~1v3~1sales-funnel~1products~1history/post
+    """
+
+    __return__ = ProductCardsStatisticsPerDaysResponse
+    __api__ = "seller-analytics-api"
+    __method__ = "api/analytics/v3/sales-funnel/products/history"
+    __http_method__ = "POST"
+
+    request_limit: RequestLimit = RequestLimit(period=60, limit=10, interval=600, burst=5)
+
+    selected_period: SelectedPeriod = Field(alias="selectedPeriod")
+    nm_ids: list[int] = Field(alias="nmIds")
+    skip_deleted_nm: bool | None = Field(None, alias="skipDeletedNm")
+    aggregation_level: str | None = Field("day", alias="aggregationLevel")

wbapi_async-0.3.2/src/wbapi_async/analytics/methods/get_product_cards_statistics_per_period.py

@@ -0,0 +1,33 @@
+from pydantic import Field
+
+from ...methods.base import WbMethod
+from ...types import OrderBy, ProductCardsStatisticsPerPeriodItem, RequestLimit, SelectedPeriod
+
+
+class GetProductCardsStatisticsPerPeriod(WbMethod):
+    """
+    The method generates a report on products by comparing key metrics for the current period with
+    asimilar past one.
+
+    Source: https://dev.wildberries.ru/en/docs/openapi/analytics#tag/Sales-Funnel/paths/~1api~1analytics~1v3~1sales-funnel~1products/post
+    """
+
+    __return__ = ProductCardsStatisticsPerPeriodItem
+    __api__ = "seller-analytics-api"
+    __method__ = "api/analytics/v3/sales-funnel/products"
+    __http_method__ = "POST"
+    __data_key__ = "data.products"
+    __pagination__ = "offset"
+
+    request_limit: RequestLimit = RequestLimit(period=60, limit=10, interval=600, burst=5)
+
+    selected_period: SelectedPeriod = Field(alias="selectedPeriod")
+    past_period: SelectedPeriod | None = Field(None, alias="pastPeriod")
+    nm_ids: list[int] | None = Field(None, alias="nmIds")
+    brand_names: list[str] | None = Field(None, alias="brandNames")
+    subject_ids: list[int] | None = Field(None, alias="subjectIds")
+    tag_ids: list[int] | None = Field(None, alias="tagIds")
+    skip_deleted_nm: bool | None = Field(None, alias="skipDeletedNm")
+    order_by: OrderBy | None = Field(None, alias="orderBy")
+    limit: int | None = Field(50, alias="limit")
+    offset: int | None = Field(0, alias="offset")