Search Global Products

Retrieve a list of global products that meet the specified conditions. This API will only return the key product properties. You can pass a returned global product ID to the Get Global Product API to obtain more details about the product.

---

For common parameters, refer to How to call TikTok Shop APIs - Common Parameters

• PUBLISHED
• UNPUBLISHED
• DRAFT
• DELETED | seller_skus |[]string |N |["Color-Red-001"] |Filter global products by these seller SKU codes. | create_time_ge |int |N |1694576429 |Filter global products to show only those that are created on or after the specified date and time. Unix timestamp.

Note: The "create_time_ge" and "create_time_le" together constitute the creation time filter condition.

• If "create_time_ge" is filled but "create_time_le" is empty, "create_time_le" will default to the current time.
• If "create_time_le" is filled but "create_time_ge" is empty, "create_time_ge" will default to the earliest shop time. | create_time_le |int |N |1694576429 |Filter global products to show only those that are created on or before the specified date and time. Unix timestamp. Refer to notes in "create_time_ge" for more usage information. | update_time_ge |int |N |1694576429 |Filter global products to show only those that are updated on or after the specified date and time. Unix timestamp.

Note: The fields "update_time_ge" and "update_time_le" together define the update time filter condition.

• If "update_time_ge" is filled but "update_time_le" is empty, "update_time_le" will default to the current time.
• If "update_time_le" is filled but "update_time_ge" is empty, "update_time_ge" will default to the earliest shop time. | update_time_le |int |N |1694576429 |Filter global products to show only those that are updated on or before the specified date and time. Unix timestamp. Refer to notes in update_time_ge for more usage information. |

Query

https://open-api.tiktokglobalshop.com/product/202312/global_products/search?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&page_size=100&page_token=b2Zmc2V0PTAK

Body

{"status":"PUBLISHED","seller_skus":["Color-Red-001"],"create_time_ge":1694576429,"create_time_le":1694576429,"update_time_ge":1694576429,"update_time_le":1694576429}

• PUBLISHED
• UNPUBLISHED
• DRAFT
• DELETED | ^^skus |[]object | |A list of global Stock Keeping Units (SKUs) used to identify distinct variants of the product. | ^^^id |string |1729592969712207012 |The global SKU ID in TikTok Shop. One product can contain multiple SKU IDs. | ^^^seller_sku |string |Color-Red-XM001 |An internal code/name for managing SKUs, not visible to buyers. | ^^create_time |int |1694576429 |The time when the product is created. Unix timestamp. | ^^update_time |int |1694576429 |The time when the product is last updated. Unix timestamp. |

{"code":0,"data":{"next_page_token":"b2Zmc2V0PTAK","total_count":100,"global_products":[{"id":"1729592969712207008","title":"Men's Fashion Sports Low Cut Cotton Breathable Ankle Short Boat Invisible Socks","status":"PUBLISHED","skus":[{"id":"1729592969712207012","seller_sku":"Color-Red-XM001"}],"create_time":1694576429,"update_time":1694576429}]},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

For common error codes, refer to How to call TikTok Shop APIs - Common Error Code