Reef AI: ask for any data. Try it
This page is the Chợ Tốt parameter reference. What the data is used for, a real sample and pricing are on Chợ Tốt API: what you get →
Classifieds & Second-hand

Chợ Tốt API & Scraper: parameters and responses

This is the reference for the 4 Chợ Tốt endpoints under /chotot/v1 (search, detail, categories and regions) and their 15 parameters. Each endpoint lists its parameters, required or optional, with allowed values and defaults, and comes with a cURL, Python and JavaScript call; every response uses the same { ok, data, meta, error } envelope.

Chợ Tốt API returns live Chợ Tốt data as clean JSON for chợ tốt The primary endpoint, search, returns listings records including ad id, list id, title, description and price.

4 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

Developers reach for it when they need to read second-hand listings, asking prices, seller inventory and country-specific listing ids without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Chợ Tốt scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, detail, categories, regions. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/chotot/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "q": "iphone",
    "category": 5010
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "chotot",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 1328.5,
    "record_count": 20,
    "bytes": 91252,
    "cache_hit": false,
    "stop_reason": "limit_reached",
    "locale": "vi-VN",
    "currency": "VND",
    "total": 10000,
    "total_is_capped": true,
    "page": 1,
    "limit": 20,
    "offset": 0,
    "has_more": true,
    "next_page": 2,
    "filters_applied": [
      "q",
      "category"
    ],
    "charged_credits": 1,
    "version": "1.0.1",
    "request_id": "8ad645f3750c4043",
    "queue_ms": 1.1,
    "fetched_at": "2026-11-03T17:32:02.282Z"
  },
  "data": {
    "listings": [
      {
        "ad_id": 176368136,
        "list_id": 132635356,
        "url": "https://www.chotot.com/132635356.htm",
        "title": "Apple iPhone 15 Plus",
        "description": "🍎15pl 128GB hình thức 95% main zin màn jk giá 10.00.000\n🍎15pl 128GB hình thức 95% main zin màn zin giá 11.000.000\n✅CAM KẾT BÁN CHUẨN GIÁ ĐÚNG TT\n✅MỞ MÁY TEST MAIN THOẢI MÁI\n✅ Bao test 1 đổi 1 trong 15 ngày, hỗ trợ  bảo hành 12 tháng",
        "price": 10100000,
        "price_string": "10.100.000 đ",
        "price_valid": true,
        "currency": "VND",
        "ad_type": "s",
        "category_id": 5010,
        "category_name": "Điện thoại",
        "region_id": 12000,
        "region_name": "Hà Nội",
        "area_id": 12129,
        "area_name": "Quận Bắc Từ Liêm",
        "ward_name": "Phường Phú Diễn",
        "posted_at": "2026-11-03T11:31:49.210000Z",
        "posted_relative": "6 giờ trước",
        "image": "https://cdn.chotot.com/l0w9u41G92FYTwM1zk_luhgt-d7t1a5YLQScltLsSw8/preset:listing/plain/fc0aad3acab287e244ed0c1e85b33c24-2986135765657855705.jpg",
        "images": [
          "https://cdn.chotot.com/yMNNQ7EuGiXzEs5atYcsFNuAMiK9RNBXEKWxPDoJWqA/preset:view/plain/fc0aad3acab287e244ed0c1e85b33c24-2986135765657855705.jpg",
          "https://cdn.chotot.com/bf4a6lg023ZyInFIdqEp4T4lWAQ2Hj4adNtWISzMk68/preset:view/plain/5be296fd9d3ac8f8d912e893f82606c5-2986135765656564939.jpg",
          "https://cdn.chotot.com/xofBjI9LwC_AeO5lHIp4-AGNViFhVMFDfiSsMPiYidg/preset:view/plain/7dab004db49e57ca134b2e0e3a0e01e7-2986135765724611772.jpg"
        ],
        "image_count": 4,
        "video_count": 2,
        "is_promoted": false,
        "seller": {
          "account_id": 27183927,
          "name": "Táo Sinh Viên ",
          "shop_id": "152b946d1a61f37b4e4c0acd2d9e1565",
          "is_shop_verified": false,
          "is_official_store": true,
          "rating": 4.8,
          "rating_count": 6,
          "avatar": "https://cdn.chotot.com/uac2/27183927"
        },
        "phone": null,
        "phone_hidden": null,
        "latitude": 21.047768,
        "longitude": 105.76153,
        "attributes": [
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]",
            "value": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]",
            "value": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]",
            "value": "[trimmed-depth]"
          }
        ]
      },
      {
        "ad_id": 179803630,
        "list_id": 135563694,
        "url": "https://www.chotot.com/135563694.htm",
        "title": "Apple iPhone 7 32GB",
        "description": "Iphone 7\nDung lượng 32GB, 128GB\nphiên bản quốc tế, có vân, full chức năng\nsim sóng tốt\nmà zin, ánh sáng chuẩn, lướt mượt mà\nvỏ còn đẹp, trầy nhẹ\nGiá 550k",
        "price": 550000,
        "price_string": "550.000 đ",
        "price_valid": true,
        "currency": "VND",
        "ad_type": "s",
        "category_id": 5010,
        "category_name": "Điện thoại",
        "region_id": 13000,
        "region_name": "Tp Hồ Chí Minh",
        "area_id": 13113,
        "area_name": "Quận Tân Phú",
        "ward_name": "Phường Sơn Kỳ",
        "posted_at": "2026-11-03T12:52:44.709000Z",
        "posted_relative": "5 giờ trước",
        "image": "https://cdn.chotot.com/Ga4pcUDp5SuFVCPBH_XeRtOUnUhnzsuzP0kUjC1NfPg/preset:listing/plain/dd9d6607c4e9361628fd454c1633ae99-3008835097809067737.jpg",
        "images": [
          "https://cdn.chotot.com/5jduPPrbAV1idLpaFiLH29OOpVQPuOPGJQ6kIHsKjw8/preset:view/plain/dd9d6607c4e9361628fd454c1633ae99-3008835097809067737.jpg",
          "https://cdn.chotot.com/_-o7RlNAXdYkORUajoxobHDo0GqnZw0uo3kQ3yVbdLU/preset:view/plain/1b25e529c932ad5e36193eca989dcf63-3008835096097753364.jpg",
          "https://cdn.chotot.com/3FnYyjZvxf7P9-fdRCziAJdTGUzGSZmBS7RZJkZD2KI/preset:view/plain/093aa0cb63898c4a6382bc9ce79eca79-3008835095869479606.jpg"
        ],
        "image_count": 4,
        "video_count": 1,
        "is_promoted": false,
        "seller": {
          "account_id": 2191491,
          "name": "VU XUAN DANG",
          "shop_id": "391d8bcce03c13f1738a4ecd06acca8a",
          "is_shop_verified": false,
          "is_official_store": true,
          "rating": null,
          "rating_count": null,
          "avatar": "https://cdn.chotot.com/uac2/2191491"
        },
        "phone": null,
        "phone_hidden": null,
        "latitude": 10.8060465,
        "longitude": 106.61587,
        "attributes": [
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]",
            "value": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]",
            "value": "[trimmed-depth]"
          }
        ]
      },
      {
        "ad_id": 164253622,
        "list_id": 122180693,
        "url": "https://www.chotot.com/122180693.htm",
        "title": "Bán iphone 6s",
        "description": "iphone 6s  quốc tế \nmáy đẹp \npin cao\ngiá 500\ntặng kèm sạc cáp \nship toàn quốc \ncác  bác cần mua máy liên hệ em ạ \nmáy sẵn ở aeon hà đông",
        "price": 500000,
        "price_string": "500.000 đ",
        "price_valid": true,
        "currency": "VND",
        "ad_type": "s",
        "category_id": 5010,
        "category_name": "Điện thoại",
        "region_id": 12000,
        "region_name": "Hà Nội",
        "area_id": 12086,
        "area_name": "Quận Hà Đông",
        "ward_name": "Phường Nguyễn Trãi",
        "posted_at": "2026-11-03T07:16:07.971000Z",
        "posted_relative": "10 giờ trước",
        "image": "https://cdn.chotot.com/vRXJATuSvjWRTVq1SB0NuM4tGg31pbZ4WfEaWXNiwNk/preset:listing/plain/565f3c00e97dd7ef3c353ba9809fa7e2-2943641035167932705.jpg",
        "images": [
          "https://cdn.chotot.com/8dP7zCrbgy2UIvUHlpkW1sPTOj4SIRnleF2E5zfI-S4/preset:view/plain/565f3c00e97dd7ef3c353ba9809fa7e2-2943641035167932705.jpg",
          "https://cdn.chotot.com/SMLSLJ6fWk_bxnTjInQUZArGXIWyjk-TBIs1nAVSpzc/preset:view/plain/e5accc2926bc1240f684a14169cb3f34-2943641039464392148.jpg",
          "https://cdn.chotot.com/8dEYRJpi99y1ZSanzy14wNjL6CZhvEmmeENpiQtauQI/preset:view/plain/7a65711d757f624b18e00188b691d603-2943641053272434132.jpg"
        ],
        "image_count": 6,
        "video_count": 2,
        "is_promoted": false,
        "seller": {
          "account_id": 17864227,
          "name": "Trung Hiếu",
          "shop_id": "924b0a83e9af4edb7f857ce00aa6e889",
          "is_shop_verified": false,
          "is_official_store": true,
          "rating": 4.5,
          "rating_count": 54,
          "avatar": "https://cdn.chotot.com/uac2/17864227"
        },
        "phone": null,
        "phone_hidden": null,
        "latitude": 20.969955,
        "longitude": 105.77987,
        "attributes": [
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]",
            "value": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]",
            "value": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]",
            "value": "[trimmed-depth]"
          }
        ]
      }
    ]
  }
}
Actions

