diff --git a/justoneapi/generated/resources/douyin_ec.py b/justoneapi/generated/resources/douyin_ec.py index 9a1a6f4a..f5c6b7c5 100644 --- a/justoneapi/generated/resources/douyin_ec.py +++ b/justoneapi/generated/resources/douyin_ec.py @@ -29,6 +29,46 @@ def get_item_detail_v1( }, ) + def get_item_detail_v2( + self, + *, + item_id: str, + ) -> ApiResponse[Any]: + """ + Item Details + + Get Douyin E-commerce item details with sales data for product monitoring, competitive analysis, and ecommerce research. + + Args: + item_id: The unique ID of the item on Douyin E-commerce. + """ + return self._get( + "/api/douyin-ec/get-item-detail/v2", + { + "itemId": item_id, + }, + ) + + def get_item_sku_info_v1( + self, + *, + item_id: str, + ) -> ApiResponse[Any]: + """ + Product SKU Info + + Get Douyin E-commerce product SKU data, including SKU options, price, and stock signals, for catalog checks and product monitoring. + + Args: + item_id: The unique ID of the item on Douyin E-commerce. + """ + return self._get( + "/api/douyin-ec/get-item-sku-info/v1", + { + "itemId": item_id, + }, + ) + def search_item_list_v1( self, *, @@ -77,3 +117,26 @@ def get_item_comments_v1( "page": page, }, ) + + def get_shop_item_list_v1( + self, + *, + shop_id: str, + page: str | None = None, + ) -> ApiResponse[Any]: + """ + Shop Product List + + Get Douyin E-commerce shop product list data, including products and pagination signals, for seller research and catalog tracking. + + Args: + shop_id: The unique ID of the shop on Douyin E-commerce. + page: Page number for pagination. + """ + return self._get( + "/api/douyin-ec/get-shop-item-list/v1", + { + "shopId": shop_id, + "page": page, + }, + ) diff --git a/justoneapi/generated/resources/douyin_xingtu.py b/justoneapi/generated/resources/douyin_xingtu.py index f83bbfbe..48ac4bff 100644 --- a/justoneapi/generated/resources/douyin_xingtu.py +++ b/justoneapi/generated/resources/douyin_xingtu.py @@ -606,6 +606,26 @@ def gw_api_gauthor_get_author_content_hot_keywords_v1( }, ) + def gw_api_gauthor_author_get_business_card_info_v1( + self, + *, + o_author_id: str, + ) -> ApiResponse[Any]: + """ + Creator Business Card + + Get Douyin Creator Marketplace (Xingtu) creator Business Card data, including business-card profile fields, for creator lookup, vetting, and campaign qualification. + + Args: + o_author_id: Author's unique ID. + """ + return self._get( + "/api/douyin-xingtu/gw/api/gauthor/author_get_business_card_info/v1", + { + "oAuthorId": o_author_id, + }, + ) + def gw_api_aggregator_get_author_commerce_spread_info_v1( self, *, diff --git a/justoneapi/generated/resources/taobao.py b/justoneapi/generated/resources/taobao.py index 68fdf461..73eaf1f0 100644 --- a/justoneapi/generated/resources/taobao.py +++ b/justoneapi/generated/resources/taobao.py @@ -219,6 +219,26 @@ def get_shop_item_list_v3( }, ) + def get_item_sale_v1( + self, + *, + item_id: str, + ) -> ApiResponse[Any]: + """ + Product Sales + + Get Taobao and Tmall product sales data for sales tracking, product research, and ecommerce monitoring. + + Args: + item_id: AUnique product identifier on Taobao/Tmall (item ID). + """ + return self._get( + "/api/taobao/get-item-sale/v1", + { + "itemId": item_id, + }, + ) + def search_item_list_v1( self, *, diff --git a/openapi/public-api.json b/openapi/public-api.json index 5ac02053..9683024d 100644 --- a/openapi/public-api.json +++ b/openapi/public-api.json @@ -1554,6 +1554,7 @@ }, "/api/douyin-ec/get-item-detail/v1": { "get": { + "deprecated": true, "description": "Get Douyin E-commerce item details, including price, title, and stock, for product monitoring and competitive analysis.", "operationId": "getApiDouyinEcGetItemDetailV1", "parameters": [ @@ -1597,6 +1598,155 @@ "x-order": "14502000" } }, + "/api/douyin-ec/get-item-detail/v2": { + "get": { + "description": "Get Douyin E-commerce item details with sales data for product monitoring, competitive analysis, and ecommerce research.", + "operationId": "getApiDouyinEcGetItemDetailV2", + "parameters": [ + { + "description": "Access token for this API service.", + "in": "query", + "name": "token", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "The unique ID of the item on Douyin E-commerce.", + "in": "query", + "name": "itemId", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "summary": "Item Details", + "tags": [ + "Douyin E-commerce" + ], + "x-api-version": "v2", + "x-highlights": [ + { + "content": "This endpoint includes product sales data.", + "type": "tip" + } + ], + "x-order": "14502025" + } + }, + "/api/douyin-ec/get-item-sku-info/v1": { + "get": { + "description": "Get Douyin E-commerce product SKU data, including SKU options, price, and stock signals, for catalog checks and product monitoring.", + "operationId": "getApiDouyinEcGetItemSkuInfoV1", + "parameters": [ + { + "description": "Access token for this API service.", + "in": "query", + "name": "token", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "The unique ID of the item on Douyin E-commerce.", + "in": "query", + "name": "itemId", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "summary": "Product SKU Info", + "tags": [ + "Douyin E-commerce" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "14502035" + } + }, + "/api/douyin-ec/get-shop-item-list/v1": { + "get": { + "description": "Get Douyin E-commerce shop product list data, including products and pagination signals, for seller research and catalog tracking.", + "operationId": "getApiDouyinEcGetShopItemListV1", + "parameters": [ + { + "description": "Access token for this API service.", + "in": "query", + "name": "token", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "The unique ID of the shop on Douyin E-commerce.", + "in": "query", + "name": "shopId", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "Page number for pagination.", + "in": "query", + "name": "page", + "required": false, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "summary": "Shop Product List", + "tags": [ + "Douyin E-commerce" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "14502150" + } + }, "/api/douyin-ec/search-item-list/v1": { "get": { "description": "Get Douyin E-commerce product Search data, including matched items and product metadata, for product discovery, catalog research, and market monitoring.", @@ -4383,6 +4533,51 @@ "x-order": "15002800" } }, + "/api/douyin-xingtu/gw/api/gauthor/author_get_business_card_info/v1": { + "get": { + "description": "Get Douyin Creator Marketplace (Xingtu) creator Business Card data, including business-card profile fields, for creator lookup, vetting, and campaign qualification.", + "operationId": "getApiDouyinXingtuGwApiGauthorAuthorGetBusinessCardInfoV1", + "parameters": [ + { + "description": "User authentication token.", + "in": "query", + "name": "token", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "Author's unique ID.", + "in": "query", + "name": "oAuthorId", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "summary": "Creator Business Card", + "tags": [ + "Douyin Creator Marketplace (Xingtu)" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "15003075" + } + }, "/api/douyin-xingtu/gw/api/gauthor/get_author_content_hot_keywords/v1": { "get": { "description": "Get Douyin Creator Marketplace (Xingtu) kOL Content Keyword Analysis data, including core metrics, trend signals, and performance indicators, for content theme analysis and creator positioning research.", @@ -8244,6 +8439,51 @@ "x-order": "11001400" } }, + "/api/taobao/get-item-sale/v1": { + "get": { + "description": "Get Taobao and Tmall product sales data for sales tracking, product research, and ecommerce monitoring.", + "operationId": "getApiTaobaoGetItemSaleV1", + "parameters": [ + { + "description": "Access token for this API service.", + "in": "query", + "name": "token", + "required": true, + "schema": { + "type": "string" + } + }, + { + "description": "AUnique product identifier on Taobao/Tmall (item ID).", + "in": "query", + "name": "itemId", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "summary": "Product Sales", + "tags": [ + "Taobao and Tmall" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "11001850" + } + }, "/api/taobao/get-shop-item-list/v1": { "get": { "description": "Get Taobao and Tmall shop Product List data, including item titles, prices, and images, for seller research and catalog tracking.", diff --git a/openapi/public-api.normalized.json b/openapi/public-api.normalized.json index e676609e..2a1a4a99 100644 --- a/openapi/public-api.normalized.json +++ b/openapi/public-api.normalized.json @@ -1586,6 +1586,7 @@ }, "/api/douyin-ec/get-item-detail/v1": { "get": { + "deprecated": true, "description": "Get Douyin E-commerce item details, including price, title, and stock, for product monitoring and competitive analysis.", "operationId": "getApiDouyinEcGetItemDetailV1", "parameters": [ @@ -1629,6 +1630,156 @@ "x-sdk-resource": "douyin_ec" } }, + "/api/douyin-ec/get-item-detail/v2": { + "get": { + "description": "Get Douyin E-commerce item details with sales data for product monitoring, competitive analysis, and ecommerce research.", + "operationId": "getApiDouyinEcGetItemDetailV2", + "parameters": [ + { + "description": "The unique ID of the item on Douyin E-commerce.", + "in": "query", + "name": "itemId", + "required": true, + "schema": { + "type": "string" + }, + "x-sdk-python-name": "item_id" + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "security": [ + { + "tokenAuth": [] + } + ], + "summary": "Item Details", + "tags": [ + "Douyin E-commerce" + ], + "x-api-version": "v2", + "x-highlights": [ + { + "content": "This endpoint includes product sales data.", + "type": "tip" + } + ], + "x-order": "14502025", + "x-sdk-class-name": "DouyinEcResource", + "x-sdk-method-name": "get_item_detail_v2", + "x-sdk-resource": "douyin_ec" + } + }, + "/api/douyin-ec/get-item-sku-info/v1": { + "get": { + "description": "Get Douyin E-commerce product SKU data, including SKU options, price, and stock signals, for catalog checks and product monitoring.", + "operationId": "getApiDouyinEcGetItemSkuInfoV1", + "parameters": [ + { + "description": "The unique ID of the item on Douyin E-commerce.", + "in": "query", + "name": "itemId", + "required": true, + "schema": { + "type": "string" + }, + "x-sdk-python-name": "item_id" + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "security": [ + { + "tokenAuth": [] + } + ], + "summary": "Product SKU Info", + "tags": [ + "Douyin E-commerce" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "14502035", + "x-sdk-class-name": "DouyinEcResource", + "x-sdk-method-name": "get_item_sku_info_v1", + "x-sdk-resource": "douyin_ec" + } + }, + "/api/douyin-ec/get-shop-item-list/v1": { + "get": { + "description": "Get Douyin E-commerce shop product list data, including products and pagination signals, for seller research and catalog tracking.", + "operationId": "getApiDouyinEcGetShopItemListV1", + "parameters": [ + { + "description": "The unique ID of the shop on Douyin E-commerce.", + "in": "query", + "name": "shopId", + "required": true, + "schema": { + "type": "string" + }, + "x-sdk-python-name": "shop_id" + }, + { + "description": "Page number for pagination.", + "in": "query", + "name": "page", + "required": false, + "schema": { + "type": "string" + }, + "x-sdk-python-name": "page" + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "security": [ + { + "tokenAuth": [] + } + ], + "summary": "Shop Product List", + "tags": [ + "Douyin E-commerce" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "14502150", + "x-sdk-class-name": "DouyinEcResource", + "x-sdk-method-name": "get_shop_item_list_v1", + "x-sdk-resource": "douyin_ec" + } + }, "/api/douyin-ec/search-item-list/v1": { "get": { "description": "Get Douyin E-commerce product Search data, including matched items and product metadata, for product discovery, catalog research, and market monitoring.", @@ -4467,6 +4618,51 @@ "x-sdk-resource": "douyin_xingtu" } }, + "/api/douyin-xingtu/gw/api/gauthor/author_get_business_card_info/v1": { + "get": { + "description": "Get Douyin Creator Marketplace (Xingtu) creator Business Card data, including business-card profile fields, for creator lookup, vetting, and campaign qualification.", + "operationId": "getApiDouyinXingtuGwApiGauthorAuthorGetBusinessCardInfoV1", + "parameters": [ + { + "description": "Author's unique ID.", + "in": "query", + "name": "oAuthorId", + "required": true, + "schema": { + "type": "string" + }, + "x-sdk-python-name": "o_author_id" + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "security": [ + { + "tokenAuth": [] + } + ], + "summary": "Creator Business Card", + "tags": [ + "Douyin Creator Marketplace (Xingtu)" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "15003075", + "x-sdk-class-name": "DouyinXingtuResource", + "x-sdk-method-name": "gw_api_gauthor_author_get_business_card_info_v1", + "x-sdk-resource": "douyin_xingtu" + } + }, "/api/douyin-xingtu/gw/api/gauthor/get_author_content_hot_keywords/v1": { "get": { "description": "Get Douyin Creator Marketplace (Xingtu) kOL Content Keyword Analysis data, including core metrics, trend signals, and performance indicators, for content theme analysis and creator positioning research.", @@ -8392,6 +8588,51 @@ "x-sdk-resource": "taobao" } }, + "/api/taobao/get-item-sale/v1": { + "get": { + "description": "Get Taobao and Tmall product sales data for sales tracking, product research, and ecommerce monitoring.", + "operationId": "getApiTaobaoGetItemSaleV1", + "parameters": [ + { + "description": "AUnique product identifier on Taobao/Tmall (item ID).", + "in": "query", + "name": "itemId", + "required": true, + "schema": { + "type": "string" + }, + "x-sdk-python-name": "item_id" + } + ], + "responses": { + "200": { + "content": { + "*/*": { + "schema": { + "$ref": "#/components/schemas/Result" + } + } + }, + "description": "OK" + } + }, + "security": [ + { + "tokenAuth": [] + } + ], + "summary": "Product Sales", + "tags": [ + "Taobao and Tmall" + ], + "x-api-version": "v1", + "x-highlights": [], + "x-order": "11001850", + "x-sdk-class-name": "TaobaoResource", + "x-sdk-method-name": "get_item_sale_v1", + "x-sdk-resource": "taobao" + } + }, "/api/taobao/get-shop-item-list/v1": { "get": { "description": "Get Taobao and Tmall shop Product List data, including item titles, prices, and images, for seller research and catalog tracking.",