DEV Community

donerightlabs
donerightlabs

Posted on Edited on

How to get Vietnam's public procurement data (muasamcong / VNEPS) as JSON

Vietnam runs almost all public procurement through one system: the National E-Procurement System (VNEPS) at muasamcong.mof.gov.vn. Hospitals buying ultrasound machines, provinces repairing roads, ministries hiring consultants: the plan, the tender notice and the winner all end up there.

If you sell into Vietnam's public sector, advise bidders, or study the market, that portal is the best dataset in the country. It is also hard to use at scale: Vietnamese-only search, no public bulk export, and a few data quirks that will mislead you if you don't know them.

This post covers what the data contains, the traps, and how to get it as JSON.

Disclosure: I built the tool used in the last section, Vietnam Tender Intelligence on Apify. Everything before that section applies whatever tool you use.

Why the data is public

Vietnam's Law on Bidding No. 22/2023/QH15, Article 51(1) says the national e-procurement system must ensure public, unrestricted access to the information published on it. Plans, notices and results are published there by law, and you can read them without logging in.

In October 2026 the portal moved from muasamcong.mpi.gov.vn to muasamcong.mof.gov.vn (the Ministry of Planning and Investment was merged into the Ministry of Finance in 2025). Old links redirect, but update your bookmarks and scripts.

Three stages, three datasets

Stage Vietnamese name What it tells you
Procurement plan Kế hoạch lựa chọn nhà thầu (KHLCNT) What a buyer intends to purchase, with an estimated price per package, before any tender notice
Tender notice Thông báo mời thầu (TBMT) An open package: name, bidding method, closing date, location
Award result Kết quả lựa chọn nhà thầu (KQLCNT) Who won, their tax ID, the winning price and the contract duration

Most people only watch tender notices. The plans are the underrated part: a supplier who sees a hospital's plan to buy "máy xét nghiệm điện giải đồ" (electrolyte analysers) has time to prepare before the notice appears.

What a record looks like

An award result, cleaned into JSON (package IB2600553192, demining works):

{
  "ma_thong_bao": "IB2600553192",
  "ten_goi_thau": "Gói thầu số 03: Thi công rà phá bom mìn vật nổ...",
  "nha_thau_trung_thau": [
    {
      "ma_so_thue": "0105900350",
      "ten_nha_thau": "CÔNG TY TNHH MỘT THÀNH VIÊN XỬ LÝ BOM, MÌN, VẬT NỔ 319",
      "gia_trung_thau_vnd": "101.885.625.000",
      "thoi_gian_thuc_hien_goi_thau": "48 tháng"
    }
  ]
}
Enter fullscreen mode Exit fullscreen mode

A few portal codes you will see everywhere:

Code Meaning
IB… Tender notice number
PL… Procurement plan number
DTRR Đấu thầu rộng rãi: open bidding
1_MTHS Single stage, one envelope
HH Goods (hàng hoá)

Five traps in Vietnamese award data

1. Joint-venture prices repeat. When a liên danh (joint venture) wins, every member is listed with the venture's total price. A five-member venture shows the same price five times. Sum those rows and you overstate the contract five times over.

2. Drug prices can be unit prices. For medicines and medical supplies the "winning price" is often the price per tablet or vial, not the lot total. A winning price of 1,300 VND is not a typo.

3. One package, many lots. Drug and supply packages are split into lots (phần lô), each with its own winner and price. Only some lots get awarded.

4. Some winners are individuals. The bidding law lets individuals bid on small packages, and since July 2025 an individual's tax code is their 12-digit personal ID number. If you republish award data, filter those rows out.

5. Search works in Vietnamese. Package names are written in Vietnamese, so English keywords rarely match. Search "thiết bị y tế", not "medical equipment", and keep the diacritics.

Getting it as JSON

The tool I built, Vietnam Tender Intelligence, runs on Apify and returns all three stages as JSON. You choose the stage with recordType:

  • plans: procurement plans by keyword
  • notices: tender notices by keyword (open only by default)
  • awards: award results by keyword, nationwide, newest first
  • awards_by_date: every award in one province for a date range, no keyword

It handles the traps above: joint ventures are flagged with ten_lien_danh, lots get ma_phan_lo, and winners that look like individuals are redacted.

From the command line:

curl -X POST "https://api.apify.com/v2/acts/donerightlabs~tender-intelligence/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" -H "Content-Type: application/json" \
  -d '{"recordType":"plans","keywords":["camera giám sát"],"maxResultsPerKeyword":10}'
Enter fullscreen mode Exit fullscreen mode

From Python:

from apify_client import ApifyClient

client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("donerightlabs/tender-intelligence").call(run_input={
    "recordType": "awards_by_date",
    "province": "Tỉnh Gia Lai",
    "dateFrom": "12/10/2026",
    "dateTo": "19/10/2026",
    "maxResultsPerKeyword": 10,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
Enter fullscreen mode Exit fullscreen mode

From an AI assistant (MCP): point any MCP client at https://mcp.apify.com?tools=donerightlabs/tender-intelligence, sign in to Apify, and ask "Who won road construction tenders in Đà Nẵng last week?".

Cost: pay per use. One keyword search is $0.20 ($0.05 per run + $0.15 per keyword); award results add $0.03 per package. A week of awards for one province, 20 packages, is $0.80. You are not charged the search fee when a search fails.

What's next

Next in this series: reading procurement plans to spot purchases before the tender, and a no-code daily tender alert sent to Google Sheets.

If you work with Vietnamese procurement data, tell me in the comments which fields or sources you are missing.

Top comments (0)