---
title: "TikTok Shop Product Search API (V1)"
description: "Searches TikTok Shop products by keyword within a selected region, with offset and page-token pagination. Use it to discover regional products and continue through search results."
aiUsagePrompt: true
---

# TikTok Shop Product Search API \(V1\)

<ApiTester
  method="GET"
  :path='JSON.parse("\"/api/tiktok-shop/search-products/v1\"")'
  :summary='JSON.parse("\"Product Search (V1)\"")'
  openapiDefinitionUrl="https://docs.justoneapi.com/openapi/tiktok-shop/product-search-v1-en.json"
  openapiVersion="3.1.0"
  :parameters='JSON.parse("[{\"name\":\"token\",\"in\":\"query\",\"description\":\"Authentication token for this API service.\",\"required\":true,\"schema\":{\"type\":\"string\"}},{\"name\":\"keyword\",\"in\":\"query\",\"description\":\"Search keyword.\",\"required\":true,\"schema\":{\"type\":\"string\"}},{\"name\":\"region\",\"in\":\"query\",\"description\":\"Target region for product search.\\n\\nAvailable Values:\\n- `US`: United States\\n- `GB`: United Kingdom\\n- `FR`: France\\n- `SG`: Singapore\\n- `MY`: Malaysia\\n- `PH`: Philippines\\n- `TH`: Thailand\\n- `VN`: Vietnam\\n- `ID`: Indonesia\",\"required\":false,\"schema\":{\"type\":\"string\",\"default\":\"US\",\"description\":\"TikTok Shop Enum\",\"enum\":[\"US\",\"GB\",\"FR\",\"SG\",\"MY\",\"PH\",\"TH\",\"VN\",\"ID\"]}},{\"name\":\"offset\",\"in\":\"query\",\"description\":\"Search result offset.\",\"required\":false,\"schema\":{\"type\":\"integer\",\"format\":\"int32\",\"default\":0}},{\"name\":\"pageToken\",\"in\":\"query\",\"description\":\"Pagination token for the next page.\",\"required\":false,\"schema\":{\"type\":\"string\"}}]")'
  :requestBody='JSON.parse("null")'
  :responses='JSON.parse("{\"200\":{\"description\":\"OK\",\"content\":{\"application/json\":{\"schema\":{\"if\":{\"properties\":{\"code\":{\"const\":0}},\"required\":[\"code\"]},\"then\":{\"properties\":{\"data\":{\"type\":\"object\",\"description\":\"TikTok Shop search result and its reported status.\",\"properties\":{\"code\":{\"type\":\"integer\",\"description\":\"Inner status code reported by TikTok Shop.\"},\"message\":{\"type\":\"string\",\"description\":\"Inner status message reported by TikTok Shop.\"},\"data\":{\"type\":\"object\",\"description\":\"Products, shops and search metadata returned for this page.\",\"properties\":{\"has_more\":{\"type\":\"boolean\",\"description\":\"Whether the response reports more search results.\"},\"load_more_params\":{\"type\":\"object\",\"description\":\"Continuation parameters returned for the next search request.\",\"properties\":{\"offset\":{\"type\":\"integer\",\"description\":\"Offset returned for the next page. Pass it as offset with the same keyword and region.\"},\"page_token\":{\"type\":\"string\",\"description\":\"Opaque token returned for continuing the search. Pass it unchanged as pageToken with the returned offset.\"}}},\"products\":{\"type\":\"array\",\"description\":\"Product entries returned on this search page.\",\"items\":{\"type\":\"object\",\"description\":\"One product in the search results.\",\"properties\":{\"product_id\":{\"type\":\"string\",\"description\":\"TikTok Shop product identifier returned as text.\"},\"title\":{\"type\":\"string\",\"description\":\"Title returned for the product listing.\"},\"product_price_info\":{\"type\":\"object\",\"description\":\"Price information returned with the product listing.\",\"properties\":{\"price_prefix\":{\"type\":\"string\",\"description\":\"Optional text displayed before the returned price.\"},\"sku_id\":{\"type\":\"string\",\"description\":\"Identifier reported for the SKU associated with this price.\"},\"symbol_position\":{\"type\":\"integer\",\"description\":\"Position code reported for the currency symbol.\"},\"show_currency_space\":{\"type\":\"boolean\",\"description\":\"Whether the price format calls for a currency space.\"},\"currency_show_mode\":{\"type\":\"integer\",\"description\":\"Currency display mode code reported with the price.\"},\"currency_name\":{\"type\":\"string\",\"description\":\"Currency identifier reported with the price.\"},\"currency_symbol\":{\"type\":\"string\",\"description\":\"Currency symbol reported with the price.\"},\"sale_price_decimal\":{\"type\":\"string\",\"description\":\"Sale price amount returned as decimal text.\"},\"sale_price_format\":{\"type\":\"string\",\"description\":\"Formatted sale price display text.\"},\"single_product_price_format\":{\"type\":\"string\",\"description\":\"Formatted display text for the single-product price.\"},\"single_product_price_decimal\":{\"type\":\"string\",\"description\":\"Single-product price amount returned as decimal text.\"},\"sale_price_integer_part_format\":{\"type\":\"string\",\"description\":\"Formatted integer part of the displayed sale price.\"},\"sale_price_decimal_part_format\":{\"type\":\"string\",\"description\":\"Formatted decimal part of the displayed sale price.\"},\"decimal_point_symbol\":{\"type\":\"string\",\"description\":\"Decimal separator reported for the price format.\"},\"promotion_deduction_details\":{\"type\":\"object\",\"description\":\"Promotion deduction information returned with the price.\",\"properties\":{\"seller_subtotal_deduction\":{\"type\":\"string\",\"description\":\"Displayed seller subtotal deduction reported with the promotion.\"},\"seller_subtotal_deduction_decimal\":{\"type\":\"string\",\"description\":\"Seller subtotal deduction amount returned as decimal text.\"}}},\"raw_origin_price_decimal\":{\"type\":\"string\",\"description\":\"Raw original-price amount reported as decimal text.\"},\"raw_origin_price_format\":{\"type\":\"string\",\"description\":\"Formatted display text for the raw original price.\"},\"origin_price_decimal\":{\"type\":\"string\",\"description\":\"Original-price amount returned as decimal text, when provided.\"},\"origin_price_format\":{\"type\":\"string\",\"description\":\"Formatted display text for the reported original price.\"},\"discount_format\":{\"type\":\"string\",\"description\":\"Formatted discount display text.\"},\"discount_decimal\":{\"type\":\"string\",\"description\":\"Discount value returned as decimal text.\"},\"reduce_price_format\":{\"type\":\"string\",\"description\":\"Formatted display text for the reported price reduction.\"}}},\"rate_info\":{\"type\":\"object\",\"description\":\"Rating information returned for the product, when available.\",\"properties\":{\"score\":{\"type\":\"number\",\"description\":\"Rating score reported as a number.\"},\"review_count\":{\"type\":\"string\",\"description\":\"Review count reported as display text.\"}}},\"sold_info\":{\"type\":\"object\",\"description\":\"Sales count information returned for the listing.\",\"properties\":{\"sold_count\":{\"type\":\"integer\",\"description\":\"Sold count reported for the product.\"}}},\"brand_info\":{\"type\":\"object\",\"description\":\"Brand information returned for the product, when available.\",\"properties\":{\"brand_name\":{\"type\":\"string\",\"description\":\"Brand name reported for the product.\"}}},\"seo_url\":{\"type\":\"object\",\"description\":\"Product page link metadata returned with the listing.\",\"properties\":{\"canonical_url\":{\"type\":\"string\",\"description\":\"Canonical product page URL returned for the listing.\"},\"slug\":{\"type\":\"string\",\"description\":\"Product page slug returned with the canonical link.\"}}},\"seller_info\":{\"type\":\"object\",\"description\":\"Seller information returned with the product.\",\"properties\":{\"seller_id\":{\"type\":\"string\",\"description\":\"TikTok Shop seller identifier returned as text.\"},\"shop_name\":{\"type\":\"string\",\"description\":\"Display name returned for the shop.\"},\"store_blueV_label\":{\"type\":\"object\",\"description\":\"Blue verification badge artwork reported for the shop.\",\"properties\":{\"label_image_light\":{\"type\":\"object\",\"description\":\"Verification badge artwork for the light display.\",\"properties\":{\"height\":{\"type\":\"integer\",\"description\":\"Reported image height.\"},\"width\":{\"type\":\"integer\",\"description\":\"Reported image width.\"},\"uri\":{\"type\":\"string\",\"description\":\"Image URI returned with the image information.\"},\"url_list\":{\"type\":\"array\",\"description\":\"Available URLs returned for the image.\",\"items\":{\"type\":\"string\",\"description\":\"One URL returned for the image.\"}}}},\"label_image_dark\":{\"type\":\"object\",\"description\":\"Verification badge artwork for the dark display.\",\"properties\":{\"height\":{\"type\":\"integer\",\"description\":\"Reported image height.\"},\"width\":{\"type\":\"integer\",\"description\":\"Reported image width.\"},\"uri\":{\"type\":\"string\",\"description\":\"Image URI returned with the image information.\"},\"url_list\":{\"type\":\"array\",\"description\":\"Available URLs returned for the image.\",\"items\":{\"type\":\"string\",\"description\":\"One URL returned for the image.\"}}}}}},\"shop_logo\":{\"type\":\"object\",\"description\":\"Shop logo image information.\",\"properties\":{\"height\":{\"type\":\"integer\",\"description\":\"Reported image height.\"},\"width\":{\"type\":\"integer\",\"description\":\"Reported image width.\"},\"uri\":{\"type\":\"string\",\"description\":\"Image URI returned with the image information.\"},\"url_list\":{\"type\":\"array\",\"description\":\"Available URLs returned for the image.\",\"items\":{\"type\":\"string\",\"description\":\"One URL returned for the image.\"}}}}}},\"sku_info\":{\"type\":\"array\",\"description\":\"SKU price entries returned for this product.\",\"items\":{\"type\":\"object\",\"description\":\"One SKU price entry for this product.\",\"properties\":{\"SkuId\":{\"type\":\"string\",\"description\":\"SKU identifier returned for the price entry.\"},\"PriceInfo\":{\"type\":\"object\",\"description\":\"Price information returned for the SKU.\",\"properties\":{\"sku_id\":{\"type\":\"string\",\"description\":\"Identifier reported for the SKU associated with this price.\"},\"symbol_position\":{\"type\":\"integer\",\"description\":\"Position code reported for the currency symbol.\"},\"show_currency_space\":{\"type\":\"boolean\",\"description\":\"Whether the price format calls for a currency space.\"},\"currency_show_mode\":{\"type\":\"integer\",\"description\":\"Currency display mode code reported with the price.\"},\"currency_name\":{\"type\":\"string\",\"description\":\"Currency identifier reported with the price.\"},\"currency_symbol\":{\"type\":\"string\",\"description\":\"Currency symbol reported with the price.\"},\"sale_price_decimal\":{\"type\":\"string\",\"description\":\"Sale price amount returned as decimal text.\"},\"sale_price_format\":{\"type\":\"string\",\"description\":\"Formatted sale price display text.\"},\"single_product_price_format\":{\"type\":\"string\",\"description\":\"Formatted display text for the single-product price.\"},\"single_product_price_decimal\":{\"type\":\"string\",\"description\":\"Single-product price amount returned as decimal text.\"},\"sale_price_integer_part_format\":{\"type\":\"string\",\"description\":\"Formatted integer part of the displayed sale price.\"},\"sale_price_decimal_part_format\":{\"type\":\"string\",\"description\":\"Formatted decimal part of the displayed sale price.\"},\"decimal_point_symbol\":{\"type\":\"string\",\"description\":\"Decimal separator reported for the price format.\"},\"promotion_deduction_details\":{\"type\":\"object\",\"description\":\"Promotion deduction information returned with the price.\",\"properties\":{\"seller_subtotal_deduction\":{\"type\":\"string\",\"description\":\"Displayed seller subtotal deduction reported with the promotion.\"},\"seller_subtotal_deduction_decimal\":{\"type\":\"string\",\"description\":\"Seller subtotal deduction amount returned as decimal text.\"}}},\"raw_origin_price_decimal\":{\"type\":\"string\",\"description\":\"Raw original-price amount reported as decimal text.\"},\"raw_origin_price_format\":{\"type\":\"string\",\"description\":\"Formatted display text for the raw original price.\"},\"origin_price_decimal\":{\"type\":\"string\",\"description\":\"Original-price amount returned as decimal text, when provided.\"},\"origin_price_format\":{\"type\":\"string\",\"description\":\"Formatted display text for the reported original price.\"},\"discount_format\":{\"type\":\"string\",\"description\":\"Formatted discount display text.\"},\"discount_decimal\":{\"type\":\"string\",\"description\":\"Discount value returned as decimal text.\"},\"reduce_price_format\":{\"type\":\"string\",\"description\":\"Formatted display text for the reported price reduction.\"}}}}}},\"product_marketing_info\":{\"type\":\"object\",\"description\":\"Marketing display information returned with the product.\",\"properties\":{\"placement_labels_ui\":{\"type\":\"object\",\"description\":\"Display groups for product marketing labels.\",\"properties\":{\"ui_list\":{\"type\":\"array\",\"description\":\"Product marketing label groups returned for display.\",\"items\":{\"type\":\"object\",\"description\":\"One marketing label group in the result.\",\"properties\":{\"placement\":{\"type\":\"integer\",\"description\":\"Placement code reported for the marketing label group.\"},\"labels\":{\"type\":\"array\",\"description\":\"Marketing labels returned for this display group.\",\"items\":{\"type\":\"object\",\"description\":\"One marketing label in the display group.\",\"properties\":{\"meta\":{\"type\":\"object\",\"description\":\"Metadata returned for the marketing label.\",\"properties\":{\"label_type\":{\"type\":\"string\",\"description\":\"Type label reported for the marketing label.\"}}},\"lom\":{\"type\":\"object\",\"description\":\"Display content returned for the marketing label.\",\"properties\":{\"value\":{\"type\":\"string\",\"description\":\"Display value returned for the marketing label.\"}}}}}}}}}}}}},\"image\":{\"type\":\"object\",\"description\":\"Main image information returned for the product.\",\"properties\":{\"height\":{\"type\":\"integer\",\"description\":\"Reported image height.\"},\"width\":{\"type\":\"integer\",\"description\":\"Reported image width.\"},\"uri\":{\"type\":\"string\",\"description\":\"Image URI returned with the image information.\"},\"url_list\":{\"type\":\"array\",\"description\":\"Available URLs returned for the image.\",\"items\":{\"type\":\"string\",\"description\":\"One URL returned for the image.\"}}}},\"transparent_image\":{\"type\":\"object\",\"description\":\"Transparent image information returned for the product.\",\"properties\":{\"height\":{\"type\":\"integer\",\"description\":\"Reported image height.\"},\"width\":{\"type\":\"integer\",\"description\":\"Reported image width.\"},\"uri\":{\"type\":\"string\",\"description\":\"Image URI returned with the image information.\"},\"url_list\":{\"type\":\"array\",\"description\":\"Available URLs returned for the image.\",\"items\":{\"type\":\"string\",\"description\":\"One URL returned for the image.\"}}}}}}},\"shops\":{\"type\":\"array\",\"description\":\"Shop entries returned separately in the search results.\",\"items\":{\"type\":\"object\",\"description\":\"One shop in the search results.\",\"properties\":{\"seller_id\":{\"type\":\"string\",\"description\":\"TikTok Shop seller identifier returned as text.\"},\"shop_name\":{\"type\":\"string\",\"description\":\"Display name returned for the shop.\"},\"store_blueV_label\":{\"type\":\"object\",\"description\":\"Blue verification badge artwork reported for the shop.\",\"properties\":{\"label_image_light\":{\"type\":\"object\",\"description\":\"Verification badge artwork for the light display.\",\"properties\":{\"height\":{\"type\":\"integer\",\"description\":\"Reported image height.\"},\"width\":{\"type\":\"integer\",\"description\":\"Reported image width.\"},\"uri\":{\"type\":\"string\",\"description\":\"Image URI returned with the image information.\"},\"url_list\":{\"type\":\"array\",\"description\":\"Available URLs returned for the image.\",\"items\":{\"type\":\"string\",\"description\":\"One URL returned for the image.\"}}}},\"label_image_dark\":{\"type\":\"object\",\"description\":\"Verification badge artwork for the dark display.\",\"properties\":{\"height\":{\"type\":\"integer\",\"description\":\"Reported image height.\"},\"width\":{\"type\":\"integer\",\"description\":\"Reported image width.\"},\"uri\":{\"type\":\"string\",\"description\":\"Image URI returned with the image information.\"},\"url_list\":{\"type\":\"array\",\"description\":\"Available URLs returned for the image.\",\"items\":{\"type\":\"string\",\"description\":\"One URL returned for the image.\"}}}}}},\"shop_logo\":{\"type\":\"object\",\"description\":\"Shop logo image information.\",\"properties\":{\"height\":{\"type\":\"integer\",\"description\":\"Reported image height.\"},\"width\":{\"type\":\"integer\",\"description\":\"Reported image width.\"},\"uri\":{\"type\":\"string\",\"description\":\"Image URI returned with the image information.\"},\"url_list\":{\"type\":\"array\",\"description\":\"Available URLs returned for the image.\",\"items\":{\"type\":\"string\",\"description\":\"One URL returned for the image.\"}}}}}}},\"filter_sections\":{\"type\":\"array\",\"description\":\"Filter sections described in the search results, when provided.\",\"items\":{\"type\":\"object\",\"description\":\"One filter section in the search results.\",\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"Identifier of the filter section.\"},\"title\":{\"type\":\"string\",\"description\":\"Display title of the filter section.\"},\"filterGroupType\":{\"type\":\"integer\",\"description\":\"Type code reported for the filter section.\"},\"type\":{\"type\":\"string\",\"description\":\"Type label reported for the filter section.\"},\"options\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"string\",\"description\":\"Filter option identifier for the display label used as the key.\"},\"description\":\"Filter option identifiers keyed by their display labels.\"},\"hasAllOption\":{\"type\":\"boolean\",\"description\":\"Whether the section is marked as having an all-options choice.\"},\"isColorSection\":{\"type\":\"boolean\",\"description\":\"Whether the section is marked as a color filter.\"},\"optionGroups\":{\"type\":\"array\",\"description\":\"Groups of filter options within this section, when provided.\",\"items\":{\"type\":\"object\",\"description\":\"One group of filter options.\",\"properties\":{\"title\":{\"type\":\"string\",\"description\":\"Display title of the filter option group.\"},\"options\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"string\",\"description\":\"Filter option identifier for the display label used as the key.\"},\"description\":\"Filter option identifiers keyed by their display labels.\"},\"hasAllOption\":{\"type\":\"boolean\",\"description\":\"Whether the option group is marked as having an all-options choice.\"}}}},\"isPriceRange\":{\"type\":\"boolean\",\"description\":\"Whether the section is marked as a price range filter.\"},\"showCustomPriceInput\":{\"type\":\"boolean\",\"description\":\"Whether the price filter is marked to show a custom input.\"},\"priceRangeInputInfo\":{\"type\":\"object\",\"description\":\"Displayed bounds and currency for the price range filter.\",\"properties\":{\"minDisplay\":{\"type\":\"string\",\"description\":\"Minimum price bound returned as display text.\"},\"maxDisplay\":{\"type\":\"string\",\"description\":\"Maximum price bound returned as display text.\"},\"currency\":{\"type\":\"string\",\"description\":\"Currency returned for the price range filter.\"}}}}}},\"filter_quick_options\":{\"type\":\"array\",\"description\":\"Quick filter options reported in the response, when available.\",\"items\":{\"type\":\"object\",\"description\":\"One quick filter option.\",\"properties\":{\"displayName\":{\"type\":\"string\",\"description\":\"Display name of the quick filter option.\"},\"sectionTitle\":{\"type\":\"string\",\"description\":\"Display title of the section associated with the quick option.\"},\"filterOptionId\":{\"type\":\"string\",\"description\":\"Identifier of the quick filter option.\"},\"filterGroupType\":{\"type\":\"integer\",\"description\":\"Filter group type code reported for the quick option.\"}}}}}}}}}},\"allOf\":[{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}]}}}},\"400\":{\"description\":\"Invalid request parameters or body\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"401\":{\"description\":\"Invalid or inactive access token\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"403\":{\"description\":\"Permission denied\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"429\":{\"description\":\"Request rate or daily quota limit exceeded\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"500\":{\"description\":\"Internal server error\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}},\"503\":{\"description\":\"Service temporarily unavailable\",\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"properties\":{\"code\":{\"type\":\"integer\",\"format\":\"int32\",\"enum\":[0,100,101,202,300,301,302,303,400,404,500,503,600,601,602]},\"message\":{\"type\":[\"string\",\"null\"]},\"data\":{},\"recordTime\":{\"type\":[\"string\",\"null\"]},\"requestId\":{\"type\":\"string\"},\"reason\":{\"type\":\"string\"},\"requestParams\":{\"type\":\"object\",\"properties\":{\"query\":{\"type\":\"object\",\"additionalProperties\":{\"type\":\"object\"}},\"body\":{\"type\":\"object\",\"properties\":{\"empty\":{\"type\":\"boolean\"},\"array\":{\"type\":\"boolean\"},\"null\":{\"type\":\"boolean\"},\"object\":{\"type\":\"boolean\"},\"float\":{\"type\":\"boolean\"},\"container\":{\"type\":\"boolean\"},\"valueNode\":{\"type\":\"boolean\"},\"integralNumber\":{\"type\":\"boolean\"},\"floatingPointNumber\":{\"type\":\"boolean\"},\"missingNode\":{\"type\":\"boolean\"},\"boolean\":{\"type\":\"boolean\"},\"binary\":{\"type\":\"boolean\"},\"nodeType\":{\"type\":\"string\",\"enum\":[\"ARRAY\",\"BINARY\",\"BOOLEAN\",\"MISSING\",\"NULL\",\"NUMBER\",\"OBJECT\",\"POJO\",\"STRING\"]},\"string\":{\"type\":\"boolean\"},\"pojo\":{\"type\":\"boolean\"},\"short\":{\"type\":\"boolean\"},\"int\":{\"type\":\"boolean\"},\"long\":{\"type\":\"boolean\"},\"double\":{\"type\":\"boolean\"},\"bigDecimal\":{\"type\":\"boolean\"},\"bigInteger\":{\"type\":\"boolean\"},\"textual\":{\"type\":\"boolean\",\"deprecated\":true},\"number\":{\"type\":\"boolean\"},\"embeddedValue\":{\"type\":\"boolean\"}}}}}},\"required\":[\"code\",\"data\",\"message\",\"recordTime\"]}}}}}")'
  :servers='JSON.parse("[{\"url\":\"https://api.justoneapi.com\",\"description\":\"Global production API (default)\"}]")'
  :security='JSON.parse("[]")'
  :securitySchemes='JSON.parse("{}")'
  :schemas='JSON.parse("{}")'
