wildberries-sdk 0.1.0__py3-none-any.whl → 0.1.3__py3-none-any.whl

wildberries_sdk/analytics/models/product_history_response_inner.py

@@ -0,0 +1,101 @@
+# coding: utf-8
+
+"""
+    Аналитика и данные
+
+    <div class=\"description_important\">   Узнать больше об аналитике и данных можно в <a href=\"https://seller.wildberries.ru/instructions/ru/ru/subcategory/seller-analytics\">справочном центре</a> </div>  В разделе описаны методы получения:   1. [Воронки продаж](/openapi/analytics#tag/Voronka-prodazh)   2. [Поисковых запросов по вашим товарам](/openapi/analytics#tag/Poiskovye-zaprosy-po-vashim-tovaram)   3. [Истории остатков](/openapi/analytics#tag/Istoriya-ostatkov)   4. [Аналитики продавца в формате CSV](/openapi/analytics#tag/Analitika-prodavca-CSV) 
+
+    The version of the OpenAPI document: analytics
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field
+from typing import Any, ClassVar, Dict, List
+from wildberries_sdk.analytics.models.history import History
+from wildberries_sdk.analytics.models.product_history_response_inner_product import ProductHistoryResponseInnerProduct
+from typing import Optional, Set
+from typing_extensions import Self
+
+class ProductHistoryResponseInner(BaseModel):
+    """
+    ProductHistoryResponseInner
+    """ # noqa: E501
+    product: ProductHistoryResponseInnerProduct
+    history: List[History] = Field(description="Статистика за период")
+    __properties: ClassVar[List[str]] = ["product", "history"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of ProductHistoryResponseInner from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of product
+        if self.product:
+            _dict['product'] = self.product.to_dict()
+        # override the default output from pydantic by calling `to_dict()` of each item in history (list)
+        _items = []
+        if self.history:
+            for _item_history in self.history:
+                if _item_history:
+                    _items.append(_item_history.to_dict())
+            _dict['history'] = _items
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of ProductHistoryResponseInner from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "product": ProductHistoryResponseInnerProduct.from_dict(obj["product"]) if obj.get("product") is not None else None,
+            "history": [History.from_dict(_item) for _item in obj["history"]] if obj.get("history") is not None else None
+        })
+        return _obj
+
+

wildberries_sdk/analytics/models/product_orders_request.py

@@ -0,0 +1,96 @@
+# coding: utf-8
+
+"""
+    Аналитика и данные
+
+    <div class=\"description_important\">   Узнать больше об аналитике и данных можно в <a href=\"https://seller.wildberries.ru/instructions/ru/ru/subcategory/seller-analytics\">справочном центре</a> </div>  В разделе описаны методы получения:   1. [Воронки продаж](/openapi/analytics#tag/Voronka-prodazh)   2. [Поисковых запросов по вашим товарам](/openapi/analytics#tag/Poiskovye-zaprosy-po-vashim-tovaram)   3. [Истории остатков](/openapi/analytics#tag/Istoriya-ostatkov)   4. [Аналитики продавца в формате CSV](/openapi/analytics#tag/Analitika-prodavca-CSV) 
+
+    The version of the OpenAPI document: analytics
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictInt, StrictStr
+from typing import Any, ClassVar, Dict, List
+from typing_extensions import Annotated
+from wildberries_sdk.analytics.models.period_orders_request import PeriodOrdersRequest
+from typing import Optional, Set
+from typing_extensions import Self
+
+class ProductOrdersRequest(BaseModel):
+    """
+    ProductOrdersRequest
+    """ # noqa: E501
+    period: PeriodOrdersRequest
+    nm_id: StrictInt = Field(description="Артикул WB", alias="nmId")
+    search_texts: Annotated[List[StrictStr], Field(min_length=1, max_length=30)] = Field(description="Поисковые запросы. Для тарифа [Продвинутый](https://seller.wildberries.ru/monetization/tariffs) максимум — 100", alias="searchTexts")
+    __properties: ClassVar[List[str]] = ["period", "nmId", "searchTexts"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of ProductOrdersRequest from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of period
+        if self.period:
+            _dict['period'] = self.period.to_dict()
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of ProductOrdersRequest from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "period": PeriodOrdersRequest.from_dict(obj["period"]) if obj.get("period") is not None else None,
+            "nmId": obj.get("nmId"),
+            "searchTexts": obj.get("searchTexts")
+        })
+        return _obj
+
+

