Product Search Clean List

Find products by keyword and get a clean, easy-to-read list of matching items.

What it does

• Searches for products using your keyword.
• Keeps collecting results until it reaches your requested total.
• Lets you narrow results by region, price range, cash on delivery, live products, and sort order.
• Returns a simple list with the most useful product details.
• Helps non-technical users quickly review matching products in one place.

Use cases

• Compare similar products quickly, such as notebooks, journals, planners, or gift books, without digging through messy search results.
• Find products that fit a specific buying preference, like free shipping, cash on delivery, or live-broadcast items.
• Review seller, price, and promotion details before deciding which products to shortlist for research, content, or shopping.

Input

Field	Description	Required	Example
Search keyword	What product or topic you want to search for.	Yes	Notebook
Region	The marketplace region to search in.	Yes	MY
Maximum results	The total number of results you want returned.	Yes	50
Price range	Optional minimum and maximum price separated by a comma.	No	0,100
Cash on delivery only	Only show items that support cash on delivery. Use 1 for yes or 0 for no.	No	0
Live products only	Include products from live broadcasts. Use 1 for yes or 0 for no.	No	0
Sort type	Choose how results are ordered.	No	1

Output

Field	Description
product_id	Unique ID for the product listing.
title	Product name shown in search results.
seller.name	Seller or shop name.
seller.shop_id	Unique ID of the seller's shop.
price.currency	Currency symbol used for the price.
price.sale_price	Current selling price.
price.original_price	Original price before discount, if available.
price.discount_rate	Discount percentage, if available.
price.display	Price shown in a ready-to-read format.
shipping.ship_from	Location the item ships from, if shown.
shipping.free_shipping	Whether the item has free shipping.
promotions	List of active labels, vouchers, or deals attached to the product.
image.main_image_url	Main product image URL.
flags.is_ad	Whether the item is marked as an ad.
flags.trust_label	Trust or quality label shown for the listing.
product_url	Direct product link.

Sample output

{
  "product_id": "1731569396271190584",
  "title": "CAGIE A5 Floral Journal Notebook, Hardcover Vegan Leather Journal with 320 Lined Pages, College Ruled Notebook, Thick Paper, Pen Holder, Cute Journal for Women, Writing, Bible Study & Gifts，Junk journal dealsforyourdays",
  "seller": {
    "name": "CAGIE STATIONERY",
    "shop_id": "7496093817841814072"
  },
  "price": {
    "currency": "$",
    "sale_price": 11.99,
    "original_price": 28.99,
    "discount_rate": "59%",
    "display": "$11.99"
  },
  "shipping": {
    "ship_from": null,
    "free_shipping": true
  },
  "promotions": [
    {
      "shop_id": "7496093817841814072",
      "placement": "DEFAULT",
      "activity_name": "6",
      "has_icon": "false",
      "coupon_type_info": "{\"business_type\":\"min_spend_off\"}",
      "coupon_cost_role": "seller",
      "promotion_id": "7655595563804116749",
      "ranking": "1",
      "label_type": "VOUCHER"
    },
    {
      "has_icon": "true",
      "promotion_id": "-999",
      "delivery_tag": "free_3_day_delivery",
      "placement": "FREE_SHIPPING",
      "ranking": "1",
      "label_type": "FREE_THIRD_DAY_DELIVERY",
      "activity_name": "32"
    }
  ],
  "image": {
    "main_image_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/893b7c23972a4bd2bb876d2848116811~tplv-fhlh96nyum-crop-webp:400:400.webp?dr=12190&t=555f072d&ps=933b5bde&shp=678cc231&shcp=678cc231&idc=useast5&from=1737278001"
  },
  "flags": {
    "is_ad": true,
    "trust_label": "silver"
  },
  "product_url": "aweme://ec/pdp?biz_type=0&fullScreen=false&orderRequestParams=%7B%7D&requestParams=%7B%22product_id%22%3A%5B%221731569396271190584%22%5D%7D&visitReportParams=%7B%22chain_key%22%3A%22%22%2C%22material_id%22%3A%221731569396271190584%22%2C%22material_type%22%3A1%2C%22seller_id%22%3A%2274960938178418140..."
}