/>

<ApiHealthSection :api='JSON.parse("\"/api/tiktok-shop/search-products/v1\"")' />

<p>Searches TikTok Shop products by keyword within a selected region, with offset and page-token pagination. Use it to discover regional products and continue through search results.</p>

## Parameters

<div class="api-doc-table api-doc-table--params">

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| <code>token</code> | query | <code>string</code> | Yes | - | Authentication token for this API service. |
| <code>keyword</code> | query | <code>string</code> | Yes | - | Search keyword. |
| <code>region</code> | query | <code>string</code> | No | <code>US</code> | Target region for product search.<br /><br><br>Available Values:<br /><br>- <code>US</code>: United States<br /><br>- <code>GB</code>: United Kingdom<br /><br>- <code>FR</code>: France<br /><br>- <code>SG</code>: Singapore<br /><br>- <code>MY</code>: Malaysia<br /><br>- <code>PH</code>: Philippines<br /><br>- <code>TH</code>: Thailand<br /><br>- <code>VN</code>: Vietnam<br /><br>- <code>ID</code>: Indonesia |
| <code>offset</code> | query | <code>integer</code> | No | <code>0</code> | Search result offset. |
| <code>pageToken</code> | query | <code>string</code> | No | - | Pagination token for the next page. |

</div>

