Chotot.com Scraper: Chợ Tốt Vietnam (search, filters, alerts)

A Chotot.com scraper for Chợ Tốt (Cho Tot), Vietnam's largest classifieds marketplace: search by keyword, category, region and price and get every listing as one flat row with VND price, ward-level location and the category attributes Chợ Tốt returns. Monitor mode on a saved Task gives you only the listings that are new or changed price since your last run.

What you get — example output

One row per listing. Real values from the example dataset (query iphone 15):

Field	Example value	What it is
id	chotot-134505021	Stable row key (chotot- + listing id)
title	Apple iPhone 15 128GB Xanh	Listing headline
price / priceLabel	15950000 / 15.950.000 đ	Price as a number in VND, plus the label Chợ Tốt prints
categoryName	Điện thoại	Category name (categoryId 5010)
city / district / ward	Tp Hồ Chí Minh / Huyện Hóc Môn / Xã Bà Điểm	Three levels of Vietnamese location
lat / lon	10.841164 / 106.59671	Listing coordinates
sellerType	business	private or business (isShopVerified flags verified shops)
createdAt	2026-09-04T05:18:56+00:00	When the listing was posted, in UTC
params	{"mobile_brand": "1", "mobile_capacity": "6", "type": "s"}	Category attributes as Chợ Tốt returns them

Full field list: id, url, platform, country, title, description, price, currency, priceLabel, priceType, categoryId, categoryName, categoryPath, condition, city, district, ward, region, lat, lon, images[], sellerId, sellerName, sellerType, isShopVerified, isSticky, createdAt, adType, params{}, query, rank, source, scrapedAt.

Use cases

• Price research in Vietnam: pull a whole category with VND prices and attributes to see the real market level for phones, bikes or flats.
• Vehicle and property watching: filter by category and region and get alerted when a matching listing appears or drops price.
• Reselling and sourcing: track a keyword in one city and catch underpriced listings the day they go up.

How it works

The actor calls Chợ Tốt's own public listing API, so rows arrive structured — coordinates, ward, category attributes — without HTML parsing, and without a login, cookies or a proxy. Each query is paginated 50 listings per page until maxPages or maxItems. In monitor mode the current result set is compared with the state stored by the previous run of the same Task, and only new or re-priced listings are pushed, optionally summarised to a webhook or Telegram chat.

Input

Field	Meaning	Default
queries	Keywords in Vietnamese or English, e.g. ["iphone"]	["iphone"]
categoryId	Chợ Tốt category id, e.g. 1000 real estate, 2010 cars, 5010 phones	—
regionId	Chợ Tốt region_v2 id, e.g. 13000 Tp Hồ Chí Minh, 12000 Hà Nội	—
priceFrom / priceTo	Price range in VND, e.g. 5000000 / 20000000	—
adType	s for sale, k wanted, all	s
sortBy	newest, relevance, price_asc, price_desc	newest
maxPages	Pages per query, 50 listings each	4
maxItems	Stop after this many listings	20
mode	scrape, or monitor for new/changed only	scrape
webhookUrl, telegramBotToken, telegramChatId	Where monitor-mode change summaries are sent	—

Pricing

Event	Price
result	$0.001 per listing ($1 per 1,000)
monitor-check	$0.005 per monitor run
change	$0.001 per new/changed listing

Charged only for listings actually pushed — an empty run costs you nothing. No proxy needed.

Why this actor

• Ward-level location plus coordinates on every row, not just the city.
• Prices come back as numbers in VND alongside the Vietnamese label, so they are ready for maths.
• Category attributes (params) survive, which is what makes phone, motorbike and property rows comparable.
• Monitor mode with new-listing and price-drop alerts, delivered by webhook or Telegram.
• No Chợ Tốt account, no cookies and no proxy configuration.

Limits

• Phone numbers are not included (Chợ Tốt reveals them only in-app).
• Search is capped by Chợ Tốt at 10,000 results per query; narrow by category or region.
• params keys and values are Chợ Tốt's own codes, not display labels.

FAQ

Can I monitor new listings for a search? Yes. Save the input as a Task, set mode: monitor and schedule it — each run returns only listings that appeared or changed price since the previous run, and can POST a summary to webhookUrl or a Telegram chat.

Can I scrape only Ho Chi Minh City or Hanoi? Yes — set regionId to 13000 (Tp Hồ Chí Minh) or 12000 (Hà Nội); every row also carries city, district and ward for finer filtering downstream.

Do I need a Chợ Tốt account or a proxy? No. The actor reads the site's public listing API, so there is nothing to configure.

Changelog

• 0.1: initial release.

---

If this actor saved you time, please leave a review on its Store page — it is the main way other buyers find it. Bug reports and field requests are welcome in the Issues tab.