来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存,可追溯
- 官方原文可核对
资料正文
§1 Path: /product/202309/products/{product_id}
#§2 Method: [GET]
#§3 Function Description
Retrieve all properties of a product, except those in the FREEZE or DELETED status.
§4 Common Parameters
For common parameters, refer to How to call TikTok Shop APIs - Common Parameters
| Properties | Location | Type | Require | Sample | Properties description |
|---|---|---|---|---|---|
| shop_cipher | query | string | Y | GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3 | Use this property to pass shop information in requesting the API. Failure in passing the correct value when requesting the API for cross-border shops will return incorrect response. |
| Get by API Get Authorization Shop | |||||
| content-type | header | string | Y | application/json | Allowed type: application/json |
§5 Request Path Parameters
| Properties | Type | Require | Sample | Properties description |
|---|---|---|---|---|
| product_id | string | Y | 1729592969712207008 | The product ID in TikTok Shop. |
§6 Request Query Parameters
| Properties | Type | Require | Sample | Properties description |
|---|---|---|---|---|
| app_key | string | Y | 38abcd | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign | string | Y | 5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp | int | Y | 1623812664 | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
| return_under_review_version | bool | N | true | A flag to indicate what product information to retrieve if a live product (ACTIVATE status) is edited and resent for TikTok Shop review. |
- True: Retrieves the latest version of the product information that is currently under review.
- False: Retrieves a snapshot of the product information that is live and online (before the edit). Default: False | return_draft_version |bool |N |true |A flag to indicate what product information to retrieve if a product has a draft in TikTok Shop.
- True: Retrieves the draft version of the product information.
- False: Retrieves the latest product information. Default: False
Note:
- Applicable only if the product is in the
DRAFT,ACTIVATE,SELLER_DEACTIVATED, orPLATFORM_DEACTIVATEDstatus. - This field and
return_under_review_versionare mutually exclusive. Specify only one to receive results. | locale |string |N |en |The BCP-47 locale codes for displaying category information. Default: The default locale of your shop. Possible values: - cs-CZ
- de-AT
- de-BE
- de-DE
- el-GR
- en-GB
- en-IE
- en-US
- es-ES
- es-MX
- fr-FR
- fr-BE
- hu-HU
- id-ID
- it-IT
- ja-JP
- ms-MY
- nl-NL
- nl-BE
- pl-PL
- pt-BR
- pt-PT
- th-TH
- vi-VN
- zh-CN |
§7 Request Sample
Query
https://open-api.tiktokglobalshop.com/product/202309/products/1729592969712207008?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1625484268&shop_cipher=ROW_RHkDDABBAAB8tKAVoAqsMTjsQZFLyNfY&return_under_review_version=true&return_draft_version=true&locale=en
§8 Response Parameters
| Properties | Type | Sample | Properties description |
|---|---|---|---|
| code | int | 0 | The success or failure status code returned in API response. |
| message | string | Success | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | 202203070749000101890810281E8C70B7 | Request log |
| data | object | Specific return information | |
| ^audit | object | Product audit information. | |
| Note: Applicable only to products listed on TikTok Shop. Not applicable for products listed only on Tokopedia. | |||
| ^^pre_approved_reasons | []string | ["KYC_PENDING"] | The reason why the product is pre-approved. |
Applicable only if audit.status=PRE_APPROVED, otherwise returns an empty array. |
Possible values:
- KYC_PENDING: The seller's onboarding (KYC - Know Your Customer information) is incomplete or awaiting processing.
- RESTRICTED_CATEGORY_PENDING: The product is in a restricted category, and category approval is still pending. To request access, submit an application through the Qualification Center on TikTok Shop Seller Center. Applicable only for the US market. | ^^status |string |AUDITING |The product audit status. Possible values:
- NONE: The product is not applicable for audit because it has not been submitted for listing on this platform, or it is in a draft, frozen, or deactivated state.
- AUDITING: The product is currently being audited.
- FAILED: The product failed the audit, or the audit was cancelled.
- PRE_APPROVED: The product has passed the audit but is not yet listed due to pending prerequisites. Refer to
pre_approved_reasonsfor the prerequisites. - APPROVED: The product passed the audit and has been listed on the platform. | ^^not_submitted_reasons |[]string |["SHOP_INACTIVE"] |The reasons why the product has not been submitted for TikTok Shop audit. Applicable only when
audit.status=NONEand the product cannot be submitted for audit because the shop has not met one or more listing prerequisites; otherwise, an empty array is returned.
Possible values:
- PAYMENT_ACCOUNT_NOT_LINKED: No payment account is linked to the shop.
- SHOP_INACTIVE: The shop is inactive.
- W8_NOT_CONFIGURED: The required W-8 tax information has not been provided for the shop. Applicable only to US shops. | ^audit_failed_reasons |[]object | |TikTok Shop audit failure information. | ^^listing_platform |string |TIKTOK_SHOP |The platform for listing the product. Possible values:
- TIKTOK_SHOP
- TOKOPEDIA | ^^position |string |product |The audit failure reason name. | ^^reasons |[]string |["violate listing rules"] |A brief reason for failing TikTok Shop audit. | ^^suggestions |[]string |["The product violates TikTok Shopping listing rules, please check and resubmit."] |A detailed explanation of the reason for failure. | ^brand |object | |Product brand information. | ^^id |string |7082427311584347905 |The ID of the brand of this product. | ^^name |string |brand xxx aaa |The brand name of this product. | ^category_chains |[]object | |Product category tree information. | ^^id |string |853000 |The ID of the category of this product. | ^^is_leaf |bool |true |A flag to indicate if the category is a leaf category.
Note: You can only create or edit products that belong to a leaf category. |
^^local_name |string |Botol & Stoples Penyimpanan |The name of the category in the country where the shop operates. |
^^parent_id |string |851848 |The parent category ID.
For the root category, the parent ID is 0. |
^certifications |[]object | |The list of certifications for your product. |
^^expiration_date |int |1741235456 |The expiration date of this certification expressed in unix timestamp (seconds) UTC+0. |
^^files |[]object | |A list of certification related files. |
^^^format |string |PDF |The format of the certification file. |
^^^id |string |v09ea0g40000cj91373c77u3mid3g1s0 |The ID of the certification file. |
^^^name |string |CERT_X2.PDF |The name of the certification file. |
^^^urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] | The URLs to view the certification files. |
^^id |string |602362 |The ID to identify the type of certification required for the product. |
^^images |[]object | |A list of certification related images. |
^^^height |int |600 |The image height.
Unit: px |
^^^thumb_urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |The URLs to view the image thumbnails. |
^^^uri |string |tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4 |The URI of the image. |
^^^urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] | The URLs to view the images. |
^^^width |int |600 |The image width.
Unit: px |
^^title |string |SNI Certificate |The title of the certification type. |
^create_time |int |1234567890 |The time when the product is created.
Unix timestamp. |
^delivery_options |[]object | |The custom delivery options applied to this product, overriding the default warehouse delivery option.
Note: This field is not supported in post-live drafts, therefore the values here will always reflect those in the base version, even if you set return_draft_version=true. |
^^id |string |1729592969712203232 |The delivery option ID. |
^^is_available |bool |true |A flag indicating whether the delivery option is available for this product. |
^^name |string |SEND_BY_SELLER |The delivery option name. |
^description |string |
Please compare above detailed size with your measurement before purchase.
- M-Size
- XL-Size
Image |The product description in HTML format. | ^external_product_id |string |172959296971220002 |An external identifier used in an external ecommerce platform. This is used to associate the product between TikTok Shop and the external ecommerce platform. | ^global_product_association |object | |The global product association established through global product publishing or manual binding. Note:
- Applicable for global sellers and intra-EU sellers.
- Not applicable for EU sellers who synchronized products from other markets using the Global Product Replicate (GPR) tool. Refer to
global_listing_policyinstead to find the associated source products. | ^^global_product_id |string |1729592969712207920 |The global product ID in TikTok Shop. | ^^sku_mappings |[]object | |The list of sku mappings between the global and local products. | ^^^global_sku_id |string |1729592969712207234 |The global SKU ID in TikTok Shop. | ^^^local_sku_id |string |1729592969712207230 |The local SKU ID in TikTok Shop. | ^^^sales_attribute_mappings |[]object | |The list of sales attribute mappings between the global and local SKUs. | ^^^^global_attribute_id |string |100000 |The global sales attribute ID. | ^^^^global_value_id |string |1001064 |The global sales attribute value ID. | ^^^^local_attribute_id |string |100000 |The local sales attribute ID. | ^^^^local_value_id |string |1001064 |The local sales attribute value ID. | ^has_draft |bool |true |A flag to indicate if the product has a draft. - true: It has a draft.
- false: It does not have a draft. | ^id |string |1729592969712207008 |The product ID generated by TikTok Shop. | ^integrated_platform_statuses |[]object | |The current status of the product on platforms that are natively integrated with TikTok Shop (e.g. TOKOPEDIA).
Note: For Indonesia sellers, if you did not set the listing platform as TOKOPEDIA when creating or editing a product, this will be omitted. |
^^platform |string |TOKOPEDIA |The integrated platform name.
Possible values:
- TOKOPEDIA | ^^status |string |PLATFORM_DEACTIVATED |The product status in the integrated platform. Possible values:
- DRAFT
- PENDING
- FAILED
- ACTIVATE
- SELLER_DEACTIVATED
- PLATFORM_DEACTIVATED
- FREEZE
- DELETED | ^is_cod_allowed |bool |true |A flag indicating whether to show the Cash On Delivery (COD) payment option during checkout. Applicable only for the following markets:
- Global sellers: MY, PH, SA, TH, VN
- Local sellers: ID, MY, PH, SA, TH, VN | ^is_not_for_sale |bool |true |A flag indicating whether the product is not for sale and only available through Gift with Purchase (GWP) promotions. Such products won't appear in searches or recommendations True: Not for sale False: For sale | ^is_pre_owned |bool |false |A flag to indicate if the product is pre-owned. Applicable only if TOKOPEDIA is the sole listing platform.
Note: Pre-owned products on the TikTok Shop platform are identified by the category_id, which must belong to one of the designated pre-owned product categories (e.g. pre-owned luxury bags, luggage, and accessories). |
^is_replicated |bool |false |A flag to indicate if the product contains a replica (created through local replication) in other local markets. |
^key_product_features |[]string |["Breathable mesh upper", "Cushioned foam midsole"] |Key Product Features. They will be displayed in the Product highlight module on the product detail page and will be used by search engines to increase your search weight for more traffic. The total number of items should not exceed 5, and the total character count should not exceed 1500. |
^listing_quality_tier |string |POOR |The current quality tier of this product listing. The quality tier of a product listing depends on the quality of the content in its product fields such as the title, image, attributes etc.
Possible values:
- POOR
- FAIR
- GOOD
Note: Available only for the US market. |
^main_images |[]object | |A list of images to display in the product image gallery. |
^^height |int |600 |The image height.
Unit: px |
^^thumb_urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |The URLs to view the image thumbnails. |
^^uri |string |tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4 |The URI of the image. |
^^urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |The URLs to view the images.
|
^^width |int |600 |The image width.
Unit: px |
^manufacturer_ids |[]string |["172959296971220002"] |The list of manufacturer IDs.
Pass this value to the manufacturer_id field in the Search Manufacturers API to obtain more information about a manufacturer.
Note: Applicable only for the EU market in certain categories |
^minimum_order_quantity |int |1 |The minimum order quantity for the product.
Valid range: [1, 20]
Applicable only for the Indonesia market and selected sellers in other SEA markets. Contact your account manager for more information about gaining access to this field. |
^package_dimensions |object | |The dimensions of the product package |
^^height |string |10 |The package height. |
^^length |string |10 |The package length. |
^^unit |string |CENTIMETER |The unit for the package dimensions. |
^^width |string |10 |The package width. |
^package_weight |object | |The weight of the product package. |
^^unit |string |KILOGRAM |The unit for the package weight.
Possible values:
KILOGRAMPOUND| ^^value |string |1.32 |The package weight. | ^pod_info |object | |POD customization configuration for an MTO product. This object contains consumer-customizable templates, surfaces, and customization areas for Print-On-Demand products. | ^^pod_templates |[]object | |A list of POD customization templates. Each template represents one customization plan and can be associated with one or more SKUs. | ^^^pod_template_id |string |172959296971220002 |The unique identifier of the POD customization template. | ^^^remark |string |Front side customization template for basic tee |Optional notes or instructions for this customization template. These notes may be used to remind consumers about customization requirements on the customization page. | ^^^sku_ids |[]string |["172959296971220002"] |A list of product SKU IDs associated with this customization template. The same SKU cannot be associated with more than one template. | ^^^surfaces |[]object | |A list of customizable product surfaces under this template, such as the front side, back side, collar, or sleeve. A template can contain up to 10 surfaces. | ^^^^background_image |object | |The background image of the customizable surface. It is usually the base product image on which customization areas are configured. | ^^^^^height |int |600 |The height of the background image, in pixels. | ^^^^^thumb_urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |A list of thumbnail URLs for the background image. | ^^^^^uri |string |tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4 |The URI of the background image. Obtain this URI by uploading the images through the Upload Product Image API withuse_case=CUSTOMIZATION_IM AGE. | ^^^^^urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |A list of URLs for the background image. | ^^^^^width |int |600 |The width of the background image, in pixels. | ^^^^custom_areas |[]object | |A list of customizable areas on this surface. The order of the elements represents the layer order to be used when rendering the final customization preview. A surface can contain up to 10 customization areas. | ^^^^^area_name |string |logo area |The name of the customizable area. | ^^^^^area_placement |object | |The position, size, and rotation information of the customizable area on the surface. | ^^^^^^height |string |200 |The height of the customizable area. Supports two decimal places. | ^^^^^^rotate_degree |string |0 |The rotation angle of the customizable area, in degrees. Supports two decimal places. | ^^^^^^width |string |200 |The width of the customizable area. Supports two decimal places. | ^^^^^^x_coordinate |string |0 |The X-coordinate of the customizable area's starting point on the surface. Supports two decimal places. | ^^^^^^y_coordinate |string |0 |The Y-coordinate of the customizable area's starting point on the surface. Supports two decimal places. | ^^^^^area_type |string |TEXT |The type of the customizable area. Enum values:TEXT,IMAGE. | ^^^^^external_area_id |string |172959296971220002 |The seller-defined external identifier of the customizable area, used for mapping with the seller's own system. | ^^^^^image_area |object | |Configuration for an image-type customization area. This field is returned whenarea_typeisIMAGE. | ^^^^^^default_image |object | |Optional default image displayed in this area. If the consumer does not upload a custom image, the default image may be used. | ^^^^^^^height |int |600 |The height of the default image, in pixels. | ^^^^^^^thumb_urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |A list of thumbnail URLs for the default image. | ^^^^^^^uri |string |tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4 |The URI of the default image. Obtain this URI by uploading the images through the Upload Product Image API withuse_case=CUSTOMIZATION_IM AGE. | ^^^^^^^urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |A list of URLs for the default image. | ^^^^^^^width |int |600 |The width of the default image, in pixels. | ^^^^^^min_height |int |300 |The minimum required height, in pixels, for an image uploaded by the consumer. | ^^^^^^min_width |int |300 |The minimum required width, in pixels, for an image uploaded by the consumer. | ^^^^^is_required |bool |false |Specifies whether the consumer must provide customization content for this area. If set tofalse, the default content or base product version may be used. | ^^^^^text_area |object | |Configuration for a text-type customization area. This field is returned whenarea_typeisTEXT. | ^^^^^^align_type |string |CENTER |The text alignment type. Enum values:LEFT,CENTER,RIGHT. | ^^^^^^colors |[]string |["#FFFFFF"] |A list of text colors available for consumers to choose from, using hexadecimal color values such as#FFFFFF. | ^^^^^^default_text |string |Hello World |Optional default text displayed in this area. If the consumer does not customize this area, the default text may be used. | ^^^^^^fonts |[]string |["Roboto"] |A list of font keys available for consumers to choose from, based on the platform-supported font library. | ^^^^^^max_text_length |int |20 |The maximum number of characters allowed for consumer text input. | ^^^^external_surface_id |string |172959296971220002 |The seller-defined external identifier of the customizable surface, used for mapping with the seller's own system. | ^^^^mask_image |object | |An optional mask image placed above the customization areas to support irregular or cut-out effects. | ^^^^^height |int |600 |The height of the mask image, in pixels. | ^^^^^thumb_urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |A list of thumbnail URLs for the mask image. | ^^^^^uri |string |tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4 |The URI of the mask image. Obtain this URI by uploading the images through the Upload Product Image API withuse_case=CUSTOMIZATION_IM AGE. | ^^^^^urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |A list of URLs for the mask image. | ^^^^^width |int |600 |The width of the mask image, in pixels. | ^^^^surface_name |string |Front Side |The name of the customizable surface, for example,Front SideorBack Side. | ^^^template_name |string |T-Shirt Front Print |The name of the customization template, used by the seller for internal management. | ^prescription_requirement |object | |Prescription related information for the product. Note: Applicable only for Tokopedia. This object is returned for all pharmacy products, and omitted for non-pharmacy products. | ^^needs_prescription |bool |false |A flag to indicate whether a prescription is required to purchase this pharmacy product. | ^primary_combined_product_id |string |1729592969712207008 |If the product is a virtual bundle, this value is the ID of the primary product in the bundle. The value is omitted if the product is not a virtual bundle. | ^product_attributes |[]object | |A list of general attributes (e.g. manufacturer, country of origin, materials used) that describe the product as a whole, regardless of variant. | ^^id |string |100392 |The ID of the product attribute. | ^^name |string |Occasion |The product attribute name. | ^^values |[]object | |A list of selectable values for the product attribute. | ^^^id |string |1001533 |The product attribute value ID. | ^^^name |string |Birthday |The product attribute value name. | ^product_families |[]object | |The live product family that this product belongs to. A product family is a virtual group of products that share common characteristics (such as flavor, version, or size), allowing them to appear as selectable variations on the product page. Note:- Applicable only for US local sellers.
- Omitted if this product does not belong to any product family. | ^^id |string |1000592969712207000 |The product family ID. | ^^products |[]object | |A list of products that belong to the family. | ^^^id |string |1729592969712207008 |The product ID. | ^product_status |string |SELLER_DEACTIVATED |The product status in TikTok Shop unrelated to its audit status. Possible values:
- INITIAL
- DRAFT
- ACTIVATE
- SELLER_DEACTIVATED
- PLATFORM_DEACTIVATED
- FREEZE
- DELETED
Note: For Indonesia sellers, if you did not set the listing platform as TIKTOK_SHOP when creating or editing a product, this will be omitted.
|
^product_tags |[]string |["AUCTION"] |Product tag to identity special type product
Possible values: AUCTION |
^product_types |[]string |["COMBINED_PRODUCT"] |The product type.
Possible values:
- COMBINED_PRODUCT: Indicates this is a virtual bundle product.
- IN_COMBINED_PRODUCT: Indicates this product is part of a virtual bundle.
- GPR_TARGET_PRODUCT: Indicates this product is synchronized to global listings. Applicable only for the EU market. | ^recommended_categories |[]object | |Recommended categories for the product based on the product title, description, and images. | ^^id |string |850003 |The ID of the recommended category. | ^^local_name |string | Botol & Stoples Penyimpanan |The name of the category in the country where the shop operates. | ^responsible_person_ids |[]string |["172959296971220003"] |The list of responsible person IDs. Pass this value to the
responsible_person_idfield in the Search Responsible Persons API to obtain more information about a responsible person.
Note: Applicable only for the EU market in certain categories | ^scheduled_sale |object | |Scheduled listing configuration for the product, including whether scheduled listing is enabled and the scheduled listing time. | ^^is_enabled_scheduled_sale |bool |false |Whether scheduled listing is enabled for this product. If true, scheduled_sale_time must be provided. | ^^schedule_sale_time |int |1768899145000 |Scheduled listing time, expressed as a Unix timestamp in milliseconds; must be later than the current time and within 90 days, and is required when is_enabled_scheduled_sale is true. | ^search_terms |[]string |["sneakers","running shoes","athletic"] |Search terms (ST words). ST words will not be displayed to consumers; they are only used in search engines to increase your search weight and gain more traffic. Please ensure that ST words are consistent with the product description, with a maximum of 15 terms and a total of no more than 250 characters. | ^shipping_insurance_requirement |string |OPTIONAL |The shipping insurance purchase requirement imposed on buyers for the product. Possible values:
- REQUIRED: Shipping insurance is mandatory and buyers can't opt out.
- OPTIONAL: Buyers can choose to purchase shipping insurance through the platform.
- NOT_SUPPORTED: Shipping insurance is not supported for the product. Default: OPTIONAL
Applicable only if the listing platforms include TOKOPEDIA. | ^shipping_template_id |string |7552764259994699538 |Identifier of the shipping template that was bound to the product | ^size_chart |object | |The measurement details of the product to help buyers find the right size. | ^^image |object | |An image of the size chart. | ^^^height |int |600 |The image height. Unit: px | ^^^thumb_urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |The URLs to view the image thumbnails. | ^^^uri |string |tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4 |The URI of the image. | ^^^urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] | The URLs to view the images. | ^^^width |int |600 |The image width. Unit: px | ^^template |object | |A TikTok Shop size chart template generated by the size chart tool in Seller Center > Manage Products > Bulk action > Batch manage size charts. | ^^^id |string |7267563252536723205 |The size chart template ID. | ^skus |[]object | |A list of Stock Keeping Units (SKUs) used to identify distinct variants of the product. | ^^combined_skus |[]object | |If this SKU belongs to a virtual bundle, this object contains the list of individual SKUs that form the bundle (e.g. gift basket, starter pack). | ^^^brand |object | |Brand information of the source product included in the virtual bundle. | ^^^^id |string |7082427311584347905 |The ID of the brand of the source product included in the virtual bundle. | ^^^^name |string |brand xxx aaa |The brand name of the source product included in the virtual bundle. | ^^^categories |[]object | |The category tree information of the source product included in the virtual bundle. | ^^^^id |string |853000 |The ID of the category of the source product included in the virtual bundle. | ^^^^is_leaf |bool |true |A flag to indicate if the category is a leaf category. | ^^^^local_name |string |Botol & Stoples Penyimpanan |The name of the category in the country where the shop operates. | ^^^^parent_id |string |851848 |The parent category ID of the source product included in the virtual bundle. | ^^^combined_listing_not_live_reasons |[]string |["SUB_PRODUCT_DELETE"] |The reasons linked to the source product included in the virtual bundle that are keeping the virtual bundle status from being live. Possible values:
- SUB_PRODUCT_DEACTIVATE: Indicate the source product has been deactivated.
- SUB_PRODUCT_DELETE: Indicate the source product has been deleted.
- SUB_PRODUCT_FROZEN: Indicate the source product has been frozen.
- SUB_SKU_DELETE: Indicate the source SKU has been deleted.
- SUB_PRODUCT_CATEGORY_FIRST_LEVEL_ERROR: Indicate the level one category of the virtual bundle does not match that of the source product.
- SUB_PRODUCT_CATEGORY_OVER_RESTRICTION: Indicate the level one category of the source product is not in the set of restricted categories. | ^^^inventory |[]object | |Source SKU inventory details. | ^^^^quantity |int |999 |The total quantity available in the warehouse of the source SKU. | ^^^^warehouse_id |string |6966568648651605766 |The ID of the warehouse where the source SKU is stored. Retrieve details of the warehouse from the Get Warehouse List API. | ^^^price |object | |Source SKU pricing information. | ^^^^currency |string |USD |The currency. Possible values based on the region:
- BRL: Brazil
- CZK: Czech Republic
- EUR: France, Germany, Ireland, Italy, Spain, Netherlands, Belgium, Austria, Greece, Portugal
- GBP: United Kingdom
- HUF: Hungary
- IDR: Indonesia
- JPY: Japan
- MXN: Mexico
- MYR: Malaysia
- PHP: Philippines
- PLN: Poland
- SGD: Singapore
- THB: Thailand
- USD: United States
- VND: Vietnam | ^^^^sale_price |string |117.5 |All sellers The source SKU's local display price shown on the product page before any discounts. | ^^^^tax_exclusive_price |string |110 |Global sellers The source SKU's local pre-tax price. This excludes any applicable charges such as cross-border shipping costs, taxes, and other fees, and therefore does not appear on the product page.
Note: Tax-exclusive pricing does not apply to JP and US shops using China warehouses, therefore this value is the same as sale_price. | ^^^product_id |string |1729582718312380123 |The ID of the source product included in the virtual bundle. | ^^^product_main_image |object | |The main image of the source product included in the virtual bundle. | ^^^^height |int |600 |The image height. Unit: px | ^^^^thumb_urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |The URLs to view the image thumbnails. | ^^^^uri |string |tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4 |The URI of the image. | ^^^^urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |The URLs to view the images. | ^^^^width |int |600 |The image width. Unit: px | ^^^sales_attributes |[]object | |A list of attributes (e.g. size, color, length) that define the source SKU. | ^^^^id |string |100000 |The sales attribute ID. | ^^^^name |string |Color |The sales attribute name. | ^^^^sku_img |object | |The default/main image for each value (e.g. red) of the primary sales attribute (e.g. color) of the source product. This appears in the product options gallery on TikTok Shop. | ^^^^^height |int |100 |The image height. Unit: px | ^^^^^thumb_urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |The URLs to view the image thumbnails. | ^^^^^uri |string |tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4 |The URI of the image. | ^^^^^urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |The URLs to view the images. | ^^^^^width |int |100 |The image width. Unit: px | ^^^^supplementary_sku_images |[]object | |A list of supplementary images for each value (e.g. red) of the primary sales attribute (e.g. color) to provide multiple views or details of the source product for that attribute value. These appear in the product options gallery on TikTok Shop. Applicable only for the US market. | ^^^^^height |int |100 |The image height. Unit: px | ^^^^^thumb_urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |The URLs to view the image thumbnails. | ^^^^^uri |string |tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4 |The URI of the image. | ^^^^^urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |The URLs to view the images. | ^^^^^width |int |100 |The image width. Unit: px | ^^^^value_id |string |100000 |The sales attribute value ID. | ^^^^value_name |string |Red |The sales attribute value name. | ^^^seller_sku |string |sku_name |An internal code/name for managing the source SKU, not visible to buyers. | ^^^sku_count |int |1 |The quantity of the source SKU included in the virtual bundle. | ^^^sku_id |string |1729582718312380123 |The ID of the source SKU included in the virtual bundle. | ^^^title |string |Short Boat Invisible Socks |The title of the source product included in the virtual bundle. | ^^external_list_prices |[]object | |The SKU list price (e.g. MSRP, RRP) or original price information on external ecommerce platforms. Applicable only for selected sellers in the US market. Note: This value may appear as the strikethrough price on the product page. However, whether the strikethrough price is shown and the amount shown are subject to the audit team's review and decision based on various pricing information. | ^^^amount |string |1 |The price amount. | ^^^currency |string |USD |The currency. Possible values: USD | ^^^source |string |SHOPIFY_COMPARE_AT_PRICE |The external ecommerce platform from which the price is sourced. Possible values:
- SHOPIFY_COMPARE_AT_PRICE: The compare_at_price in Shopify. | ^^external_sku_id |string |1729592969712207234 |An external identifier used in an external ecommerce platform. This is used to associate the SKU between TikTok Shop and the external ecommerce platform. | ^^external_urls |[]string |["https://example.com/path1", "https://example.com/path2"] |A list of URLs for third-party product listing pages where consumers can place orders. | ^^extra_identifier_codes |[]string | ["00012345678905","9780596520687"] |A list of up to 10 additional identifier codes if the SKU belongs to a virtual bundle (containing multiple individual SKUs).
Note: Applicable only for the EU market. | ^^fees |[]object | |The fees required for this product based on TikTok Shop policies. Fees are required only for certain product categories, retrieve the requirements from the Get Category Rules API. | ^^^additional_attribute |string |SINGLE_USE |Possible values for Pfand:
- SINGLE_USE
- REUSABLE
- NOT_APPLICABLE | ^^^amount |string |1.01 |The fee amount. Valid range:
- PFAND: [0.00 - 6300.00] | ^^^type |string |PFAND |The type of fee. Possible values: PFAND | ^^global_listing_policy |object | |Global Product Replicate (GPR) related information if the product is a target for synchronization. Applicable only for the EU market. | ^^^inventory_type |string |SHARED |The type of inventory to synchronize. Possible values:
- SHARED: Inventory Area Sharing
- EXCLUSIVE: Inventory Exclusive | ^^^price_sync |bool |true |A flag indicating whether the product price is synchronized. | ^^^replicate_source |object | |The source global listing product to synchronize from. | ^^^^product_id |string |1729592969712203232 |The ID of the source product. | ^^^^shop_id |string |7295929697122032321 |The shop ID of the source product. | ^^^^sku_id |string |1729592969712203232 |The SKU ID of the source product. | ^^id |string |10001 |The SKU ID generated by TikTok Shop. | ^^identifier_code |object | |A regulated identifier code assigned to a product based on international standardized regulations (e.g. GTIN) to ensure the product is universally identifiable across various platforms and systems. | ^^^code |string |10000000000010 |The identifier code. | ^^^type |string |GTIN |The type of identifier code. Possible values:
- GTIN
- EAN
- UPC
- ISBN
- JAN | ^^inventory |[]object | |SKU inventory details. Note: This field is not supported in post-live drafts. Therefore, the values here will always reflect those in the base version, even if you set
return_draft_version=true. | ^^^backorder_quantity |int |888 |Thebackorder_quantitywill automatically be converted toquantityonce in-stock inventory is sold out. The fulfillment of this inventory follows thehandling_timespecified below. Note: Made-to-order (MTO), pre-order, and custom products cannot be backordered, and thus are incompatible with backorder_quantity. | ^^^handling_time |int |5 |The estimated number of working days needed for a backorder to be shipped. Currently, different warehouses for the same SKU are not allowed to have differenthandling_time| ^^^quantity |int |999 |The total SKU quantity available in the warehouse. Valid range: [1, 99,999]
Note: This quantity specifically refers to the in-stock inventory that can be shipped immediately. | ^^^warehouse_id |string |6966568648651605766 |The ID of the warehouse where the SKU is stored. Retrieve details of the warehouse from the Get Warehouse List API. | ^^list_price |object | |The SKU's list price information that has been verified to be legitimate by the audit team. This is equivalent to the manufacturer's suggested retail price (MSRP), or the recommended retail price (RRP). Applicable only for the US market. Note:
- This field will be empty or display the last verified price if the submitted price fails verification.
- This value may appear as the strikethrough price on the product page. However, whether the strikethrough price is shown and the amount shown are subject to the audit team's review and decision based on various pricing information. | ^^^amount |string |1 |The price amount. | ^^^currency |string |USD |The currency. Possible values: USD | ^^pre_sale |object | |SKU presale information, used to tag a product as a presale product based on its presale type.
If this is not returned, it indicates that the product is a regular non-presale item. | ^^^fulfillment_type |object | |Information about the type of pre-sale order fulfillment and the corresponding timeframe.
handling_duration_daysis for fulfillment with an extended duration.release_dateis for starting fulfillment on a fixed date. | ^^^^handling_duration_days |int |3 |The desired duration for handling a pre-sale order and handing it over to a shipping carrier.
Applicable only for the following regions and pre-sale type: US
MADE_TO_ORDER: Business days, from 3 to 14 days.CUSTOM: Business days, from 3 to 30 days.
UK, EU, SEA, JP, and LATAM
PRE_ORDER: Calendar days, from 3 to 30 days. | ^^^^release_date |int |1619611761 |The date on which the product gets converted into a regular product and becomes available for general purchase. On this date, order handling will also start, changing the status of the order to AWAITING_SHIPMENT.
Applicable only for PRE_ORDER in the US.
Note: This date is a unix timestamp (seconds) based on the seller-selected timezone in Seller Center.
|
^^^type |string |PRE_ORDER |The type of pre-sale.
Possible values based on the region:
US
PRE_ORDER: The product is not yet available or released. Fulfillment can be extended by specifying a release date.MADE_TO_ORDER: The product is produced only after the order is received. Fulfillment can be extended by specifying a duration.CUSTOM: The product requires a fulfillment timeline that exceeds the standard due to other factors. Fulfillment can be extended by specifying a duration.
UK, EU, SEA, JP, and LATAM
PRE_ORDER: The product is not yet available or released. Fulfillment can be extended by specifying a duration. | ^^price |object | |SKU pricing information. | ^^^currency |string |USD |The currency. Possible values based on the region:- BRL: Brazil
- CZK: Czech Republic
- EUR: France, Germany, Ireland, Italy, Spain, Netherlands, Belgium, Austria, Greece, Portugal
- GBP: United Kingdom
- HUF: Hungary
- IDR: Indonesia
- JPY: Japan
- MXN: Mexico
- MYR: Malaysia
- PHP: Philippines
- PLN: Poland
- SGD: Singapore
- THB: Thailand
- USD: United States
- VND: Vietnam | ^^^sale_price |string |117.5 |All sellers The SKU's local display price shown on the product page before any discounts. | ^^^starting_bid_price |string |2 |starting bid price for auction product | ^^^tax_exclusive_price |string |110 |Global sellers The SKU's local pre-tax price. This excludes any applicable charges such as cross-border shipping costs, taxes, and other fees, and therefore does not appear on the product page.
Note: Tax-exclusive pricing does not apply to JP and US shops using China warehouses, therefore this value is the same as sale_price. |
^^^unit_price |string |1 |The unit price of the SKU.
You can display the unit price to facilitate easier price comparisons across different products and packaging sizes.
Applicable only for the EU market.
Note:
- This value is available only if you have defined the elements used to calculate this price when creating the product.
- Unit price = Selling price/(SKU unit count/base unit count) | ^^sales_attributes |[]object | |A list of attributes (e.g. size, color, length) that define each variant of a product. | ^^^id |string |100000 |The sales attribute ID. | ^^^name |string |Color |The sales attribute name. | ^^^sku_img |object | |The default/main image for each value (e.g. red) of the primary sales attribute (e.g. color). This appears in the product options gallery on TikTok Shop. | ^^^^height |int |100 |The image height. Unit: px | ^^^^thumb_urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |The URLs to view the image thumbnails. | ^^^^uri |string |tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4 |The URI of the image. | ^^^^urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |The URLs to view the images. | ^^^^width |int |100 |The image width. Unit: px | ^^^supplementary_sku_images |[]object | |A list of supplementary images for each value (e.g. red) of the primary sales attribute (e.g. color) to provide multiple views or details of the product for that attribute value. These appear in the product options gallery on TikTok Shop.
Applicable only for the US market. | ^^^^height |int |100 |The image height. Unit: px | ^^^^thumb_urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |The URLs to view the image thumbnails. | ^^^^uri |string |tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4 |The URI of the image. | ^^^^urls |[]string |["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"] |The URLs to view the images. | ^^^^width |int |100 |The image width. Unit: px | ^^^value_id |string |100000 |The sales attribute value ID. | ^^^value_name |string |Red |The sales attribute value name. | ^^seller_sku |string |sku name |An internal code/name for managing SKUs, not visible to buyers. | ^^sku_dimensions |object | |The dimensions of the sku. Note:
- Provide the dimensions measured after packing the product.
- These values impact the shipping cost, so it is important to ensure that dimensions are accurate. Any discrepancies in measurements may lead to additional shipping fees.
- Optional for ID, TH, VN regions. | ^^^height |string |10 |The package height. A positive whole number. Note: For the BR market, decimal values using . or , as separators are also accepted but will be rounded to the nearest whole number. | ^^^length |string |10 |The package length. A positive whole number. Note: For the BR market, decimal values using . or , as separators are also accepted but will be rounded to the nearest whole number. | ^^^unit |string |CENTIMETER |The unit for the package dimensions. Possible values based on region:
- US: CENTIMETER, INCH
- Other regions: CENTIMETER
Note: You must use the same system of measurement (metric system or imperial system) for package_weight and package_dimensions. In other words, if you are using KILOGRAM for the weight, you must use CENTIMETER for the dimensions. | ^^^width |string |10 |The package width. A positive whole number. Note: For the BR market, decimal values using . or , as separators are also accepted but will be rounded to the nearest whole number. | ^^sku_unit_count |string |1.00 |The total quantity/volume of the product represented by the SKU. For example, if the SKU represents 500ml of water, this value would be 500 if the unit type is defined as ml. Applicable only for the EU market. Note:
- This is mainly used to calculate the unit price of the SKU, and is required only if you wish to display the unit price to facilitate easier price comparisons across different products and packaging sizes.
- Unit price = Selling price/(SKU unit count/base unit count). Therefore if you want to obtain the unit price, you would also need to define the "base unit count" and the "unit type" product attributes. Retrieve the relevant information for these product attributes by using the Get Attributes API. | ^^sku_weight |object | |The weight of the sku
Note:
- All the products package weight is mandatory by default, except for products under Virtual Products categories.
- Provide the weight measured after packing the product.
- This value impacts the shipping cost, so it is important to ensure that dimensions are accurate. Any discrepancies in measurements may lead to additional shipping fees.
- The package weight will take precedence over package dimensions in fee calculation if the fee based on weight is higher. | ^^^unit |string |KILOGRAM |The unit for the package weight. Possible values based on region:
- US: KILOGRAM, POUND
- BR, JP, MX: KILOGRAM, GRAM
- Other countries: KILOGRAM
Note: You must use the same system of measurement (metric system or imperial system) for package_weight and package_dimensions. In other words, if you are using KILOGRAM for the weight, you must use CENTIMETER for the dimensions. | ^^^value |string |1.32 |The package weight, which must be a positive number. The number format varies based on the unit:
- GRAM: integer
- KILOGRAM: up to 3 decimal places
- POUND: up to 2 decimal places | ^^status_info |object | |Status information of the SKU. | ^^^deactivation_source |string |PLATFORM |The deactivation source of the SKU with
DEACTIVATEDstatus. Possible values: - SELLER: Indicates that the seller deactivated the SKU
- PLATFORM: Indicates that the platform de-activated the SKU due to violation reasons
- COMBO_RELATION: Indicates that the platform de-activated the bundle-SKU due to the deactivation of sub-SKU. | ^^^status |string |DEACTIVATED |The SKU status in TikTok Shop. Possible values:
- NORMAL
- DEACTIVATED | ^^purchase_order_quantity_limit |object | |limit of customer purchase quantity | ^^^maximum_order_quantity |int |2 |The maximum purchase quantity per order for each product variation (SKU). For example: If you set a maximum limit of 2 for a product with 5 variations (SKUs), the customer can purchase up to 2 of each SKU, for a total of 10 items per order. | ^^^cumulative_order_quantity |int |20 |· The total quantity a customer can buy of a product's variations (SKUs) across all orders, while the limit is active. Clearing the limit will reset their past purchases, allowing them to buy again up to the new limit, or without restriction if no limit is set. • For example, if you set a total limit of 2 for a product with 5 variations (SKUs), the customer can buy up to 2 of each SKU, for a total of 10 items across multiple purchases. After that, they can't buy more unless you clear the limits.The total limit must be more than or equal to the maximum limit. | ^status |string |SELLER_DEACTIVATED |The product status in TikTok Shop. This status incorporates both the product status and the audit status. Possible values:
- DRAFT
- PENDING
- FAILED
- ACTIVATE
- SELLER_DEACTIVATED
- PLATFORM_DEACTIVATED
- FREEZE
- DELETED
- SCHEDULED
Note: For Indonesia sellers, if you did not set the listing platform as TIKTOK_SHOP when creating or editing a product, this will be omitted. |
^subscribe_info |object | |All the Save and Subscribe promotion info associated with the given product. |
^^subscribe_discount_details |[]object | |All of the Save and Subscribe discount details. |
^^^discount_level |string |REGULAR |An enum that communicated the type of discount:
- REGULAR
- FIRST_ORDER
- RETENTION | ^^^discount_value |int |10 |The value of the discount. A value of 10, would indicate a 10% discount. | ^^subscribe_promotion_config |[]object | |A subscription configuration specific to the seller. It outlines the different types of promotions and associated constraints that are available for use. | ^^^discount_level |string |REGULAR |An enum that communicated the type of discount:
- REGULAR
- FIRST_ORDER
- RETENTION | ^^^discount_options |[]int |[5, 10, 15, 20] |The discount options available to the seller for the given discount level. | ^^^max_discount |int |90 |The maximum discount a seller can set for the associated discount level. | ^^^min_discount |int |5 |The minimum discount a seller can set for the associated discount level. | ^^subscribe_status |string |ENABLED |An enum outlining whether the given product has an active Subscribe and Save promotion:
- ENABLED
- NOT_ENABLED | ^^support_subscribe |bool |false |A flag outlining whether the seller and given product support Subscribe and Save promotions. | ^title |string |Short Boat Invisible Socks |The product title. | ^update_time |int |1234567899 |The time when the product is last updated. Unix timestamp. | ^video |object | |Product video information. | ^^cover_url |string |https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036 |The URL to view the video cover image. | ^^format |string |MP4 |The video format. | ^^height |int |480 |The video height. Unit: px | ^^id |string |v09ea0g40000cj91373c77u3mid3g1s0 |The video ID. | ^^size |int |1000 |The video's original file size. Unit: MB | ^^url |string |https://v16m-default.akamaized.net/bbae7099581b26cd340beaa7821b2d8c/64de6020/video/tos/alisg/tos-alisg-v-f466fc-sg/oMne9QuzIBN3fIDN7bFCCMbBKuGigg12ghDC8k/?a=0&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=2212&bt=1106&cs=0&ds=3&ft=dl9~j-Inz7TKnfsfiyq8Z&mime_type=video_mp4&qs=13&rc=anR4Ojk6ZmYzbTMzODRmNEBpanR4Ojk6ZmYzbTMzODRmNEBsYWFwcjRva2NgLS1kLy1zYSNsYWFwcjRva2NgLS1kLy1zcw%3D%3D&l=202308171159498F7B108584E58B010932&btag=e00048000 |The URL to view the video. | ^^width |int |1280 |The video width. Unit: px | ^selling_format |string |FIXED_PRICE, LIVE_AUCTION, FIXED_PRICE_AND_LIVE_AUCTION |The product's sale format. Possible values: FIXED_PRICE, LIVE_AUCTION, FIXED_PRICE_AND_LIVE_AUCTION. |
§9 Response Sample
{"code":0,"data":{"audit":{"pre_approved_reasons":["KYC_PENDING"],"status":"AUDITING","not_submitted_reasons":["SHOP_INACTIVE"]},"audit_failed_reasons":[{"listing_platform":"TIKTOK_SHOP","position":"product","reasons":["violate listing rules"],"suggestions":["The product violates TikTok Shopping listing rules, please check and resubmit."]}],"brand":{"id":"7082427311584347905","name":"brand xxx aaa"},"category_chains":[{"id":"853000","is_leaf":true,"local_name":"Botol \u0026 Stoples Penyimpanan","parent_id":"851848"}],"certifications":[{"expiration_date":1741235456,"files":[{"format":"PDF","id":"v09ea0g40000cj91373c77u3mid3g1s0","name":"CERT_X2.PDF","urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"]}],"id":"602362","images":[{"height":600,"thumb_urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"uri":"tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4","urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"width":600}],"title":"SNI Certificate"}],"create_time":1234567890,"delivery_options":[{"id":"1729592969712203232","is_available":true,"name":"SEND_BY_SELLER"}],"description":"\u003cp\u003ePlease compare above detailed size with your measurement before purchase.\u003c/p\u003e\n\u003cul\u003e \n \u003cli\u003eM-Size\u003c/li\u003e\n \u003cli\u003eXL-Size\u003c/li\u003e\n\u003c/ul\u003e \n\u003cimg src=\"https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/181595ea7d26489284b5667488d708c1~tplv-o3syd03w52-origin-jpeg.jpeg?from=1432613627\" /\u003e\n","external_product_id":"172959296971220002","global_product_association":{"global_product_id":"1729592969712207920","sku_mappings":[{"global_sku_id":"1729592969712207234","local_sku_id":"1729592969712207230","sales_attribute_mappings":[{"global_attribute_id":"100000","global_value_id":"1001064","local_attribute_id":"100000","local_value_id":"1001064"}]}]},"has_draft":true,"id":"1729592969712207008","integrated_platform_statuses":[{"platform":"TOKOPEDIA","status":"PLATFORM_DEACTIVATED"}],"is_cod_allowed":true,"is_not_for_sale":true,"is_pre_owned":false,"is_replicated":false,"key_product_features":["Breathable mesh upper","Cushioned foam midsole"],"listing_quality_tier":"POOR","main_images":[{"height":600,"thumb_urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"uri":"tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4","urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"width":600}],"manufacturer_ids":["172959296971220002"],"minimum_order_quantity":1,"package_dimensions":{"height":"10","length":"10","unit":"CENTIMETER","width":"10"},"package_weight":{"unit":"KILOGRAM","value":"1.32"},"pod_info":{"pod_templates":[{"pod_template_id":"172959296971220002","remark":"Front side customization template for basic tee","sku_ids":["172959296971220002"],"surfaces":[{"background_image":{"height":600,"thumb_urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"uri":"tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4","urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"width":600},"custom_areas":[{"area_name":"logo area","area_placement":{"height":"200","rotate_degree":"0","width":"200","x_coordinate":"0","y_coordinate":"0"},"area_type":"TEXT","external_area_id":"172959296971220002","image_area":{"default_image":{"height":600,"thumb_urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"uri":"tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4","urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"width":600},"min_height":300,"min_width":300},"is_required":false,"text_area":{"align_type":"CENTER","colors":["#FFFFFF"],"default_text":"Hello World","fonts":["Roboto"],"max_text_length":20}}],"external_surface_id":"172959296971220002","mask_image":{"height":600,"thumb_urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"uri":"tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4","urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"width":600},"surface_name":"Front Side"}],"template_name":"T-Shirt Front Print"}]},"prescription_requirement":{"needs_prescription":false},"primary_combined_product_id":"1729592969712207008","product_attributes":[{"id":"100392","name":"Occasion","values":[{"id":"1001533","name":"Birthday"}]}],"product_families":[{"id":"1000592969712207000","products":[{"id":"1729592969712207008"}]}],"product_status":"SELLER_DEACTIVATED","product_tags":["AUCTION"],"product_types":["COMBINED_PRODUCT"],"recommended_categories":[{"id":"850003","local_name":"\t\nBotol \u0026 Stoples Penyimpanan"}],"responsible_person_ids":["172959296971220003"],"scheduled_sale":{"is_enabled_scheduled_sale":false,"schedule_sale_time":1768899145000},"search_terms":["sneakers","running shoes","athletic"],"shipping_insurance_requirement":"OPTIONAL","shipping_template_id":"7552764259994699538","size_chart":{"image":{"height":600,"thumb_urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"uri":"tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4","urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"width":600},"template":{"id":"7267563252536723205"}},"skus":[{"combined_skus":[{"brand":{"id":"7082427311584347905","name":"brand xxx aaa"},"categories":[{"id":"853000","is_leaf":true,"local_name":"Botol \u0026 Stoples Penyimpanan","parent_id":"851848"}],"combined_listing_not_live_reasons":["SUB_PRODUCT_DELETE"],"inventory":[{"quantity":999,"warehouse_id":"6966568648651605766"}],"price":{"currency":"USD","sale_price":"117.5","tax_exclusive_price":"110"},"product_id":"1729582718312380123","product_main_image":{"height":600,"thumb_urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"uri":"tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4","urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"width":600},"sales_attributes":[{"id":"100000","name":"Color","sku_img":{"height":100,"thumb_urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"uri":"tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4","urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"width":100},"supplementary_sku_images":[{"height":100,"thumb_urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"uri":"tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4","urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"width":100}],"value_id":"100000","value_name":"Red"}],"seller_sku":"sku_name","sku_count":1,"sku_id":"1729582718312380123","title":"Short Boat Invisible Socks"}],"external_list_prices":[{"amount":"1","currency":"USD","source":"SHOPIFY_COMPARE_AT_PRICE"}],"external_sku_id":"1729592969712207234","external_urls":["https://example.com/path1","https://example.com/path2"],"extra_identifier_codes":["00012345678905","9780596520687"],"fees":[{"additional_attribute":"SINGLE_USE","amount":"1.01","type":"PFAND"}],"global_listing_policy":{"inventory_type":"SHARED","price_sync":true,"replicate_source":{"product_id":"1729592969712203232","shop_id":"7295929697122032321","sku_id":"1729592969712203232"}},"id":"10001","identifier_code":{"code":"10000000000010","type":"GTIN"},"inventory":[{"backorder_quantity":888,"handling_time":5,"quantity":999,"warehouse_id":"6966568648651605766"}],"list_price":{"amount":"1","currency":"USD"},"pre_sale":{"fulfillment_type":{"handling_duration_days":3,"release_date":1619611761},"type":"PRE_ORDER"},"price":{"currency":"USD","sale_price":"117.5","starting_bid_price":"2","tax_exclusive_price":"110","unit_price":"1"},"sales_attributes":[{"id":"100000","name":"Color","sku_img":{"height":100,"thumb_urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"uri":"tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4","urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"width":100},"supplementary_sku_images":[{"height":100,"thumb_urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"uri":"tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4","urls":["https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036"],"width":100}],"value_id":"100000","value_name":"Red"}],"seller_sku":"sku name","sku_dimensions":{"height":"10","length":"10","unit":"CENTIMETER","width":"10"},"sku_unit_count":"1.00","sku_weight":{"unit":"KILOGRAM","value":"1.32"},"status_info":{"deactivation_source":"PLATFORM","status":"DEACTIVATED"},"purchase_order_quantity_limit":{"maximum_order_quantity":2,"cumulative_order_quantity":20}}],"status":"SELLER_DEACTIVATED","subscribe_info":{"subscribe_discount_details":[{"discount_level":"REGULAR","discount_value":10}],"subscribe_promotion_config":[{"discount_level":"REGULAR","discount_options":[5,10,15,20],"max_discount":90,"min_discount":5}],"subscribe_status":"ENABLED","support_subscribe":false},"title":"Short Boat Invisible Socks","update_time":1234567899,"video":{"cover_url":"https://p16-oec-va.ibyteimg.com/tos-maliva-i-o3syd03w52-us/6c8519a3663a4d728c4e3c131dc914b4~tplv-o3syd03w52-resize-jpeg:300:300.jpeg?from=522366036","format":"MP4","height":480,"id":"v09ea0g40000cj91373c77u3mid3g1s0","size":1000,"url":"https://v16m-default.akamaized.net/bbae7099581b26cd340beaa7821b2d8c/64de6020/video/tos/alisg/tos-alisg-v-f466fc-sg/oMne9QuzIBN3fIDN7bFCCMbBKuGigg12ghDC8k/?a=0\u0026ch=0\u0026cr=0\u0026dr=0\u0026er=0\u0026lr=default\u0026cd=0%7C0%7C0%7C0\u0026br=2212\u0026bt=1106\u0026cs=0\u0026ds=3\u0026ft=dl9~j-Inz7TKnfsfiyq8Z\u0026mime_type=video_mp4\u0026qs=13\u0026rc=anR4Ojk6ZmYzbTMzODRmNEBpanR4Ojk6ZmYzbTMzODRmNEBsYWFwcjRva2NgLS1kLy1zYSNsYWFwcjRva2NgLS1kLy1zcw%3D%3D\u0026l=202308171159498F7B108584E58B010932\u0026btag=e00048000","width":1280},"selling_format":"FIXED_PRICE, LIVE_AUCTION, FIXED_PRICE_AND_LIVE_AUCTION"},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}
§10 Error Code
For common error codes, refer to How to call TikTok Shop APIs - Common Error Code
| Code | Message |
|---|---|
| 12019150 | The product ID does not exist. |
| 12052032 | The product does not exist |
| 12052048 | You cannot edit the specified product(s) as it isn't listed in your account or shop. |
| 12052260 | The product ID does not exist |
| 12052547 | There is no version of this product that is under review. Please obtain the online version. |
| 12052704 | seller id not exist |
| 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. |
| 12052901 | The product in its current status is not available for this operation. Change the product status and try again. |
