wbapi-async 0.2.2__tar.gz → 0.2.3__tar.gz

wbapi_async-0.2.3/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: wbapi-async
+Version: 0.2.3
+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.2.3/pyproject.toml

@@ -0,0 +1,126 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "wbapi-async"
+version = "0.2.3"
+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.2.3/src/wbapi_async/analytics/__init__.py

@@ -0,0 +1,102 @@
+from .enums.aggregation_level import AggregationLevel
+from .enums.availability_filters_item import AvailabilityFiltersItem
+from .enums.field import Field
+from .enums.mode import Mode
+from .enums.position_cluster import PositionCluster
+from .enums.stock_type import StockType
+from .enums.top_order_by import TopOrderBy
+from .types.avg_stock_turnover import AvgStockTurnover
+from .types.comparison import Comparison
+from .types.conversions import Conversions
+from .types.create_the_report_response import CreateTheReportResponse
+from .types.current_period import CurrentPeriod
+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.office_missing_time import OfficeMissingTime
+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_a_group_response import PaginationByProductsWithinAGroupResponse
+from .types.past import Past
+from .types.past_period import PastPeriod
+from .types.period import Period
+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.time_to_ready_dynamic import TimeToReadyDynamic
+from .types.warehouse_data_item import WarehouseDataItem
+from .types.wb_club import WbClub
+from .types.wb_club_dynamic import WbClubDynamic
+
+
+__all__ = (
+    "AggregationLevel",
+    "AvailabilityFiltersItem",
+    "AvgStockTurnover",
+    "Comparison",
+    "Conversions",
+    "CreateTheReportResponse",
+    "CurrentPeriod",
+    "Field",
+    "FloatGraphByPeriodItem",
+    "GroupDataItem",
+    "GroupedProductCardsStatisticsPerDaysItem",
+    "History",
+    "MainPageResponse",
+    "Metrics",
+    "Mode",
+    "OfficeMissingTime",
+    "OfficesItem",
+    "OrderBy",
+    "OrdersAndPositionsByProductSearchTextsResponse",
+    "PaginationByGroupsResponse",
+    "PaginationByProductsWithinAGroupResponse",
+    "Past",
+    "PastPeriod",
+    "Period",
+    "PositionCluster",
+    "Product",
+    "ProductCardsStatisticsPerDaysResponse",
+    "ProductCardsStatisticsPerPeriodItem",
+    "ProductDataItem",
+    "RegenerateTheReportResponse",
+    "SaleRate",
+    "SearchTextsByProductResponse",
+    "Selected",
+    "SelectedPeriod",
+    "SizeDataItem",
+    "Statistic",
+    "Stocks",
+    "StockType",
+    "TableProductItemSt",
+    "Tag",
+    "TheReportResponse",
+    "TheReportsListItem",
+    "TimeToReady",
+    "TimeToReadyDynamic",
+    "TopOrderBy",
+    "WarehouseDataItem",
+    "WbClub",
+    "WbClubDynamic",
+)

wbapi_async-0.2.3/src/wbapi_async/analytics/enums/__init__.py

@@ -0,0 +1,18 @@
+from .aggregation_level import AggregationLevel
+from .availability_filters_item import AvailabilityFiltersItem
+from .field import Field
+from .mode import Mode
+from .position_cluster import PositionCluster
+from .stock_type import StockType
+from .top_order_by import TopOrderBy
+
+
+__all__ = (
+    "AggregationLevel",
+    "AvailabilityFiltersItem",
+    "Field",
+    "Mode",
+    "PositionCluster",
+    "StockType",
+    "TopOrderBy",
+)

wbapi_async-0.2.3/src/wbapi_async/analytics/enums/availability_filters_item.py

@@ -0,0 +1,10 @@
+from enum import StrEnum
+
+
+class AvailabilityFiltersItem(StrEnum):
+    DEFICIENT = "deficient"
+    ACTUAL = "actual"
+    BALANCED = "balanced"
+    NONACTUAL = "nonActual"
+    NONLIQUID = "nonLiquid"
+    INVALIDDATA = "invalidData"

