dulieu-dev

dulieu-dev API

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.

GitHub OpenAPI

Operations 79

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/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/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/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 counts as products). #
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/district/ward), coordinate #
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 updating. Pro plan required. #
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. #
GET /api/realestate/facets Distinct filter values with counts for real-estate listings. #
GET /api/realestate/fetch On-demand realtime fetch + upsert (no estimate). #
GET /api/realestate/geo Resolve a location (name or Google Maps URL) AND return matching real-estate listings in that province/district. #
GET /api/realestate/land-prices Official government land-price schedule (Bảng giá đất 2026) from guland.vn. #
GET /api/realestate/movers Listings whose price changed between their two most recent crawl snapshots — sorted by absolute change. #
GET /api/realestate/nearby Find real-estate listings within a radius of a point. Uses PostgreSQL earthdistance for great-circle distance. #
GET /api/realestate/planning Guland planning/zoning map (quy hoạch) tile layers per province. #
GET /api/realestate/sources/stats Per-source organic-activity stats for ranking BĐS sources. #
GET /api/realestate/stores Real-estate listing counts & latest crawl date by province × transaction. #
GET /api/realestate/suggest Location typeahead / autocomplete for real-estate search. Accent-insensitive prefix/substring match over province, district, and ward names with listing counts. #
GET /api/realestate/summary Real-estate market snapshot grouped by province × transaction × property type. #
GET /api/silver Silver prices (11 types). #
GET /api/snapshot Record-time cross-source metric snapshot. #
GET /api/stats API usage statistics — by key, by user, by endpoint, by day. #
GET /api/summary GET /api/summary #
GET /api/weather Weather data for 70+ Vietnamese cities (all province capitals + tourist destinations). #
GET /api/weather/forecast 5-day weather forecast for 70+ Vietnamese cities. #
GET /api/weather/summary Today's weather summary for all cities. #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/dulieu-dev/openapi/_ae-authored/dulieu-dev-openapi-generated.yml

Schemas & Data

📊
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

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/dulieu-dev:dulieu-dev-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

dulieu-dev-openapi-generated.yml Raw ↑ 
openapi: 3.1.0
info:
  title: dulieu-dev API
  version: '2026-10-29'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-29: 79 operation(s) read from 1 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; dulieu-dev has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 3
    documentation: 76
    pages-with-code: 1
    pages-read: 1
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-29'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:


# --- truncated at 32 KB (85 KB total) ---
# Full source: https://artifacts.apis.io/dulieu-dev/openapi/_ae-authored/dulieu-dev-openapi-generated.yml