## Code Samples

::: code-group

```bash [🐚 cURL]
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/tiktok-shop/search-products/v1?token=YOUR_API_KEY&keyword=VALUE'
```

```text [🤖 AI Prompt]
I want to use the "Product Search (V1)" API from JustOneAPI.
Base URL: https://api.justoneapi.com.
API Path: /api/tiktok-shop/search-products/v1?token=YOUR_API_KEY&keyword=VALUE
API Endpoint: BASE_URL + /api/tiktok-shop/search-products/v1?token=YOUR_API_KEY&keyword=VALUE
HTTP Method: GET
Authentication: Append the "token" query parameter to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/tiktok-shop/product-search-v1-en.json

Parameters:
- token (query): Authentication token for this API service. (Required)
- keyword (query): Search keyword. (Required)
- region (query): Target region for product search.

Available Values:
- `US`: United States
- `GB`: United Kingdom
- `FR`: France
- `SG`: Singapore
- `MY`: Malaysia
- `PH`: Philippines
- `TH`: Thailand
- `VN`: Vietnam
- `ID`: Indonesia
- offset (query): Search result offset.
- pageToken (query): Pagination token for the next page.

Return format: safely handle JSON or text according to the actual Content-Type.

Response Handling & Error Codes:
1. Business results should be determined by the "code" field in the response body (code 0 means success).
2. Timeout Recommendation: Set the request timeout to 120 seconds. If 120 seconds is too long for your use case, use at least 60 seconds, but a small number of requests may time out before receiving a result.
3. Business Code Reference:
   - 0: Success
   - 100: Invalid or Inactive Token
   - 301: Collection Failed. Please Retry.
   - 302: Rate Limit Exceeded
   - 303: Daily Quota Exceeded
   - 400: Invalid Parameters
   - 500: Internal Server Error
   - 600: Permission Denied
   - 601: Insufficient Balance
   - 602: Token Budget Exceeded
4. Code 601 means the shared account balance is insufficient. Code 602 means the current API token's own cumulative budget limit has been reached. Token budget limits do not transfer funds out of the shared account balance.

Please help me write a script in my preferred programming language to call this API and handle the response.
```

