Skip to content

Commit aef20da

Browse files
chore: sync OpenAPI spec and generated SDK v3.0.36
# OpenAPI Sync Summary - Paths: 273 -> 275 - Tags: 33 -> 34 - Added operationId count: 2 - Removed operationId count: 0 - Changed operationId count: 0 ## Added operationId - getApiTaobaoGetItemDetailV6 [GET /api/taobao/get-item-detail/v6] - getApiXiaohongshuEcSearchProductsV1 [GET /api/xiaohongshu-ec/search-products/v1] ## Removed operationId - None ## Changed operationId - None
1 parent 935b2e3 commit aef20da

6 files changed

Lines changed: 446 additions & 3 deletions

File tree

justoneapi/_version.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
__version__ = "3.0.35"
1+
__version__ = "3.0.36"

justoneapi/generated/resources/__init__.py

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,7 @@
2929
from justoneapi.generated.resources.weixin_channels import WeixinChannelsResource
3030
from justoneapi.generated.resources.xianyu import XianyuResource
3131
from justoneapi.generated.resources.xiaohongshu import XiaohongshuResource
32+
from justoneapi.generated.resources.xiaohongshu_ec import XiaohongshuEcResource
3233
from justoneapi.generated.resources.xiaohongshu_pgy import XiaohongshuPgyResource
3334
from justoneapi.generated.resources.youku import YoukuResource
3435
from justoneapi.generated.resources.youtube import YoutubeResource
@@ -64,6 +65,7 @@
6465
"weixin_channels": WeixinChannelsResource,
6566
"xianyu": XianyuResource,
6667
"xiaohongshu": XiaohongshuResource,
68+
"xiaohongshu_ec": XiaohongshuEcResource,
6769
"xiaohongshu_pgy": XiaohongshuPgyResource,
6870
"youku": YoukuResource,
6971
"youtube": YoutubeResource,
@@ -100,6 +102,7 @@
100102
"WeixinChannelsResource",
101103
"XianyuResource",
102104
"XiaohongshuResource",
105+
"XiaohongshuEcResource",
103106
"XiaohongshuPgyResource",
104107
"YoukuResource",
105108
"YoutubeResource",

justoneapi/generated/resources/taobao.py

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -109,6 +109,26 @@ def get_item_detail_v5(
109109
},
110110
)
111111

