TranQui004

TranQui004 / vietfuel-api

Public

Real-time Vietnam fuel prices API, aggregating data from 11+ official distributors. Built with Node.js, Puppeteer, multi-layered caching, and includes an interactive FleetOps Demo Dashboard.

vietfuelapi-demo.pages.dev api fuel-prices nodejs puppeteer vietnam
28
4
100% credibility
Found May 02, 2026 at 24 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
JavaScript
AI Summary

A community API service delivering real-time retail fuel prices for Vietnam from 11 sources across 63 provinces with region classification.

How It Works

1
🔍 Discover fuel prices tool

You find VietFuelAPI, a free tool that gathers up-to-date gasoline prices across Vietnam from trusted sources.

2
💾 Download to your computer

Grab the ready-to-use files from the project page and save them on your machine.

3
🚀 Start the service

Run a quick launch command and watch it automatically pull fresh prices from everywhere.

4
🌐 Open the dashboard

Visit the local web page to see live prices, sources, and a real-time dashboard.

5
Pick your view
🇻🇳
National overview

Get combined prices from all sources for the whole country.

🏘️
Province prices

Check exact prices for any of Vietnam's 63 provinces, noting region differences.

✅ Prices at your fingertips

You now have instant access to accurate fuel prices anytime, perfect for trips or apps.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 24 to 28 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is vietfuel-api?

vietfuel-api delivers real-time Vietnam fuel prices via a simple Node.js REST API, pulling from 11 official distributors like Petrolimex and PVOil across 63 provinces. It handles Region 1 standard pricing and Region 2 surcharges, with endpoints for national aggregates (/api/fuel-prices), source-specific data (/api/fuel-prices/:source), province lookups (/api/fuel-prices/province/:slug), and health checks (/api/health). Developers get JSON responses under 10ms thanks to in-memory caching, plus a live dashboard demo for testing real-time github data flows.

Why is it gaining traction?

In a niche like Vietnam real time data, it stands out with no-auth access, full CORS, rate limiting, and adaptive refreshing tied to government price cycles—perfect for real time api github integrations without babysitting scrapers. The interactive FleetOps dashboard and province filtering make prototyping real time dashboard github apps instant, while fallback sources ensure reliability during outages.

Who should use this?

Logistics devs building fleet trackers or ride-sharing apps in Vietnam needing province-specific fuel costs. Dashboard builders integrating real time vietnam fuel into React/Vue apps, or backend teams embedding it in delivery route optimizers. Avoid if you're outside Vietnam or need global coverage.

Verdict

Solid for Vietnam-focused real time github projects—MIT licensed, thorough docs, PM2-ready—but 23 stars and 1.0% credibility score mean it's early; fork and monitor scrapers for production. Great starter if fuel prices are core to your app.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.