```python [🐍 Python]
import requests

BASE_URL = "https://api.justoneapi.com"  # Provided by OpenAPI servers

url = BASE_URL + "/api/tiktok-shop/search-products/v1?token=YOUR_API_KEY&keyword=VALUE"
response = requests.get(url, timeout=120)
print(response.status_code)
if response.content:
    content_type = response.headers.get("content-type", "").lower()
    if "json" in content_type:
        try:
            print(response.json())
        except ValueError:
            print(response.text)
    elif content_type.startswith("text/") or "xml" in content_type or content_type.split(";", 1)[0].strip() in {"application/javascript", "application/x-www-form-urlencoded", "application/graphql"}:
        print(response.text)
    else:
        with open("response.bin", "wb") as output:
            output.write(response.content)
        print(f"Saved {len(response.content)} bytes to response.bin")
```

```js [🌐 JavaScript]
const BASE_URL = "https://api.justoneapi.com"; // Provided by OpenAPI servers
const url = BASE_URL + "/api/tiktok-shop/search-products/v1?token=YOUR_API_KEY&keyword=VALUE";

const response = await fetch(url, {
  method: "GET",
  signal: AbortSignal.timeout(120000)
});
console.log(response.status);
const responseBytes = await response.arrayBuffer();
if (responseBytes.byteLength) {
  const contentType = (response.headers.get("content-type") || "").toLowerCase();
  const mediaType = contentType.split(";", 1)[0].trim();
  const textual = contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || ["application/javascript", "application/x-www-form-urlencoded", "application/graphql"].includes(mediaType);
  if (textual) {
    const responseText = new TextDecoder().decode(responseBytes);
    let data = responseText;
    if (contentType.includes("json")) {
      try { data = JSON.parse(responseText); } catch { /* Keep the raw body. */ }
    }
    console.log(data);
  } else {
    console.log(`Received ${responseBytes.byteLength} binary bytes`);
  }
}
```