What the Chợ Tốt API does

ActionDescriptionConcrete use caseKey params
searchSearch Chợ Tốt listings by keyword and/or category, narrowed by province, district, ward, price range, sale-vs-rent and seller type, sorted by date, price or relevance. Works across every vertical — second-hand goods, vehicles and property — and returns up to 50 rows a page with the price both as an integer in đồng and as the string the site prints, plus that vertical's own attribute rows.Price-intelligence teams call search to search Chợ Tốt listings by keyword and/or category, narrowed by province, district, ward, pri….q, category, region, area, ward, ...
detailOne listing in full by `ad_id` (or by its chotot.com address): title, body text, price in đồng plus the printed price string, category, province/district/ward, posting time, the whole image gallery, the public seller profile, and the complete attribute set for that vertical — capacity and warranty for a phone, rooms and direction for a house, year, mileage, fuel and gearbox for a car.Classifieds aggregators call detail to get one listing in full by `ad_id` (or by its chotot.com address).ad_id, url
categoriesThe live Chợ Tốt category tree — 14 top-level groups (property, vehicles, electronics, home & living, jobs, pets, services…) with their leaf categories and the ad types each one supports. Use it to get the `category` id that `search` needs.Resale and arbitrage tools call categories to get the live Chợ Tốt category tree.none
regionsThe live Vietnamese province/city list (63 entries) with every district inside each one. Use it to get the `region` and `area` ids that `search` filters on.Lead-generation teams call regions to get the live Vietnamese province/city list (63 entries) with every district inside each one.region
Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/chotot/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"q":"iphone","category":5010}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.chotot.search with {"q":"iphone","category":5010}.
Use cases

