justoneapi 3.0.78__tar.gz → 3.0.80__tar.gz

{justoneapi-3.0.78/justoneapi.egg-info → justoneapi-3.0.80}/PKG-INFO

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

justoneapi-3.0.80/justoneapi/_version.py

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

{justoneapi-3.0.78 → justoneapi-3.0.80}/justoneapi/generated/resources/jd.py

@@ -77,7 +77,7 @@ class JdResource(BaseResource):
         """
         Product Details
 
-        Retrieves JD.com product details by item ID through the V4 endpoint. Use it to perform direct product lookup for catalog research, product monitoring, or ecommerce analysis.
+        Retrieve JD.com product details by item ID, including a complete set of product images. Use it to review product information and images for catalog research or ecommerce analysis.
 
         Args:
             item_id: A unique product identifier on JD.com (item ID).

{justoneapi-3.0.78 → justoneapi-3.0.80}/justoneapi/generated/resources/vcg.py

@@ -18,11 +18,12 @@ class VcgResource(BaseResource):
         max_pages: str | None = None,
         exclude_resource_ids: list[Any] | None = None,
         content_filter: str | None = "all",
+        result_mode: str | None = "full",
     ) -> ApiResponse[Any]:
         """
         Image Search
 
-        Searches VCG images by keyword with a requested image count, page controls, exclusions for previously collected resource IDs, and an optional 500px Select/Prime filter excluding AIGC. Use the same content filter when continuing an interrupted search.
+        Searches VCG images by keyword with page controls, resource ID exclusions, and an optional 500px Select/Prime filter excluding AIGC. Use full image details for collection or candidate_ids for single-page ID inspection.
 
         Args:
             keyword: Image search keyword, up to 200 characters without control characters.
@@ -31,6 +32,7 @@ class VcgResource(BaseResource):
             max_pages: Maximum number of pages to visit in this request. The last requested page must not exceed 10000.
             exclude_resource_ids: Previously collected VCG resource IDs to exclude when continuing a search. Supply comma-separated IDs or repeat this query parameter.
             content_filter: Optional brand and AIGC search restriction. Keep this value unchanged across pagination and continuation.  Available Values: - `all`: Keep the default search without additional brand or AIGC filters. - `selected_500px_no_aigc`: Select only 500px Select and 500px Prime, exclude AIGC using the site's filter, and retain best ordering. Do not expand to other brands when results run out.
+            result_mode: Result mode: full returns normal image details; candidate_ids only inspects one page of resource IDs and requires limit 10000, maxPages 1, and no excluded resource IDs. A candidate inspection does not complete or advance an image search.  Available Values: - `full`: Return the normal image search result with complete image details. - `candidate_ids`: Inspect resource IDs from one validated search page without image details. Requires limit 10000, maxPages 1, and no excluded resource IDs; this is not an image result or a completion receipt.
         """
         return self._get(
             "/api/vcg/search-image/v1",
@@ -41,5 +43,6 @@ class VcgResource(BaseResource):
                 "maxPages": max_pages,
                 "excludeResourceIds": exclude_resource_ids,
                 "contentFilter": content_filter,
+                "resultMode": result_mode,
             },
         )

{justoneapi-3.0.78 → justoneapi-3.0.80}/justoneapi/generated/resources/xiaohongshu.py

@@ -136,13 +136,13 @@ class XiaohongshuResource(BaseResource):
         note_time: str | None = None,
     ) -> ApiResponse[Any]:
         """
-        Note Search
+        Keyword Note Search
 
-        Searches Xiaohongshu (RedNote) notes by keyword with pagination plus sort, note-type, and publish-time filters. Use it to support topic research, content discovery, and monitoring keyword-related posts.
+        Searches Xiaohongshu (RedNote) notes by keyword with page-based pagination, sorting and note-type filters. The V2 noteTime filter may return notes outside the selected time range. This endpoint does not search user accounts.
 
         Args:
             keyword: Search keyword.
-            page: Page number for pagination.
+            page: Page number for pagination. Start at 1, then increment page while keeping the keyword and filters unchanged.
             sort: Sort order for the result set.  Available Values: - `general`: General - `popularity_descending`: Popularity Descending - `time_descending`: Time Descending - `comment_descending`: Comment Descending - `collect_descending`: Collect Descending
             note_type: Note type filter.  Available Values: - `_0`: General - `_1`: Video - `_2`: Normal
             note_time: Note publish time filter. Results may include notes published outside the selected time range.  Available Values: - `ONE_DAY`: Within one day - `ONE_WEEK`: Within a week - `HALF_YEAR`: Within half a year
@@ -321,13 +321,13 @@ class XiaohongshuResource(BaseResource):
         last_cursor: str | None = None,
     ) -> ApiResponse[Any]:
         """
-        User Published Notes
+        User Notes
 
-        Retrieves notes published by a Xiaohongshu (RedNote) user, accepting a user ID or supported profile URL and a cursor for pagination. Use it to support creator content browsing, account monitoring, and reviewing a user's note history.
+        Reads a user's published public Xiaohongshu (RedNote) notes by user ID or supported profile URL, with lastCursor pagination. This endpoint does not create, upload or publish notes.
 
         Args:
             user_id: A Xiaohongshu user ID or a profile URL containing /user/profile/.
-            last_cursor: Pagination cursor from the previous page (the last note's cursor value).
+            last_cursor: Omit on the first request. For the next page, pass the last note's cursor value from the previous response.
         """
         return self._get(
             "/api/xiaohongshu/get-user-note-list/v4",

{justoneapi-3.0.78 → justoneapi-3.0.80/justoneapi.egg-info}/PKG-INFO

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

justoneapi-3.0.78/justoneapi/_version.py

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