```java [☕ Java]
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;

public class Main {
    public static void main(String[] args) throws Exception {
        final String BASE_URL = "https://api.justoneapi.com"; // Provided by OpenAPI servers
        final String url = BASE_URL + "/api/tiktok-shop/search-products/v1?token=YOUR_API_KEY&keyword=VALUE";

        HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(120)).build();
        HttpRequest.Builder builder = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .timeout(Duration.ofSeconds(120))
            .method("GET", HttpRequest.BodyPublishers.noBody());

        HttpRequest request = builder.build();

        HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());
        System.out.println(response.statusCode());
        String contentType = response.headers().firstValue("content-type").orElse("").toLowerCase();
        String mediaType = contentType.split(";", 2)[0].trim();
        if (contentType.startsWith("text/") || contentType.contains("json") || contentType.contains("xml") || mediaType.equals("application/javascript") || mediaType.equals("application/x-www-form-urlencoded") || mediaType.equals("application/graphql")) {
            System.out.println(new String(response.body(), StandardCharsets.UTF_8));
        } else {
            Files.write(Path.of("response.bin"), response.body());
            System.out.println("Saved " + response.body().length + " bytes to response.bin");
        }
    }
}
```

```go [🐹 Go]
package main

import (
	"fmt"
	"io"
	"os"
	"strings"
	"net/http"
	"time"
)

const BASE_URL = "https://api.justoneapi.com" // Provided by OpenAPI servers

func main() {
	client := &http.Client{Timeout: 120 * time.Second}
	url := BASE_URL + "/api/tiktok-shop/search-products/v1?token=YOUR_API_KEY&keyword=VALUE"
	req, _ := http.NewRequest("GET", url, nil)
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	fmt.Println(resp.StatusCode)
	bodyBytes, _ := io.ReadAll(resp.Body)
	contentType := strings.ToLower(resp.Header.Get("Content-Type"))
	mediaType := strings.TrimSpace(strings.SplitN(contentType, ";", 2)[0])
	if strings.HasPrefix(contentType, "text/") || strings.Contains(contentType, "json") || strings.Contains(contentType, "xml") || mediaType == "application/javascript" || mediaType == "application/x-www-form-urlencoded" || mediaType == "application/graphql" {
		fmt.Println(string(bodyBytes))
	} else {
		os.WriteFile("response.bin", bodyBytes, 0600)
		fmt.Printf("Saved %d bytes to response.bin\n", len(bodyBytes))
	}
}
```

```php [🐘 PHP]
<?php
$BASE_URL = 'https://api.justoneapi.com'; // Provided by OpenAPI servers
$url = $BASE_URL . '/api/tiktok-shop/search-products/v1?token=YOUR_API_KEY&keyword=VALUE';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 120);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$contentType = strtolower((string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE));
curl_close($ch);
echo $status . PHP_EOL;
$mediaType = trim(explode(';', $contentType, 2)[0]);
if (str_starts_with($contentType, 'text/') || str_contains($contentType, 'json') || str_contains($contentType, 'xml') || in_array($mediaType, ['application/javascript', 'application/x-www-form-urlencoded', 'application/graphql'], true)) {
    echo $response;
} else {
    file_put_contents('response.bin', $response);
    echo 'Saved ' . strlen($response) . ' bytes to response.bin' . PHP_EOL;
}
```

:::

<div style="text-align: right; margin-top: -20px; margin-bottom: 20px;">
<a href="/openapi/tiktok-shop/product-search-v1-en.json" target="_blank" style="font-size: 12px; color: var(--vp-c-text-3); text-decoration: none; opacity: 0.8;">[OpenAPI Definition (JSON)]</a>
</div>

## Response Fields

Key fields in a successful response (`code = 0`).

<div class="api-doc-table api-doc-table--response">