wildberries_sdk/analytics/models/product_orders_response.py

@@ -0,0 +1,105 @@
+# coding: utf-8
+
+"""
+    Аналитика и данные
+
+    <div class=\"description_important\">   Узнать больше об аналитике и данных можно в <a href=\"https://seller.wildberries.ru/instructions/ru/ru/subcategory/seller-analytics\">справочном центре</a> </div>  В разделе описаны методы получения:   1. [Воронки продаж](/openapi/analytics#tag/Voronka-prodazh)   2. [Поисковых запросов по вашим товарам](/openapi/analytics#tag/Poiskovye-zaprosy-po-vashim-tovaram)   3. [Истории остатков](/openapi/analytics#tag/Istoriya-ostatkov)   4. [Аналитики продавца в формате CSV](/openapi/analytics#tag/Analitika-prodavca-CSV) 
+
+    The version of the OpenAPI document: analytics
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field
+from typing import Any, ClassVar, Dict, List
+from wildberries_sdk.analytics.models.product_orders_metrics import ProductOrdersMetrics
+from wildberries_sdk.analytics.models.product_orders_text_item import ProductOrdersTextItem
+from typing import Optional, Set
+from typing_extensions import Self
+
+class ProductOrdersResponse(BaseModel):
+    """
+    ProductOrdersResponse
+    """ # noqa: E501
+    total: List[ProductOrdersMetrics] = Field(description="Итог по товарам")
+    items: List[ProductOrdersTextItem] = Field(description="Элементы таблицы")
+    __properties: ClassVar[List[str]] = ["total", "items"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of ProductOrdersResponse from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of each item in total (list)
+        _items = []
+        if self.total:
+            for _item_total in self.total:
+                if _item_total:
+                    _items.append(_item_total.to_dict())
+            _dict['total'] = _items
+        # override the default output from pydantic by calling `to_dict()` of each item in items (list)
+        _items = []
+        if self.items:
+            for _item_items in self.items:
+                if _item_items:
+                    _items.append(_item_items.to_dict())
+            _dict['items'] = _items
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of ProductOrdersResponse from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "total": [ProductOrdersMetrics.from_dict(_item) for _item in obj["total"]] if obj.get("total") is not None else None,
+            "items": [ProductOrdersTextItem.from_dict(_item) for _item in obj["items"]] if obj.get("items") is not None else None
+        })
+        return _obj
+
+

wildberries_sdk/analytics/models/product_orders_text_item.py

@@ -0,0 +1,99 @@
+# coding: utf-8
+
+"""
+    Аналитика и данные
+
+    <div class=\"description_important\">   Узнать больше об аналитике и данных можно в <a href=\"https://seller.wildberries.ru/instructions/ru/ru/subcategory/seller-analytics\">справочном центре</a> </div>  В разделе описаны методы получения:   1. [Воронки продаж](/openapi/analytics#tag/Voronka-prodazh)   2. [Поисковых запросов по вашим товарам](/openapi/analytics#tag/Poiskovye-zaprosy-po-vashim-tovaram)   3. [Истории остатков](/openapi/analytics#tag/Istoriya-ostatkov)   4. [Аналитики продавца в формате CSV](/openapi/analytics#tag/Analitika-prodavca-CSV) 
+
+    The version of the OpenAPI document: analytics
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictInt, StrictStr
+from typing import Any, ClassVar, Dict, List
+from wildberries_sdk.analytics.models.product_orders_metrics import ProductOrdersMetrics
+from typing import Optional, Set
+from typing_extensions import Self
+
+class ProductOrdersTextItem(BaseModel):
+    """
+    ProductOrdersTextItem
+    """ # noqa: E501
+    text: StrictStr = Field(description="Текст поискового запроса")
+    frequency: StrictInt = Field(description="Количество обращений с поисковым запросом")
+    date_items: List[ProductOrdersMetrics] = Field(description="Статистика по датам", alias="dateItems")
+    __properties: ClassVar[List[str]] = ["text", "frequency", "dateItems"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of ProductOrdersTextItem from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of each item in date_items (list)
+        _items = []
+        if self.date_items:
+            for _item_date_items in self.date_items:
+                if _item_date_items:
+                    _items.append(_item_date_items.to_dict())
+            _dict['dateItems'] = _items
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of ProductOrdersTextItem from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "text": obj.get("text"),
+            "frequency": obj.get("frequency"),
+            "dateItems": [ProductOrdersMetrics.from_dict(_item) for _item in obj["dateItems"]] if obj.get("dateItems") is not None else None
+        })
+        return _obj
+
+