wbapi_async-0.2.3/src/wbapi_async/analytics/enums/field.py

@@ -0,0 +1,30 @@
+from enum import StrEnum
+
+
+class Field(StrEnum):
+    """Sort field:"""
+
+    OPENCARD = "openCard"
+    ADDTOCART = "addToCart"
+    ORDERCOUNT = "orderCount"
+    ORDERSUM = "orderSum"
+    BUYOUTCOUNT = "buyoutCount"
+    BUYOUTSUM = "buyoutSum"
+    CANCELCOUNT = "cancelCount"
+    CANCELSUM = "cancelSum"
+    AVGPRICE = "avgPrice"
+    STOCKMPQTY = "stockMpQty"
+    STOCKWBQTY = "stockWbQty"
+    SHAREORDERPERCENT = "shareOrderPercent"
+    ADDTOWISHLIST = "addToWishlist"
+    TIMETOREADY = "timeToReady"
+    LOCALIZATIONPERCENT = "localizationPercent"
+    WBCLUB_ORDERCOUNT = "wbClub.orderCount"
+    WBCLUB_ORDERSUM = "wbClub.orderSum"
+    WBCLUB_BUYOUTSUM = "wbClub.buyoutSum"
+    WBCLUB_CANCELSUM = "wbClub.cancelSum"
+    WBCLUB_BUYOUTCOUNT = "wbClub.buyoutCount"
+    WBCLUB_AVGPRICE = "wbClub.avgPrice"
+    WBCLUB_BUYOUTPERCENT = "wbClub.buyoutPercent"
+    WBCLUB_AVGORDERCOUNTPERDAY = "wbClub.avgOrderCountPerDay"
+    WBCLUB_CANCELCOUNT = "wbClub.cancelCount"

wbapi_async-0.2.3/src/wbapi_async/analytics/enums/mode.py

@@ -0,0 +1,8 @@
+from enum import StrEnum
+
+
+class Mode(StrEnum):
+    """Sorting order:"""
+
+    ASC = "asc"
+    DESC = "desc"

wbapi_async-0.2.3/src/wbapi_async/analytics/enums/stock_type.py

@@ -0,0 +1,9 @@
+from enum import StrEnum
+
+
+class StockType(StrEnum):
+    """Type of products storage warehouse:"""
+
+    V_ = ""
+    WB = "wb"
+    MP = "mp"

wbapi_async-0.2.3/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_a_group 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.2.3/src/wbapi_async/analytics/methods/get_create_the_report.py

@@ -0,0 +1,19 @@
+from ...methods.base import WbMethod
+from ...types import CreateTheReportResponse, RequestLimit
+
+
+class GetCreateTheReport(WbMethod):
+    """
+    The method creates a task for generating a report with advanced seller analytics. You can
+    createa CSV-version of [sales funnel](/openapi/analytics#tag/Sales-Funnel) or [search
+    parameters](/openapi/analytics#tag/Search-Queries-for-Your-Items)report with grouping:
+
+    Source: https://dev.wildberries.ru/en/docs/openapi/analytics#tag/Seller-Analytics-CSV/paths/~1api~1v2~1nm-report~1downloads/post
+    """
+
+    __return__ = CreateTheReportResponse
+    __api__ = "seller-analytics-api"
+    __method__ = "api/v2/nm-report/downloads"
+    __http_method__ = "POST"
+
+    request_limit: RequestLimit = RequestLimit(period=60, limit=10, interval=600, burst=5)

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

