Vietnam Business Directory Scraper

Scrape Vietnam's largest B2B business directory, Trang Vàng Việt Nam (Yellow Pages Vietnam) — 250,000+ companies across 3,400+ industries and all 63 provinces/cities. Search by keyword, browse an industry category, browse every business in a province, or fetch specific business profiles by URL. Get contact details, tax ID, founding year, employee count, product catalog, and product/company photos. No login, no cookies, no proxy required.

What this actor does

• Four modes: search (keyword + optional province), byCategory (browse an industry), byProvince (browse a whole province), byListingUrls (direct profile fetch)
• All 63 Vietnamese provinces/cities available as a dropdown filter
• Optional full-profile enrichment — tax ID, founding year, employee count, business type, full product catalog, image gallery, and contact person, with one extra request per result
• Data-quality filters — skip businesses flagged by the site itself as outdated, or keep only "verified" (self-confirmed) businesses
• Empty fields are always omitted — no null/blank/placeholder values in the output

Output per business

• businessName, englishName (full profile only)
• industry, categories[] (full profile only — every industry tag)
• address, province
• phone, hotline, zaloUrl, email, website
• logoUrl, imageUrls[], imageGallery[] (full profile only — with captions)
• description, fullDescription (full profile only — untruncated)
• taxId, foundingYear, employeeRange, businessType (full profile only)
• contactPersonName, contactPersonRole (full profile only)
• products[] (full profile only — product/service catalog with links)
• englishProfileUrl (full profile only, when the business has an English-language profile)
• isSponsored, isVerified, isOutdated, lastUpdatedDate
• sourceUrl, listingId
• recordType: "business", scrapedAt

Input

Field	Type	Default	Description
mode	select	search	search / byCategory / byProvince / byListingUrls
searchQuery	string	–	Industry, product/service, or company name (required for search; optional for byProvince)
province	select	(none)	One of 63 Vietnamese provinces/cities (required for byProvince; optional refinement elsewhere)
categoryUrl	string	–	Full category page URL (mode=byCategory) — find one via the site's A-Z industry index
listingUrls	array	–	Full business profile URLs to fetch directly (mode=byListingUrls)
fetchFullProfile	boolean	false	Fetch each business's own profile page for the extra fields listed above
verifiedOnly	boolean	false	Only keep businesses carrying the site's "verified" badge
excludeOutdated	boolean	false	Skip listings the site flags as no-longer-accurate
maxItems	integer	30	Hard cap on emitted records (1–500)

Example: search an industry in one city

{
  "mode": "search",
  "searchQuery": "công ty may mặc",
  "province": "Hà Nội",
  "maxItems": 50
}

Example: browse an entire industry category with full profiles

{
  "mode": "byCategory",
  "categoryUrl": "https://trangvangvietnam.com/categories/152060/co-khi--gia-cong-va-che-tao.html",
  "fetchFullProfile": true,
  "maxItems": 100
}

Example: every business registered in a province

{
  "mode": "byProvince",
  "province": "Tp. Đà Nẵng",
  "maxItems": 200
}

Example: fetch specific business profiles

{
  "mode": "byListingUrls",
  "listingUrls": [
    "https://trangvangvietnam.com/listings/1187701125/prosteel-techno-viet-nam-cong-ty-tnhh-prosteel-techno-viet-nam.html"
  ]
}

Use cases

• Supplier sourcing — find manufacturers, distributors, or service providers by industry and province before reaching out
• Market research — measure supplier density and coverage for an industry across Vietnam
• Sales & lead generation — build a contact list of businesses (phone, email, website) filtered by category and location
• Company enrichment — pull tax ID, founding year, and employee-count bands for businesses you already have URLs for
• Competitive analysis — pull an entire industry category's product catalogs and photos

FAQ

What's Trang Vàng Việt Nam? Vietnam's long-running B2B yellow-pages directory (operating since 2008), listing 250,000+ businesses across 3,400+ industry categories and every province/city.

Do I need an API key, login, or proxy? No — the actor reads the site's public pages directly with no authentication and no proxy.

What's the difference between search and byProvince? search requires a keyword and treats province as an optional refinement. byProvince browses every business registered in a province, with no keyword required.

What does "verified" mean? A green "Xác thực" badge the site shows when a business has confirmed its own tax ID and registration details directly with Trang Vàng — not a quality or trust rating.

What does "outdated" mean, and why would I want to exclude it? The site itself flags some older listings as "no longer accurate" (contact details may be stale). Set excludeOutdated: true to skip these.

Why are some fields (tax ID, founding year, product catalog) only present sometimes? Those come from each business's own profile page, which is only fetched when fetchFullProfile is true (or always, for byListingUrls). Turning it on adds one extra request per result.

Why do some businesses have no phone or email? Not every listing supplies contact details, and the actor never fabricates placeholder values — a missing field means the business genuinely didn't provide it (or the listing is flagged outdated with stale contact info).

Can I find a categoryUrl for byCategory mode? Yes — browse trangvangvietnam.com/findex (A–Z industry index) on the site, open any category, and copy its URL.

How fresh is the data? Businesses update their own listings continuously; the actor always reads the live page at run time.

Why does a sourceUrl sometimes show a brief "Checking your browser" page when I click it? trangvangvietnam.com sits behind Cloudflare, which occasionally shows a one-time automated browser check to visitors whose IP has a lower reputation score (e.g. some VPN/hosting ranges). This resolves automatically in a normal browser and does not affect the actor's own scraping, which runs from a clean IP pool and is unaffected.