justoneapi 3.0.67__tar.gz → 3.0.69__tar.gz

{justoneapi-3.0.67 → justoneapi-3.0.69}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: justoneapi
-Version: 3.0.67
+Version: 3.0.69
 Summary: OpenAPI-driven Python SDK for Just One API
 Author-email: Just One API <support@justoneapi.com>
 Requires-Python: >=3.10

justoneapi-3.0.69/justoneapi/_version.py

@@ -0,0 +1 @@
+__version__ = "3.0.69"

{justoneapi-3.0.67 → justoneapi-3.0.69}/justoneapi/generated/resources/__init__.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+from justoneapi.generated.resources.aliexpress import AliexpressResource
 from justoneapi.generated.resources.amazon import AmazonResource
 from justoneapi.generated.resources.beike import BeikeResource
 from justoneapi.generated.resources.bilibili import BilibiliResource
@@ -38,6 +39,7 @@ from justoneapi.generated.resources.youtube import YoutubeResource
 from justoneapi.generated.resources.zhihu import ZhihuResource
 
 RESOURCE_CLASSES = {
+    "aliexpress": AliexpressResource,
     "amazon": AmazonResource,
     "beike": BeikeResource,
     "bilibili": BilibiliResource,
@@ -77,6 +79,7 @@ RESOURCE_CLASSES = {
 }
 
 __all__ = [
+    "AliexpressResource",
     "AmazonResource",
     "BeikeResource",
     "BilibiliResource",

justoneapi-3.0.69/justoneapi/generated/resources/aliexpress.py

@@ -0,0 +1,95 @@
+from __future__ import annotations
+
+from typing import Any
+
+from justoneapi._resource import BaseResource
+from justoneapi._response import ApiResponse
+
+
+class AliexpressResource(BaseResource):
+    """Generated resource for AliExpress."""
+
+    def search_products_v1(
+        self,
+        *,
+        q: str | None = None,
+        page: str | None = None,
+        sort: str | None = "default",
+        cat_id: str | None = None,
+        brand_id: str | None = None,
+        loc: str | None = None,
+        switches: str | None = None,
+        attr: str | None = None,
+        start_price: float | None = None,
+        end_price: float | None = None,
+        locale: str | None = None,
+        region: str | None = None,
+        currency: str | None = None,
+    ) -> ApiResponse[Any]:
+        """
+        Product Search
+
+        Searches AliExpress products with optional query, page, sort, category, brand, location, attribute, price, locale, region, and currency controls. Use it for product discovery, catalog research, and marketplace assortment analysis.
+
+        Args:
+            q: Product search query.
+            page: One-based page number for pagination.
+            sort: Sort order for product search results.  Available Values: - `DEFAULT`: Default result order - `SALES_DESC`: Sales volume, highest first - `PRICE_ASC`: Price, lowest first - `PRICE_DESC`: Price, highest first
+            cat_id: Category ID used to filter product search results.
+            brand_id: Brand ID used to filter product search results.
+            loc: Location filter for product search results.
+            switches: Search switches used to select optional result features.
+            attr: Product attribute filter for search results.
+            start_price: Minimum product price filter, inclusive.
+            end_price: Maximum product price filter, inclusive.
+            locale: Locale used for the AliExpress response.
+            region: AliExpress marketplace region.
+            currency: Currency code used for product prices.
+        """
+        return self._get(
+            "/api/aliexpress/search-products/v1",
+            {
+                "q": q,
+                "page": page,
+                "sort": sort,
+                "catId": cat_id,
+                "brandId": brand_id,
+                "loc": loc,
+                "switches": switches,
+                "attr": attr,
+                "startPrice": start_price,
+                "endPrice": end_price,
+                "locale": locale,
+                "region": region,
+                "currency": currency,
+            },
+        )
+
+    def get_product_detail_v1(
+        self,
+        *,
+        item_id: str,
+        currency: str | None = None,
+        region: str | None = None,
+        locale: str | None = None,
+    ) -> ApiResponse[Any]:
+        """
+        Product Details
+
+        Retrieves an AliExpress product by item ID with optional currency, region, and locale controls. Use it to inspect a known listing for catalog review, product comparison, or downstream commerce analysis.
+
+        Args:
+            item_id: Numeric AliExpress item ID.
+            currency: Currency code used for product prices.
+            region: AliExpress marketplace region.
+            locale: Locale used for the AliExpress response.
+        """
+        return self._get(
+            "/api/aliexpress/get-product-detail/v1",
+            {
+                "itemId": item_id,
+                "currency": currency,
+                "region": region,
+                "locale": locale,
+            },
+        )

{justoneapi-3.0.67 → justoneapi-3.0.69}/justoneapi/generated/resources/taobao.py

@@ -117,7 +117,7 @@ class TaobaoResource(BaseResource):
         """
         Product Details
 
-        Retrieves Taobao or Tmall product details by item ID through the V6 endpoint. Use it to perform direct product lookup for catalog research, product monitoring, or ecommerce analysis.
+        Retrieves Taobao or Tmall product details by item ID through the recommended V6 endpoint, including approximate sales, shipping fees, free-shipping status, and coupon-adjusted prices for some products. Use it for product research and ecommerce monitoring.
 
         Args:
             item_id: Unique product identifier on Taobao/Tmall (item ID).

{justoneapi-3.0.67 → justoneapi-3.0.69}/justoneapi.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: justoneapi
-Version: 3.0.67
+Version: 3.0.69
 Summary: OpenAPI-driven Python SDK for Just One API
 Author-email: Just One API <support@justoneapi.com>
 Requires-Python: >=3.10

{justoneapi-3.0.67 → justoneapi-3.0.69}/justoneapi.egg-info/SOURCES.txt

@@ -18,6 +18,7 @@ justoneapi.egg-info/top_level.txt
 justoneapi/generated/__init__.py
 justoneapi/generated/models.py
 justoneapi/generated/resources/__init__.py
+justoneapi/generated/resources/aliexpress.py
 justoneapi/generated/resources/amazon.py
 justoneapi/generated/resources/beike.py
 justoneapi/generated/resources/bilibili.py

justoneapi-3.0.67/justoneapi/_version.py

@@ -1 +0,0 @@
-__version__ = "3.0.67"