wildberries_sdk/analytics/models/product_search_texts_request.py

@@ -0,0 +1,125 @@
+# coding: utf-8
+
+"""
+    Аналитика и данные
+
+    <div class=\"description_important\">   Узнать больше об аналитике и данных можно в <a href=\"https://seller.wildberries.ru/instructions/ru/ru/subcategory/seller-analytics\">справочном центре</a> </div>  В разделе описаны методы получения:   1. [Воронки продаж](/openapi/analytics#tag/Voronka-prodazh)   2. [Поисковых запросов по вашим товарам](/openapi/analytics#tag/Poiskovye-zaprosy-po-vashim-tovaram)   3. [Истории остатков](/openapi/analytics#tag/Istoriya-ostatkov)   4. [Аналитики продавца в формате CSV](/openapi/analytics#tag/Analitika-prodavca-CSV) 
+
+    The version of the OpenAPI document: analytics
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictBool, StrictInt, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
+from typing_extensions import Annotated
+from wildberries_sdk.analytics.models.order_by_gr_te import OrderByGrTe
+from wildberries_sdk.analytics.models.past_period import PastPeriod
+from wildberries_sdk.analytics.models.period import Period
+from wildberries_sdk.analytics.models.text_limit import TextLimit
+from typing import Optional, Set
+from typing_extensions import Self
+
+class ProductSearchTextsRequest(BaseModel):
+    """
+    Параметры для запроса по рейтингу поисковых запросов:   - `currentPeriod` — текущий период   - `pastPeriod` — предыдущий период для сравнения 
+    """ # noqa: E501
+    current_period: Period = Field(alias="currentPeriod")
+    past_period: Optional[PastPeriod] = Field(default=None, alias="pastPeriod")
+    nm_ids: Annotated[List[StrictInt], Field(max_length=50)] = Field(description="Список артикулов WB", alias="nmIds")
+    top_order_by: StrictStr = Field(description="Фильтрация по поисковым запросам, по которым больше всего:   - `openCard` — перешли в карточку   - `addToCart` — добавили в корзину   - `openToCart` — конверсия в корзину   - `orders` — заказали товаров   - `cartToOrder` — конверсия в заказ ", alias="topOrderBy")
+    include_substituted_skus: Optional[StrictBool] = Field(default=True, description="Показать данные по прямым запросам с [подменным артикулом](https://seller.wildberries.ru/help-center/article/A-524)", alias="includeSubstitutedSKUs")
+    include_search_texts: Optional[StrictBool] = Field(default=True, description="Показать данные по поисковым запросам без учёта подменного артикула", alias="includeSearchTexts")
+    order_by: OrderByGrTe = Field(alias="orderBy")
+    limit: TextLimit
+    __properties: ClassVar[List[str]] = ["currentPeriod", "pastPeriod", "nmIds", "topOrderBy", "includeSubstitutedSKUs", "includeSearchTexts", "orderBy", "limit"]
+
+    @field_validator('top_order_by')
+    def top_order_by_validate_enum(cls, value):
+        """Validates the enum"""
+        if value not in set(['openCard', 'addToCart', 'openToCart', 'orders', 'cartToOrder']):
+            raise ValueError("must be one of enum values ('openCard', 'addToCart', 'openToCart', 'orders', 'cartToOrder')")
+        return value
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of ProductSearchTextsRequest from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of current_period
+        if self.current_period:
+            _dict['currentPeriod'] = self.current_period.to_dict()
+        # override the default output from pydantic by calling `to_dict()` of past_period
+        if self.past_period:
+            _dict['pastPeriod'] = self.past_period.to_dict()
+        # override the default output from pydantic by calling `to_dict()` of order_by
+        if self.order_by:
+            _dict['orderBy'] = self.order_by.to_dict()
+        # override the default output from pydantic by calling `to_dict()` of limit
+        if self.limit:
+            _dict['limit'] = self.limit.to_dict()
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of ProductSearchTextsRequest from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "currentPeriod": Period.from_dict(obj["currentPeriod"]) if obj.get("currentPeriod") is not None else None,
+            "pastPeriod": PastPeriod.from_dict(obj["pastPeriod"]) if obj.get("pastPeriod") is not None else None,
+            "nmIds": obj.get("nmIds"),
+            "topOrderBy": obj.get("topOrderBy"),
+            "includeSubstitutedSKUs": obj.get("includeSubstitutedSKUs") if obj.get("includeSubstitutedSKUs") is not None else True,
+            "includeSearchTexts": obj.get("includeSearchTexts") if obj.get("includeSearchTexts") is not None else True,
+            "orderBy": OrderByGrTe.from_dict(obj["orderBy"]) if obj.get("orderBy") is not None else None,
+            "limit": TextLimit.from_dict(obj["limit"]) if obj.get("limit") is not None else None
+        })
+        return _obj
+
+

wildberries_sdk/analytics/models/product_search_texts_response.py

@@ -0,0 +1,95 @@
+# coding: utf-8
+
+"""
+    Аналитика и данные
+
+    <div class=\"description_important\">   Узнать больше об аналитике и данных можно в <a href=\"https://seller.wildberries.ru/instructions/ru/ru/subcategory/seller-analytics\">справочном центре</a> </div>  В разделе описаны методы получения:   1. [Воронки продаж](/openapi/analytics#tag/Voronka-prodazh)   2. [Поисковых запросов по вашим товарам](/openapi/analytics#tag/Poiskovye-zaprosy-po-vashim-tovaram)   3. [Истории остатков](/openapi/analytics#tag/Istoriya-ostatkov)   4. [Аналитики продавца в формате CSV](/openapi/analytics#tag/Analitika-prodavca-CSV) 
+
+    The version of the OpenAPI document: analytics
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field
+from typing import Any, ClassVar, Dict, List
+from wildberries_sdk.analytics.models.table_search_text_item import TableSearchTextItem
+from typing import Optional, Set
+from typing_extensions import Self
+
+class ProductSearchTextsResponse(BaseModel):
+    """
+    ProductSearchTextsResponse
+    """ # noqa: E501
+    items: List[TableSearchTextItem] = Field(description="Элементы таблицы")
+    __properties: ClassVar[List[str]] = ["items"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of ProductSearchTextsResponse from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of each item in items (list)
+        _items = []
+        if self.items:
+            for _item_items in self.items:
+                if _item_items:
+                    _items.append(_item_items.to_dict())
+            _dict['items'] = _items
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of ProductSearchTextsResponse from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "items": [TableSearchTextItem.from_dict(_item) for _item in obj["items"]] if obj.get("items") is not None else None
+        })
+        return _obj
+
+