@@ -0,0 +1,36 @@
+from pydantic import Field
+
+from ...methods.base import WbMethod
+from ...types import CurrentPeriod, GroupDataItem, OrderBy, RequestLimit
+from ..enums.availability_filters_item import AvailabilityFiltersItem
+from ..enums.stock_type import StockType
+
+
+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_i_ds: list[int] | None = Field(None, alias="nmIDs")
+    subject_i_ds: list[int] | None = Field(None, alias="subjectIDs")
+    brand_names: list[str] | None = Field(None, alias="brandNames")
+    tag_i_ds: list[int] | None = Field(None, alias="tagIDs")
+    current_period: CurrentPeriod = Field(alias="currentPeriod")
+    stock_type: StockType = Field(alias="stockType")
+    skip_deleted_nm: bool = Field(alias="skipDeletedNm")
+    availability_filters: list[AvailabilityFiltersItem] = Field(alias="availabilityFilters")
+    order_by: OrderBy = Field(alias="orderBy")
+    limit: int | None = Field(100)
+    offset: int = Field()

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

@@ -0,0 +1,29 @@
+from pydantic import Field
+
+from ...methods.base import WbMethod
+from ...types import GroupedProductCardsStatisticsPerDaysItem, RequestLimit, SelectedPeriod
+from ..enums.aggregation_level import AggregationLevel
+
+
+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: AggregationLevel | None = Field(AggregationLevel.DAY, alias="aggregationLevel")

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

@@ -0,0 +1,35 @@
+from pydantic import Field
+
+from ...methods.base import WbMethod
+from ...types import CurrentPeriod, MainPageResponse, OrderBy, PastPeriod, RequestLimit
+from ..enums.position_cluster import PositionCluster
+
+
+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: CurrentPeriod = Field(alias="currentPeriod")
+    past_period: PastPeriod | 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: PositionCluster = Field(alias="positionCluster")
+    order_by: OrderBy = Field(alias="orderBy")
+    include_substituted_sk_us: bool | None = Field(True, alias="includeSubstitutedSKUs")
+    include_search_texts: bool | None = Field(True, alias="includeSearchTexts")
+    limit: int = Field()
+    offset: int = Field()

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

@@ -0,0 +1,25 @@
+from pydantic import Field
+
+from ...finances.enums.period import Period
+from ...methods.base import WbMethod
+from ...types import OrdersAndPositionsByProductSearchTextsResponse, RequestLimit
+
+
+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: Period = Field()
+    nm_id: int = Field(alias="nmId")
+    search_texts: list[str] = Field(alias="searchTexts")

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

@@ -0,0 +1,35 @@
+from pydantic import Field
+
+from ...methods.base import WbMethod
+from ...types import CurrentPeriod, OrderBy, PaginationByGroupsResponse, PastPeriod, RequestLimit
+from ..enums.position_cluster import PositionCluster
+
+
+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: CurrentPeriod = Field(alias="currentPeriod")
+    past_period: PastPeriod | 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: PositionCluster = Field(alias="positionCluster")
+    include_substituted_sk_us: bool | None = Field(True, alias="includeSubstitutedSKUs")
+    include_search_texts: bool | None = Field(True, alias="includeSearchTexts")
+    limit: int = Field()
+    offset: int = Field()

wbapi_async-0.2.3/src/wbapi_async/analytics/methods/get_pagination_by_products_within_a_group.py

@@ -0,0 +1,40 @@
+from pydantic import Field
+
+from ...methods.base import WbMethod
+from ...types import (
+    CurrentPeriod,
+    OrderBy,
+    PaginationByProductsWithinAGroupResponse,
+    PastPeriod,
+    RequestLimit,
+)
+from ..enums.position_cluster import PositionCluster
+
+
+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: CurrentPeriod = Field(alias="currentPeriod")
+    past_period: PastPeriod | 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: PositionCluster = Field(alias="positionCluster")
+    include_substituted_sk_us: bool | None = Field(True, alias="includeSubstitutedSKUs")
+    include_search_texts: bool | None = Field(True, alias="includeSearchTexts")
+    limit: int = Field()
+    offset: int = Field()