justoneapi 3.0.68__tar.gz → 3.0.70__tar.gz

{justoneapi-3.0.68 → justoneapi-3.0.70}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: justoneapi
-Version: 3.0.68
+Version: 3.0.70
 Summary: OpenAPI-driven Python SDK for Just One API
 Author-email: Just One API <support@justoneapi.com>
 Requires-Python: >=3.10
@@ -420,6 +420,11 @@ except BusinessError as exc:
 - [商品详情 (V1)](https://docs.justoneapi.com/zh/api/1688/product-details-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
 - [商品搜索 (V1)](https://docs.justoneapi.com/zh/api/1688/product-search-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
 
+### AliExpress
+
+- [商品搜索 (V1)](https://docs.justoneapi.com/zh/api/aliexpress/product-search-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
+- [商品详情 (V1)](https://docs.justoneapi.com/zh/api/aliexpress/product-details-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
+
 ### Temu
 
 - [首页商品信息流 (V1)](https://docs.justoneapi.com/zh/api/temu/homepage-product-feed-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)

{justoneapi-3.0.68 → justoneapi-3.0.70}/README.md

@@ -404,6 +404,11 @@ except BusinessError as exc:
 - [商品详情 (V1)](https://docs.justoneapi.com/zh/api/1688/product-details-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
 - [商品搜索 (V1)](https://docs.justoneapi.com/zh/api/1688/product-search-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
 
+### AliExpress
+
+- [商品搜索 (V1)](https://docs.justoneapi.com/zh/api/aliexpress/product-search-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
+- [商品详情 (V1)](https://docs.justoneapi.com/zh/api/aliexpress/product-details-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
+
 ### Temu
 
 - [首页商品信息流 (V1)](https://docs.justoneapi.com/zh/api/temu/homepage-product-feed-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)

justoneapi-3.0.70/justoneapi/_version.py

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

{justoneapi-3.0.68 → justoneapi-3.0.70}/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.70/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 - `salesDesc`: Sales volume, highest first - `priceAsc`: Price, lowest first - `priceDesc`: 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.68 → justoneapi-3.0.70}/justoneapi/generated/resources/youtube.py

@@ -28,7 +28,7 @@ class YoutubeResource(BaseResource):
             keyword: Search term. Required for the first page; leave empty when using nextToken.
             lang: Optional IETF language tag for localized results, such as en-US. Leave empty to use the default language.
             upload_date: Upload-date filter.  Available Values: - `all`: No upload-date limit - `lastHour`: Uploaded within the last hour - `today`: Uploaded today - `thisWeek`: Uploaded this week - `thisMonth`: Uploaded this month - `thisYear`: Uploaded this year
-            duration: Video-duration filter.  Available Values: - `all`: No duration limit - `SHORT`: Short videos under 4 minutes - `medium`: Medium videos from 4 to 20 minutes - `LONG`: Long videos over 20 minutes
+            duration: Video-duration filter.  Available Values: - `all`: No duration limit - `short`: Short videos under 4 minutes - `medium`: Medium videos from 4 to 20 minutes - `long`: Long videos over 20 minutes
             sort_by: Sort order for search results.  Available Values: - `relevance`: Sort by relevance - `uploadDate`: Sort by upload date - `viewCount`: Sort by view count - `rating`: Sort by rating
             next_token: Pagination token returned by the previous response. When provided, the keyword and filter parameters are ignored; very long tokens may exceed GET URL limits.
         """

{justoneapi-3.0.68 → justoneapi-3.0.70}/justoneapi.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: justoneapi
-Version: 3.0.68
+Version: 3.0.70
 Summary: OpenAPI-driven Python SDK for Just One API
 Author-email: Just One API <support@justoneapi.com>
 Requires-Python: >=3.10
@@ -420,6 +420,11 @@ except BusinessError as exc:
 - [商品详情 (V1)](https://docs.justoneapi.com/zh/api/1688/product-details-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
 - [商品搜索 (V1)](https://docs.justoneapi.com/zh/api/1688/product-search-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
 
+### AliExpress
+
+- [商品搜索 (V1)](https://docs.justoneapi.com/zh/api/aliexpress/product-search-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
+- [商品详情 (V1)](https://docs.justoneapi.com/zh/api/aliexpress/product-details-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)
+
 ### Temu
 
 - [首页商品信息流 (V1)](https://docs.justoneapi.com/zh/api/temu/homepage-product-feed-v1?utm_source=github.com&utm_medium=referral&utm_campaign=justoneapi_justoneapi_python&utm_content=repo_readme_api_list)

{justoneapi-3.0.68 → justoneapi-3.0.70}/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.68/justoneapi/_version.py

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