# dulieu-dev API

**Canonical:** https://apis.io/apis/dulieu-dev/dulieu-dev-api/  
**Provider:** dulieu-dev — https://apis.io/providers/dulieu-dev/  
**Documentation:** https://dulieu.dev/api/docs

dulieu-dev API is one of 2 APIs that [dulieu-dev](https://apis.io/providers/dulieu-dev/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

dulieu-dev API as documented publicly: 79 operations. Contract generated from the documentation by API Evangelist (2026-10-29); not the provider's own document.

## Operations (60 of 79)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/admin/users` | List all users with their roles and plans. |
| PUT | `/api/admin/users/{id}/plan` | Set a user's plan. |
| GET | `/api/bakery` | Cake & bakery prices from Vietnamese bakeries (givralbakery.com.vn, cailonuong.com). |
| GET | `/api/bakery/catalog` | Full deduplicated cake catalog — latest price per product across all crawl dates (see /groceries/catalog). |
| GET | `/api/bakery/search` | Live cake-name search (suggestions / autocomplete). |
| GET | `/api/bakery/summary` | Cake market summary grouped by occasion — counts, price range, average diameter, and how many products are priced vs quoted on request. |
| GET | `/api/blog` | Data-driven blog posts — original cross-source analysis generated from our own crawled metrics (AI-generated posts flagged via ai_generated). Newest first. |
| GET | `/api/blog/{slug}` | Single blog post including markdown body and the cross-source metric snapshot it was built from (for client-side charts). |
| GET | `/api/coffee` | Coffee prices by region. |
| GET | `/api/commodities` | All commodity prices — crude oil (WTI, Brent), international coffee futures. |
| GET | `/api/cosmetics` | Perfume & cosmetics prices from Vietnamese fragrance retailers (namperfume.net, orchard.vn, thegioinuochoa.com.vn). |
| GET | `/api/cosmetics/catalog` | Full deduplicated perfume catalog — latest price per product across all crawl dates (see /groceries/catalog). |
| GET | `/api/cosmetics/compare` | Cross-retailer price comparison: products whose EAN barcode appears at more than one store, ranked by the spread between cheapest and dearest. |
| GET | `/api/cosmetics/search` | Live perfume-name search (suggestions / autocomplete). ILIKE on name, deduplicated to latest price per product. |
| GET | `/api/cosmetics/summary` | Fragrance market summary grouped by concentration — product counts, brand diversity, price range, average VND-per-ml and average discount. |
| GET | `/api/crawl-logs` | Crawler execution history. |
| GET | `/api/crawl/progress` | Realtime progress of in-flight streaming crawls (BullMQ workers publish live counts to Redis). |
| GET | `/api/drugs` | Drug & pharmacy prices (12K+ products, COICOP 06 classified). Pharmacity, Long Chau. |
| GET | `/api/drugs/catalog` | Full deduplicated drug catalog — latest price per product across all crawl dates (see /groceries/catalog). Pro plan required. |
| GET | `/api/drugs/search` | Live drug-name search (suggestions / autocomplete). |
| GET | `/api/drugs/stores` | Pharmacy product counts and latest crawl dates. |
| GET | `/api/drugs/summary` | Drug category averages with COICOP 06 codes and drug/Rx counts. |
| GET | `/api/electronics/catalog` | Full deduplicated electronics catalog — latest priced reading per product seen in the last 14 days (the live catalogue; the same set /electronics/stores coun... |
| GET | `/api/electronics/search` | Live product-name search (suggestions / autocomplete). ILIKE on name, deduplicated to latest price per product, `_raw` stripped (see /groceries/search). |
| GET | `/api/electronics/stores` | Electronics store product counts and latest crawl dates. |
| GET | `/api/electronics/summary` | Electronics store-level summary — product counts, avg prices, brand/category diversity, ratings. |
| GET | `/api/exchange` | GET /api/exchange |
| GET | `/api/fuel` | Fuel prices (6 types, zone 1 & 2). |
| GET | `/api/geo` | Vietnamese administrative geography (provinces, districts, wards). |
| GET | `/api/geo/forward` | Forward geocoding (address → coordinates). Google Geocoding API-compatible response format. |
| GET | `/api/geo/resolve` | Resolve a Vietnamese location — a name (e.g. 'Q7, Nguyễn Thị Thập', 'HCM Tân Thuận') or a Google Maps URL/short-url — to structured admin units (province/dis... |
| GET | `/api/geo/reverse` | Reverse geocoding (coordinates → address). Google Geocoding API-compatible response format. |
| GET | `/api/geo/stats` | Persistent geo API usage analytics: total calls, cache hit rate, API calls saved, provider breakdown, top uncached queries. |
| GET | `/api/geo/usage` | Provider API call usage counters since server start. Tracks geocode.maps.co call counts. |
| GET | `/api/geo/vnsdi-provinces` | Official VNSDI 34-province boundaries (Resolution 202/2025/QH15, post-merger, WGS84) as a simplified GeoJSON FeatureCollection. |
| GET | `/api/gold` | GET /api/gold |
| GET | `/api/groceries` | Grocery prices (56K+ products, COICOP classified, unit pricing). Pro plan required. |
| GET | `/api/groceries/catalog` | Full deduplicated grocery catalog — the latest price per product (source_id) across ALL crawl dates, not just the latest crawl slice. Pro plan required. |
| GET | `/api/groceries/freshness` | Per-store crawl freshness — catalog_size, latest_date, days_stale, and a stale flag (≥2 days). Lets sync consumers detect when a store silently stopped updat... |
| GET | `/api/groceries/search` | Live product-name search (suggestions / autocomplete). Case-insensitive ILIKE on name, deduplicated to the latest price per product, `_raw` stripped — query ... |
| GET | `/api/groceries/stores` | Store product counts and latest crawl dates. FREE — aggregate only. |
| GET | `/api/groceries/summary` | Grocery category averages with COICOP codes. FREE — aggregate only, no product rows (the public dashboard reads it anonymously). |
| GET | `/api/holidays/vn` | Vietnamese public holidays (Bộ luật Lao động 2019, Art. 112). |
| GET | `/api/indicators` | Economic indicators (CPI, inflation, IIP). |
| GET | `/api/interest` | Bank deposit & lending rates (28+ banks, 8 terms). |
| GET | `/api/keys` | List your API keys. |
| POST | `/api/keys` | Create a new API key. |
| DELETE | `/api/keys/{id}` | Revoke an API key. Cannot be undone. |
| POST | `/api/keys/{id}/rotate` | Rotate an API key — generates a new secret while keeping the same ID. |
| GET | `/api/keys/stats` | Your API usage stats — overview, per-key breakdown, top endpoints (30d). |
| GET | `/api/lottery` | Vietnam lottery results (north/central/south, 41 provinces). |
| GET | `/api/mst/{code}` | Vietnamese company lookup by tax ID (mã số thuế). |
| GET | `/api/pepper` | Pepper prices — domestic (5 regions) + international (India Kochi). |
| GET | `/api/provinces/map` | Province GeoJSON with merge metadata. Returns Leaflet-ready official VNSDI boundary GeoJSON + per-province metrics for choropleth coloring. |
| GET | `/api/provinces/summary` | Vietnam 2025 province/ward merge summary. 63 → 34 provinces, 3,321 wards. |
| GET | `/api/provinces/wards` | Search merged wards (3,321 total). Supports search, province filter, pagination. |
| GET | `/api/realestate/agents` | Real-estate sellers (nhatot.com + guland.vn) with active-listing counts, ratings and verified/company flags. |
| GET | `/api/realestate/benchmarks` | Area-level price benchmarks — median & avg price-per-m², avg price & area aggregated from crawled listings. |
| GET | `/api/realestate/by-id/{sourceId}` | Single listing lookup by source_id. Returns the latest crawled snapshot of the listing with images array. |
| GET | `/api/realestate/estimate` | Comps-based price estimate for a specific property. |

…and 19 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/dulieu-dev/openapi/_ae-authored/dulieu-dev-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/dulieu-dev/json-schema/dulieu-dev-get-api-realestate-by-id-sourceid-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/dulieu-dev/json-schema/dulieu-dev-get-api-cosmetics-compare-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/dulieu-dev/json-schema/dulieu-dev-get-api-realestate-facets-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/dulieu-dev/json-schema/dulieu-dev-get-api-cosmetics-summary-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/dulieu-dev/json-schema/dulieu-dev-get-api-realestate-suggest-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/dulieu-dev/json-schema/dulieu-dev-get-api-electronics-summary-response-schema.json

## Other dulieu-dev APIs (1)

- [DuLieu API](https://apis.io/apis/dulieu-dev/dulieu-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/dulieu-dev/dulieu-dev-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/dulieu-dev/.