# Widget Platform (widget.vn)

> Embeddable widget platform for Vietnamese businesses. 20 widgets covering maps, payments, chat, analytics, jobs, and more. Multi-tenant, API-first, Shadow DOM isolated.

## Widgets

- Vietnam Map: Interactive SVG map of Vietnam with 63 provinces/cities.
- Store Locator: Find nearby stores/branches on an interactive map.
- VietQR Payment: Generate VietQR payment QR codes for Vietnamese banks.
- Chat Bubble: Floating chat bubble with multi-service support.
- Countdown Timer: Countdown timer for promotions, launches, and events.
- Lunar Calendar: Vietnamese lunar/solar calendar (Lich Am Duong).
- Cookie Consent: GDPR/PDPA-compliant cookie consent banner.
- Scroll to Top: Smooth scroll-to-top button that appears after scrolling.
- Top Bar Announcement: Sticky announcement bar at the top of the page.
- Page View Counter: Real-time page view counter.
- Job Board: Embeddable job listings board.
- Business Hours: Display business opening hours in card, table, or compact layout.
- Email Subscription: Email subscription popup/inline form.
- Sticky Side Roll: Sticky side banner that rolls out on hover/click.
- Download App: App download banner with QR code, App Store, and Google Play badges.
- FAQ Accordion: Frequently asked questions with accordion expand/collapse.
- Events / Mini-Games: Interactive events and mini-games widget.
- Pricing Table: Responsive pricing table with multiple tiers.
- Testimonial Showcase: Customer testimonial carousel/grid.
- Contact Form: Embeddable contact form with custom fields.

## API

Base URL: https://api.widget.vn/api/v1

- GET /widgets/:publicId/config — Widget configuration
- GET /widgets/:publicId/locations — Store locations (Store Locator)
- GET /widgets/:publicId/map-data — Map data with pins
- GET /widgets/:publicId/jobs — Job listings (Job Board)
- GET /widgets/:publicId/jobs/:slug — Single job detail
- POST /widgets/:publicId/jobs/:slug/apply — Submit job application
- POST /widgets/:publicId/subscribe — Email subscription
- POST /widgets/:publicId/contact — Contact form submission
- POST /widgets/:publicId/events — Track widget events
- GET /widgets/:publicId/stats — Widget view stats
- POST /widgets/:publicId/consent — Record cookie consent (categories, action, IP)
- GET /geo/provinces — All Vietnamese provinces
- GET /geo/provinces/:code — Province detail with districts
- GET /geo/districts/:code — District detail with wards

## Comparisons

- [Widget.vn vs Elfsight](https://api.widget.vn/so-sanh/widget-vn-vs-elfsight)
- [VietQR Widget vs Manual QR](https://api.widget.vn/so-sanh/vietqr-widget-vs-manual-qr)
- [Widget.vn vs POWr](https://api.widget.vn/so-sanh/widget-vn-vs-powr)
- [Best Widget Platform for Vietnamese Websites](https://api.widget.vn/so-sanh/best-widget-platform-vietnamese-websites)

## Tutorials

50 step-by-step tutorials for embedding widgets into WordPress, Shopify, Wix, Squarespace, and custom HTML.

- [All tutorials](https://api.widget.vn/blog)

## Links

- [Full documentation for LLMs](https://api.widget.vn/llms-full.txt)
- [API Health](https://api.widget.vn/health)