Who uses this API and why

  • Price-intelligence teams use Chợ Tốt to search Chợ Tốt listings by keyword and/or category, narrowed by province, district, ward, pri….
  • Classifieds aggregators use Chợ Tốt to get one listing in full by `ad_id` (or by its chotot.com address).
  • Resale and arbitrage tools use Chợ Tốt to get the live Chợ Tốt category tree.
  • Lead-generation teams use Chợ Tốt to get the live Vietnamese province/city list (63 entries) with every district inside each one.
FAQ

Questions developers ask before integrating

What is the Chợ Tốt API?

Chợ Tốt API is a ReefAPI endpoint group for chợ tốt It returns live JSON through POST requests under /chotot/v1.

Is the Chợ Tốt API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Chợ Tốt calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Chợ Tốt login or account?

No login to Chợ Tốt is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Chợ Tốt data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Chợ Tốt API use?

Chợ Tốt actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Chợ Tốt from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call chotot actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Chợ Tốt API a Chợ Tốt scraper?

It is the managed alternative to a DIY Chợ Tốt scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same chợ tốt back as clean JSON.

Why does my Chợ Tốt scraper keep getting blocked?

Most Chợ Tốt scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.

docs / chotot

Chợ Tốt

Chợ Tốt

base /chotot/v14 endpoints
post/chotot/v1/detail1 credit

One listing in full by `ad_id` (or by its chotot.com address): title, body text, price in đồng plus the printed price string, category, province/district/ward, posting time, the whole image gallery, the public seller profile, and the complete attribute set for that vertical — capacity and warranty for a phone, rooms and direction for a house, year, mileage, fuel and gearbox for a car.

ParameterAllowed / rangeDescription
ad_idoptional—Chợ Tốt ad id — the `ad_id` of a search result. This is NOT the number in the listing's web address; pass that one as `url` instead.
urloptional—Full chotot.com listing address. The number in the address is the `list_id`, which the engine resolves to the `ad_id` for you (one extra lookup). Use `ad_id` directly when you already have it.
Try in playground →
post/chotot/v1/categories1 credit

The live Chợ Tốt category tree — 14 top-level groups (property, vehicles, electronics, home & living, jobs, pets, services…) with their leaf categories and the ad types each one supports. Use it to get the `category` id that `search` needs.

Try in playground →
post/chotot/v1/regions1 credit

The live Vietnamese province/city list (63 entries) with every district inside each one. Use it to get the `region` and `area` ids that `search` filters on.

ParameterAllowed / rangeDescription
regionoptional—Return only this province/city and its districts. Omit for all 63.
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.