112+
def get_item_detail_v6(
113+
self,
114+
*,
115+
item_id: str,
116+
) -> ApiResponse[Any]:
117+
"""
118+
Product Details
119+
120+
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.
121+
122+
Args:
123+
item_id: Unique product identifier on Taobao/Tmall (item ID).
124+
"""
125+
return self._get(
126+
"/api/taobao/get-item-detail/v6",
127+
{
128+
"itemId": item_id,
129+
},
130+
)
131+
112132
def get_item_detail_v9(
113133
self,
114134
*,
Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
from __future__ import annotations
2+
3+
from typing import Any
4+
5+
from justoneapi._resource import BaseResource
6+
from justoneapi._response import ApiResponse
7+
8+
9+
class XiaohongshuEcResource(BaseResource):
10+
"""Generated resource for Xiaohongshu E-commerce (RedNote)."""
11+
12+
def search_products_v1(
13+
self,
14+
*,
15+
keyword: str,
16+
page: str | None = None,
17+
search_id: str | None = "",
18+
) -> ApiResponse[Any]:
19+
"""
20+
Product Search
21+
22+
Searches Xiaohongshu E-commerce (RedNote) products by keyword with page and search-ID pagination; pages after the first require the search ID returned by the initial search. Use it to discover marketplace products and continue through multi-page results.
23+
24+
Args:
25+
keyword: Search keyword.
26+
page: Page number, starting from 1.
27+
search_id: Search ID returned by the first-page response; required when page is greater than 1.
28+
"""
29+
return self._get(
30+
"/api/xiaohongshu-ec/search-products/v1",
31+
{
32+
"keyword": keyword,
33+
"page": page,
34+
"searchId": search_id,
35+
},
36+
)

openapi/public-api.json

Lines changed: 192 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13304,6 +13304,88 @@
1330413304
]
1330513305
}
1330613306
},
13307+
"/api/taobao/get-item-detail/v6": {
13308+
"get": {
13309+
"description": "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.",
13310+
"operationId": "getApiTaobaoGetItemDetailV6",
13311+
"parameters": [
13312+
{
13313+
"description": "Access token for this API service.",
13314+
"in": "query",
13315+
"name": "token",
13316+
"required": true,
13317+
"schema": {
13318+
"type": "string"
13319+
}
13320+
},
13321+
{
13322+
"description": "Unique product identifier on Taobao/Tmall (item ID).",
13323+
"in": "query",
13324+
"name": "itemId",
13325+
"required": true,
13326+
"schema": {
13327+
"type": "string"
13328+
}
13329+
}
13330+
],
13331+
"responses": {
13332+
"200": {
13333+
"content": {
13334+
"application/json": {
13335+
"schema": {
13336+
"$ref": "#/components/schemas/Result"
13337+
}
13338+
}
13339+
},
13340+
"description": "OK"
13341+
},
13342+
"400": {
13343+
"$ref": "#/components/responses/ResultBadRequestResponse"
13344+
},
13345+
"401": {
13346+
"$ref": "#/components/responses/ResultUnauthorizedResponse"
13347+
},
13348+
"403": {
13349+
"$ref": "#/components/responses/ResultForbiddenResponse"
13350+
},
13351+
"429": {
13352+
"$ref": "#/components/responses/ResultTooManyRequestsResponse"
13353+
},
13354+
"500": {
13355+
"$ref": "#/components/responses/ResultInternalServerErrorResponse"
13356+
}
13357+
},
13358+
"summary": "Product Details",
13359+
"tags": [
13360+
"Taobao and Tmall"
13361+
],
13362+
"x-api-version": "v6",
13363+
"x-endpoint-family": "taobao_get_item_detail",
13364+
"x-highlights": [
13365+
{
13366+
"aliases": [
13367+
"product coverage",
13368+
"supported products",
13369+
"商品覆盖",
13370+
"支持商品"
13371+
],
13372+
"concept": "product_coverage",
13373+
"content": "Some products may not be available through this endpoint.",
13374+
"kind": "CONDITION",
13375+
"type": "tip"
13376+
}
13377+
],
13378+
"x-order": "11001350",
13379+
"x-search-aliases": [
13380+
"Taobao product details v6",
13381+
"Tmall item detail lookup v6",
13382+
"Taobao item information API v6",
13383+
"淘宝商品详情 V6",
13384+
"天猫商品详情查询 V6",
13385+
"淘宝商品 ID 查询 V6"
13386+
]
13387+
}
13388+
},
1330713389
"/api/taobao/get-item-detail/v9": {
1330813390
"get": {
1330913391
"description": "Retrieves Taobao or Tmall product details by item ID through the V9 endpoint. Use it to perform direct product lookup for catalog research, product monitoring, or ecommerce analysis.",
@@ -19715,6 +19797,94 @@
1971519797
]
1971619798
}
1971719799
},
19800+
"/api/xiaohongshu-ec/search-products/v1": {
19801+
"get": {
19802+
"description": "Searches Xiaohongshu E-commerce (RedNote) products by keyword with page and search-ID pagination; pages after the first require the search ID returned by the initial search. Use it to discover marketplace products and continue through multi-page results.",
19803+
"operationId": "getApiXiaohongshuEcSearchProductsV1",
19804+
"parameters": [
19805+
{
19806+
"description": "Authentication token for this API service.",
19807+
"in": "query",
19808+
"name": "token",
19809+
"required": true,
19810+
"schema": {
19811+
"type": "string"
19812+
}
19813+
},
19814+
{
19815+
"description": "Search keyword.",
19816+
"in": "query",
19817+
"name": "keyword",
19818+
"required": true,
19819+
"schema": {
19820+
"type": "string"
19821+
}
19822+
},
19823+
{
19824+
"description": "Page number, starting from 1.",
19825+
"in": "query",
19826+
"name": "page",
19827+
"required": false,
19828+
"schema": {
19829+
"type": "string"
19830+
}
19831+
},
19832+
{
19833+
"description": "Search ID returned by the first-page response; required when page is greater than 1.",
19834+
"in": "query",
19835+
"name": "searchId",
19836+
"required": false,
19837+
"schema": {
19838+
"default": "",
19839+
"type": "string"
19840+
}
19841+
}
19842+
],
19843+
"responses": {
19844+
"200": {
19845+
"content": {
19846+
"application/json": {
19847+
"schema": {
19848+
"$ref": "#/components/schemas/Result"
19849+
}
19850+
}
19851+
},
19852+
"description": "OK"
19853+
},
19854+
"400": {
19855+
"$ref": "#/components/responses/ResultBadRequestResponse"
19856+
},
19857+
"401": {
19858+
"$ref": "#/components/responses/ResultUnauthorizedResponse"
19859+
},
19860+
"403": {
19861+
"$ref": "#/components/responses/ResultForbiddenResponse"
19862+
},
19863+
"429": {
19864+
"$ref": "#/components/responses/ResultTooManyRequestsResponse"
19865+
},
19866+
"500": {
19867+
"$ref": "#/components/responses/ResultInternalServerErrorResponse"
19868+
}
19869+
},
19870+
"summary": "Product Search",
19871+
"tags": [
19872+
"Xiaohongshu E-commerce (RedNote)"
19873+
],
19874+
"x-api-version": "v1",
19875+
"x-endpoint-family": "xiaohongshu_ec_search_products",
19876+
"x-highlights": [],
19877+
"x-order": "12501000",
19878+
"x-search-aliases": [
19879+
"Xiaohongshu ecommerce product search",
19880+
"RedNote product search",
19881+
"Xiaohongshu marketplace keyword search",
19882+
"小红书电商商品搜索",
19883+
"小红书商城关键词搜索",
19884+
"小红书商品查询"
19885+
]
19886+
}
19887+
},
1971819888
"/api/xiaohongshu-pgy/api/pgy/content_square/search_note_v2/v1": {
1971919889
"get": {
1972019890
"description": "Search Xiaohongshu Pugongying Content Square notes by keyword or browse all notes, with business-category, ranking, time-window, and page controls. Use it to discover high-performing campaign content.",
@@ -25355,6 +25525,27 @@
2535525525
],
2535625526
"x-platform-id": "xiaohongshu-creator-marketplace-pugongying"
2535725527
},
25528+
{
25529+
"description": "Xiaohongshu E-commerce product search for discovering marketplace products by keyword.",
25530+
"name": "Xiaohongshu E-commerce (RedNote)",
25531+
"x-platform-aliases": [
25532+
"Xiaohongshu E-commerce",
25533+
"RedNote E-commerce",
25534+
"Xiaohongshu product search",
25535+
"RedNote product search",
25536+
"小红书电商",
25537+
"小红书商品搜索"
25538+
],
25539+
"x-platform-detection-aliases": [
25540+
"Xiaohongshu E-commerce",
25541+
"RedNote E-commerce",
25542+
"Xiaohongshu product search",
25543+
"RedNote product search",
25544+
"小红书电商",
25545+
"小红书商品搜索"
25546+
],
25547+
"x-platform-id": "xiaohongshu-e-commerce-rednote"
25548+
},
2535825549
{
2535925550
"description": "Xianyu second-hand marketplace listings and details for resale research, seller analysis, and price monitoring.",
2536025551
"name": "Xianyu (GooFish)",
@@ -25727,5 +25918,5 @@
2572725918
"x-platform-id": "1688"
2572825919
}
2572925920
],
25730-
"x-openapi-release-id": "ffd6ee7ddfb6588c"
25921+
"x-openapi-release-id": "6fa69ce241e6a00e"
2573125922
}

0 commit comments

Comments
 (0)