| Field path | Type | Description |
| --- | --- | --- |
| <code>data</code> | <code>object</code> | TikTok Shop search result and its reported status. |
| <code>data.code</code> | <code>integer</code> | Inner status code reported by TikTok Shop. |
| <code>data.message</code> | <code>string</code> | Inner status message reported by TikTok Shop. |
| <code>data.data</code> | <code>object</code> | Products, shops and search metadata returned for this page. |
| <code>data.data.has_more</code> | <code>boolean</code> | Whether the response reports more search results. |
| <code>data.data.load_more_params</code> | <code>object</code> | Continuation parameters returned for the next search request. |
| <code>data.data.load_more_params.offset</code> | <code>integer</code> | Offset returned for the next page. Pass it as offset with the same keyword and region. |
| <code>data.data.load_more_params.page_token</code> | <code>string</code> | Opaque token returned for continuing the search. Pass it unchanged as pageToken with the returned offset. |
| <code>data.data.products</code> | <code>array</code> | Product entries returned on this search page. |
| <code>data.data.products[]</code> | <code>object</code> | One product in the search results. |
| <code>data.data.products[].product_id</code> | <code>string</code> | TikTok Shop product identifier returned as text. |
| <code>data.data.products[].title</code> | <code>string</code> | Title returned for the product listing. |
| <code>data.data.products[].product_price_info</code> | <code>object</code> | Price information returned with the product listing. |
| <code>data.data.products[].product_price_info.price_prefix</code> | <code>string</code> | Optional text displayed before the returned price. |
| <code>data.data.products[].product_price_info.sku_id</code> | <code>string</code> | Identifier reported for the SKU associated with this price. |
| <code>data.data.products[].product_price_info.symbol_position</code> | <code>integer</code> | Position code reported for the currency symbol. |
| <code>data.data.products[].product_price_info.show_currency_space</code> | <code>boolean</code> | Whether the price format calls for a currency space. |
| <code>data.data.products[].product_price_info.currency_show_mode</code> | <code>integer</code> | Currency display mode code reported with the price. |
| <code>data.data.products[].product_price_info.currency_name</code> | <code>string</code> | Currency identifier reported with the price. |
| <code>data.data.products[].product_price_info.currency_symbol</code> | <code>string</code> | Currency symbol reported with the price. |
| <code>data.data.products[].product_price_info.sale_price_decimal</code> | <code>string</code> | Sale price amount returned as decimal text. |
| <code>data.data.products[].product_price_info.sale_price_format</code> | <code>string</code> | Formatted sale price display text. |
| <code>data.data.products[].product_price_info.single_product_price_format</code> | <code>string</code> | Formatted display text for the single-product price. |
| <code>data.data.products[].product_price_info.single_product_price_decimal</code> | <code>string</code> | Single-product price amount returned as decimal text. |
| <code>data.data.products[].product_price_info.sale_price_integer_part_format</code> | <code>string</code> | Formatted integer part of the displayed sale price. |
| <code>data.data.products[].product_price_info.sale_price_decimal_part_format</code> | <code>string</code> | Formatted decimal part of the displayed sale price. |
| <code>data.data.products[].product_price_info.decimal_point_symbol</code> | <code>string</code> | Decimal separator reported for the price format. |
| <code>data.data.products[].product_price_info.promotion_deduction_details</code> | <code>object</code> | Promotion deduction information returned with the price. |
| <code>data.data.products[].product_price_info.promotion_deduction_details.seller_subtotal_deduction</code> | <code>string</code> | Displayed seller subtotal deduction reported with the promotion. |
| <code>data.data.products[].product_price_info.promotion_deduction_details.seller_subtotal_deduction_decimal</code> | <code>string</code> | Seller subtotal deduction amount returned as decimal text. |
| <code>data.data.products[].product_price_info.raw_origin_price_decimal</code> | <code>string</code> | Raw original-price amount reported as decimal text. |
| <code>data.data.products[].product_price_info.raw_origin_price_format</code> | <code>string</code> | Formatted display text for the raw original price. |
| <code>data.data.products[].product_price_info.origin_price_decimal</code> | <code>string</code> | Original-price amount returned as decimal text, when provided. |
| <code>data.data.products[].product_price_info.origin_price_format</code> | <code>string</code> | Formatted display text for the reported original price. |
| <code>data.data.products[].product_price_info.discount_format</code> | <code>string</code> | Formatted discount display text. |
| <code>data.data.products[].product_price_info.discount_decimal</code> | <code>string</code> | Discount value returned as decimal text. |
| <code>data.data.products[].product_price_info.reduce_price_format</code> | <code>string</code> | Formatted display text for the reported price reduction. |
| <code>data.data.products[].rate_info</code> | <code>object</code> | Rating information returned for the product, when available. |
| <code>data.data.products[].rate_info.score</code> | <code>number</code> | Rating score reported as a number. |
| <code>data.data.products[].rate_info.review_count</code> | <code>string</code> | Review count reported as display text. |
| <code>data.data.products[].sold_info</code> | <code>object</code> | Sales count information returned for the listing. |
| <code>data.data.products[].sold_info.sold_count</code> | <code>integer</code> | Sold count reported for the product. |
| <code>data.data.products[].brand_info</code> | <code>object</code> | Brand information returned for the product, when available. |
| <code>data.data.products[].brand_info.brand_name</code> | <code>string</code> | Brand name reported for the product. |
| <code>data.data.products[].seo_url</code> | <code>object</code> | Product page link metadata returned with the listing. |
| <code>data.data.products[].seo_url.canonical_url</code> | <code>string</code> | Canonical product page URL returned for the listing. |
| <code>data.data.products[].seo_url.slug</code> | <code>string</code> | Product page slug returned with the canonical link. |
| <code>data.data.products[].seller_info</code> | <code>object</code> | Seller information returned with the product. |
| <code>data.data.products[].seller_info.seller_id</code> | <code>string</code> | TikTok Shop seller identifier returned as text. |
| <code>data.data.products[].seller_info.shop_name</code> | <code>string</code> | Display name returned for the shop. |
| <code>data.data.products[].seller_info.store_blueV_label</code> | <code>object</code> | Blue verification badge artwork reported for the shop. |
| <code>data.data.products[].seller_info.store_blueV_label.label_image_light</code> | <code>object</code> | Verification badge artwork for the light display. |
| <code>data.data.products[].seller_info.store_blueV_label.label_image_light.height</code> | <code>integer</code> | Reported image height. |
| <code>data.data.products[].seller_info.store_blueV_label.label_image_light.width</code> | <code>integer</code> | Reported image width. |
| <code>data.data.products[].seller_info.store_blueV_label.label_image_light.uri</code> | <code>string</code> | Image URI returned with the image information. |
| <code>data.data.products[].seller_info.store_blueV_label.label_image_light.url_list</code> | <code>array</code> | Available URLs returned for the image. |
| <code>data.data.products[].seller_info.store_blueV_label.label_image_light.url_list[]</code> | <code>string</code> | One URL returned for the image. |
| <code>data.data.products[].seller_info.store_blueV_label.label_image_dark</code> | <code>object</code> | Verification badge artwork for the dark display. |
| <code>data.data.products[].seller_info.store_blueV_label.label_image_dark.height</code> | <code>integer</code> | Reported image height. |
| <code>data.data.products[].seller_info.store_blueV_label.label_image_dark.width</code> | <code>integer</code> | Reported image width. |
| <code>data.data.products[].seller_info.store_blueV_label.label_image_dark.uri</code> | <code>string</code> | Image URI returned with the image information. |
| <code>data.data.products[].seller_info.store_blueV_label.label_image_dark.url_list</code> | <code>array</code> | Available URLs returned for the image. |
| <code>data.data.products[].seller_info.store_blueV_label.label_image_dark.url_list[]</code> | <code>string</code> | One URL returned for the image. |
| <code>data.data.products[].seller_info.shop_logo</code> | <code>object</code> | Shop logo image information. |
| <code>data.data.products[].seller_info.shop_logo.height</code> | <code>integer</code> | Reported image height. |
| <code>data.data.products[].seller_info.shop_logo.width</code> | <code>integer</code> | Reported image width. |
| <code>data.data.products[].seller_info.shop_logo.uri</code> | <code>string</code> | Image URI returned with the image information. |
| <code>data.data.products[].seller_info.shop_logo.url_list</code> | <code>array</code> | Available URLs returned for the image. |
| <code>data.data.products[].seller_info.shop_logo.url_list[]</code> | <code>string</code> | One URL returned for the image. |
| <code>data.data.products[].sku_info</code> | <code>array</code> | SKU price entries returned for this product. |
| <code>data.data.products[].sku_info[]</code> | <code>object</code> | One SKU price entry for this product. |
| <code>data.data.products[].sku_info[].SkuId</code> | <code>string</code> | SKU identifier returned for the price entry. |
| <code>data.data.products[].sku_info[].PriceInfo</code> | <code>object</code> | Price information returned for the SKU. |
| <code>data.data.products[].sku_info[].PriceInfo.sku_id</code> | <code>string</code> | Identifier reported for the SKU associated with this price. |
| <code>data.data.products[].sku_info[].PriceInfo.symbol_position</code> | <code>integer</code> | Position code reported for the currency symbol. |
| <code>data.data.products[].sku_info[].PriceInfo.show_currency_space</code> | <code>boolean</code> | Whether the price format calls for a currency space. |
| <code>data.data.products[].sku_info[].PriceInfo.currency_show_mode</code> | <code>integer</code> | Currency display mode code reported with the price. |
| <code>data.data.products[].sku_info[].PriceInfo.currency_name</code> | <code>string</code> | Currency identifier reported with the price. |
| <code>data.data.products[].sku_info[].PriceInfo.currency_symbol</code> | <code>string</code> | Currency symbol reported with the price. |
| <code>data.data.products[].sku_info[].PriceInfo.sale_price_decimal</code> | <code>string</code> | Sale price amount returned as decimal text. |
| <code>data.data.products[].sku_info[].PriceInfo.sale_price_format</code> | <code>string</code> | Formatted sale price display text. |
| <code>data.data.products[].sku_info[].PriceInfo.single_product_price_format</code> | <code>string</code> | Formatted display text for the single-product price. |
| <code>data.data.products[].sku_info[].PriceInfo.single_product_price_decimal</code> | <code>string</code> | Single-product price amount returned as decimal text. |
| <code>data.data.products[].sku_info[].PriceInfo.sale_price_integer_part_format</code> | <code>string</code> | Formatted integer part of the displayed sale price. |
| <code>data.data.products[].sku_info[].PriceInfo.sale_price_decimal_part_format</code> | <code>string</code> | Formatted decimal part of the displayed sale price. |
| <code>data.data.products[].sku_info[].PriceInfo.decimal_point_symbol</code> | <code>string</code> | Decimal separator reported for the price format. |
| <code>data.data.products[].sku_info[].PriceInfo.promotion_deduction_details</code> | <code>object</code> | Promotion deduction information returned with the price. |
| <code>data.data.products[].sku_info[].PriceInfo.promotion_deduction_details.seller_subtotal_deduction</code> | <code>string</code> | Displayed seller subtotal deduction reported with the promotion. |
| <code>data.data.products[].sku_info[].PriceInfo.promotion_deduction_details.seller_subtotal_deduction_decimal</code> | <code>string</code> | Seller subtotal deduction amount returned as decimal text. |
| <code>data.data.products[].sku_info[].PriceInfo.raw_origin_price_decimal</code> | <code>string</code> | Raw original-price amount reported as decimal text. |
| <code>data.data.products[].sku_info[].PriceInfo.raw_origin_price_format</code> | <code>string</code> | Formatted display text for the raw original price. |
| <code>data.data.products[].sku_info[].PriceInfo.origin_price_decimal</code> | <code>string</code> | Original-price amount returned as decimal text, when provided. |
| <code>data.data.products[].sku_info[].PriceInfo.origin_price_format</code> | <code>string</code> | Formatted display text for the reported original price. |
| <code>data.data.products[].sku_info[].PriceInfo.discount_format</code> | <code>string</code> | Formatted discount display text. |
| <code>data.data.products[].sku_info[].PriceInfo.discount_decimal</code> | <code>string</code> | Discount value returned as decimal text. |
| <code>data.data.products[].sku_info[].PriceInfo.reduce_price_format</code> | <code>string</code> | Formatted display text for the reported price reduction. |
| <code>data.data.products[].product_marketing_info</code> | <code>object</code> | Marketing display information returned with the product. |
| <code>data.data.products[].product_marketing_info.placement_labels_ui</code> | <code>object</code> | Display groups for product marketing labels. |
| <code>data.data.products[].product_marketing_info.placement_labels_ui.ui_list</code> | <code>array</code> | Product marketing label groups returned for display. |
| <code>data.data.products[].product_marketing_info.placement_labels_ui.ui_list[]</code> | <code>object</code> | One marketing label group in the result. |
| <code>data.data.products[].product_marketing_info.placement_labels_ui.ui_list[].placement</code> | <code>integer</code> | Placement code reported for the marketing label group. |
| <code>data.data.products[].product_marketing_info.placement_labels_ui.ui_list[].labels</code> | <code>array</code> | Marketing labels returned for this display group. |
| <code>data.data.products[].product_marketing_info.placement_labels_ui.ui_list[].labels[]</code> | <code>object</code> | One marketing label in the display group. |
| <code>data.data.products[].product_marketing_info.placement_labels_ui.ui_list[].labels[].meta</code> | <code>object</code> | Metadata returned for the marketing label. |
| <code>data.data.products[].product_marketing_info.placement_labels_ui.ui_list[].labels[].meta.label_type</code> | <code>string</code> | Type label reported for the marketing label. |
| <code>data.data.products[].product_marketing_info.placement_labels_ui.ui_list[].labels[].lom</code> | <code>object</code> | Display content returned for the marketing label. |
| <code>data.data.products[].product_marketing_info.placement_labels_ui.ui_list[].labels[].lom.value</code> | <code>string</code> | Display value returned for the marketing label. |
| <code>data.data.products[].image</code> | <code>object</code> | Main image information returned for the product. |
| <code>data.data.products[].image.height</code> | <code>integer</code> | Reported image height. |
| <code>data.data.products[].image.width</code> | <code>integer</code> | Reported image width. |
| <code>data.data.products[].image.uri</code> | <code>string</code> | Image URI returned with the image information. |
| <code>data.data.products[].image.url_list</code> | <code>array</code> | Available URLs returned for the image. |
| <code>data.data.products[].image.url_list[]</code> | <code>string</code> | One URL returned for the image. |
| <code>data.data.products[].transparent_image</code> | <code>object</code> | Transparent image information returned for the product. |
| <code>data.data.products[].transparent_image.height</code> | <code>integer</code> | Reported image height. |
| <code>data.data.products[].transparent_image.width</code> | <code>integer</code> | Reported image width. |
| <code>data.data.products[].transparent_image.uri</code> | <code>string</code> | Image URI returned with the image information. |
| <code>data.data.products[].transparent_image.url_list</code> | <code>array</code> | Available URLs returned for the image. |
| <code>data.data.products[].transparent_image.url_list[]</code> | <code>string</code> | One URL returned for the image. |
| <code>data.data.shops</code> | <code>array</code> | Shop entries returned separately in the search results. |
| <code>data.data.shops[]</code> | <code>object</code> | One shop in the search results. |
| <code>data.data.shops[].seller_id</code> | <code>string</code> | TikTok Shop seller identifier returned as text. |
| <code>data.data.shops[].shop_name</code> | <code>string</code> | Display name returned for the shop. |
| <code>data.data.shops[].store_blueV_label</code> | <code>object</code> | Blue verification badge artwork reported for the shop. |
| <code>data.data.shops[].store_blueV_label.label_image_light</code> | <code>object</code> | Verification badge artwork for the light display. |
| <code>data.data.shops[].store_blueV_label.label_image_light.height</code> | <code>integer</code> | Reported image height. |
| <code>data.data.shops[].store_blueV_label.label_image_light.width</code> | <code>integer</code> | Reported image width. |
| <code>data.data.shops[].store_blueV_label.label_image_light.uri</code> | <code>string</code> | Image URI returned with the image information. |
| <code>data.data.shops[].store_blueV_label.label_image_light.url_list</code> | <code>array</code> | Available URLs returned for the image. |
| <code>data.data.shops[].store_blueV_label.label_image_light.url_list[]</code> | <code>string</code> | One URL returned for the image. |
| <code>data.data.shops[].store_blueV_label.label_image_dark</code> | <code>object</code> | Verification badge artwork for the dark display. |
| <code>data.data.shops[].store_blueV_label.label_image_dark.height</code> | <code>integer</code> | Reported image height. |
| <code>data.data.shops[].store_blueV_label.label_image_dark.width</code> | <code>integer</code> | Reported image width. |
| <code>data.data.shops[].store_blueV_label.label_image_dark.uri</code> | <code>string</code> | Image URI returned with the image information. |
| <code>data.data.shops[].store_blueV_label.label_image_dark.url_list</code> | <code>array</code> | Available URLs returned for the image. |
| <code>data.data.shops[].store_blueV_label.label_image_dark.url_list[]</code> | <code>string</code> | One URL returned for the image. |
| <code>data.data.shops[].shop_logo</code> | <code>object</code> | Shop logo image information. |
| <code>data.data.shops[].shop_logo.height</code> | <code>integer</code> | Reported image height. |
| <code>data.data.shops[].shop_logo.width</code> | <code>integer</code> | Reported image width. |
| <code>data.data.shops[].shop_logo.uri</code> | <code>string</code> | Image URI returned with the image information. |
| <code>data.data.shops[].shop_logo.url_list</code> | <code>array</code> | Available URLs returned for the image. |
| <code>data.data.shops[].shop_logo.url_list[]</code> | <code>string</code> | One URL returned for the image. |
| <code>data.data.filter_sections</code> | <code>array</code> | Filter sections described in the search results, when provided. |
| <code>data.data.filter_sections[]</code> | <code>object</code> | One filter section in the search results. |
| <code>data.data.filter_sections[].id</code> | <code>string</code> | Identifier of the filter section. |
| <code>data.data.filter_sections[].title</code> | <code>string</code> | Display title of the filter section. |
| <code>data.data.filter_sections[].filterGroupType</code> | <code>integer</code> | Type code reported for the filter section. |
| <code>data.data.filter_sections[].type</code> | <code>string</code> | Type label reported for the filter section. |
| <code>data.data.filter_sections[].options</code> | <code>object</code> | Filter option identifiers keyed by their display labels. |
| <code>data.data.filter_sections[].options.{key}</code> | <code>string</code> | Filter option identifier for the display label used as the key. |
| <code>data.data.filter_sections[].hasAllOption</code> | <code>boolean</code> | Whether the section is marked as having an all-options choice. |
| <code>data.data.filter_sections[].isColorSection</code> | <code>boolean</code> | Whether the section is marked as a color filter. |
| <code>data.data.filter_sections[].optionGroups</code> | <code>array</code> | Groups of filter options within this section, when provided. |
| <code>data.data.filter_sections[].optionGroups[]</code> | <code>object</code> | One group of filter options. |
| <code>data.data.filter_sections[].optionGroups[].title</code> | <code>string</code> | Display title of the filter option group. |
| <code>data.data.filter_sections[].optionGroups[].options</code> | <code>object</code> | Filter option identifiers keyed by their display labels. |
| <code>data.data.filter_sections[].optionGroups[].options.{key}</code> | <code>string</code> | Filter option identifier for the display label used as the key. |
| <code>data.data.filter_sections[].optionGroups[].hasAllOption</code> | <code>boolean</code> | Whether the option group is marked as having an all-options choice. |
| <code>data.data.filter_sections[].isPriceRange</code> | <code>boolean</code> | Whether the section is marked as a price range filter. |
| <code>data.data.filter_sections[].showCustomPriceInput</code> | <code>boolean</code> | Whether the price filter is marked to show a custom input. |
| <code>data.data.filter_sections[].priceRangeInputInfo</code> | <code>object</code> | Displayed bounds and currency for the price range filter. |
| <code>data.data.filter_sections[].priceRangeInputInfo.minDisplay</code> | <code>string</code> | Minimum price bound returned as display text. |
| <code>data.data.filter_sections[].priceRangeInputInfo.maxDisplay</code> | <code>string</code> | Maximum price bound returned as display text. |
| <code>data.data.filter_sections[].priceRangeInputInfo.currency</code> | <code>string</code> | Currency returned for the price range filter. |
| <code>data.data.filter_quick_options</code> | <code>array</code> | Quick filter options reported in the response, when available. |
| <code>data.data.filter_quick_options[]</code> | <code>object</code> | One quick filter option. |
| <code>data.data.filter_quick_options[].displayName</code> | <code>string</code> | Display name of the quick filter option. |
| <code>data.data.filter_quick_options[].sectionTitle</code> | <code>string</code> | Display title of the section associated with the quick option. |
| <code>data.data.filter_quick_options[].filterOptionId</code> | <code>string</code> | Identifier of the quick filter option. |
| <code>data.data.filter_quick_options[].filterGroupType</code> | <code>integer</code> | Filter group type code reported for the quick option. |

</div>

## Response Example

<ApiExampleSection :api='JSON.parse("\"/api/tiktok-shop/search-products/v1\"")' />

