VietnamYello Business Directory Scraper

Pull business listings from VietnamYello, Vietnam's national Yellow Pages directory, at scale — company names, phone and fax numbers, websites, full addresses, GPS coordinates, opening hours, registration and VAT numbers, employee counts, and review summaries across 237 categories and all 33 cities and provinces. Built for B2B sales teams, market researchers, and lead-generation agencies who need a clean, structured dataset of Vietnamese companies without copying profiles off the directory one page at a time.

Why This Scraper?

• 237 business categories across 33 cities and provinces — browse restaurants, lawyers, estate agents, doctors, and construction services in Hanoi, Ho Chi Minh City, Da Nang, Hai Phong, and every Vietnamese province, all from one run.
• Category × city cross-product in a single run — pair any category with any city (restaurants in Hanoi, lawyers in Da Nang) to narrow to exactly the segment you want, or leave one side blank to sweep a whole category or a whole city.
• GPS coordinates on every listing — latitude and longitude on each company for map plotting, territory assignment, and radius filtering, straight from the directory.
• 15+ structured fields per company — name, phone, fax, website, street address, city, categories, opening hours, and year established folded into one flat row per business.
• Official registration and VAT numbers — company registration code and VAT/tax number for KYB checks, compliance, and entity matching, wherever the business publishes them.
• Resolved website URLs, not link wrappers — the real external company domain, decoded and ready to enrich or crawl, rather than an opaque directory redirect link.
• Verified badge and platform tenure — a verified flag plus listing tenure (for example "+14 Years With Us") to prioritise established, long-standing businesses over thin profiles.
• Free-text keyword search plus paste-URL mode — search all of Vietnam for niche business types that have no dedicated category page ("seafood export", "software company"), or paste any category, city, search, or company URL directly.
• Up to 50,000 results per run — with employee-count band, a products list, and a review summary (star rating + count) enriched onto every detailed row.

Use Cases

Lead Generation

• Build B2B call lists with company name, phone, fax, and website for any category
• Assemble prospect lists for a whole city or province in one pass
• Target established businesses first using the verified flag and platform tenure
• Enrich a shortlist by pasting individual company profile URLs

Market & Competitive Research

• Map how many businesses operate in a category across Vietnamese cities
• Compare a category's footprint between Hanoi, Ho Chi Minh City, and Da Nang
• Track new and long-standing companies by year established and listing tenure
• Size a local market before entering it

B2B Sales & Territory Planning

• Plot companies on a map with per-listing GPS coordinates
• Assign sales territories by city, province, or radius
• Segment prospects by employee-count band and category
• Prioritise outreach by verified status and years on the directory

Data Enrichment & Compliance

• Match companies to registration codes and VAT numbers for KYB workflows
• Fill gaps in an existing CRM with phone, website, and address data
• Standardise messy company records against a single directory source
• Feed structured Vietnamese business data into analytics dashboards

Local SEO & Directory Aggregation

• Audit how businesses in a niche present their category, hours, and contact details
• Aggregate opening hours and product lists for local listings
• Benchmark a client's directory profile against competitors in the same city

Getting Started

Browse a Category

The simplest run — one category, 50 businesses:

{
    "categories": ["restaurants"],
    "maxResults": 50
}

Category × City

Narrow to specific categories within a city — each category is combined with each city:

{
    "categories": ["restaurants", "lawyers"],
    "locations": ["hanoi"],
    "maxResults": 200
}

Keyword Search

Search the whole directory for a business type that has no dedicated category page:

{
    "searchKeywords": ["seafood export"],
    "includeDetails": true,
    "maxResults": 100
}

Paste URLs (Advanced)

Paste category, city, or individual company profile URLs straight from your browser:

{
    "startUrls": [
        "https://www.vietnamyello.com/category/estate-agents",
        "https://www.vietnamyello.com/location/danang",
        "https://www.vietnamyello.com/company/367879/"
    ],
    "includeDetails": true,
    "maxResults": 500
}

Input Reference

What to Scrape

Parameter	Type	Default	Description
categories	string[]	["restaurants"]	Business categories, using the slug from a VietnamYello category page (e.g. restaurants, lawyers, estate-agents, doctors-and-clinics). Each category is combined with every city below. Leave empty to browse cities only.
locations	string[]	[]	Vietnamese cities or provinces, using the slug from a location page (e.g. hanoi, ho-chi-minh-city, danang, haiphong, thanh-hoa). Each city is combined with every category above. Leave empty to cover all of Vietnam.
searchKeywords	string[]	[]	Free-text terms searched across the whole directory (e.g. seafood export, software company, coffee). Use when a business type has no dedicated category page. Not narrowed by the cities above.

Or Paste URLs

Parameter	Type	Default	Description
startUrls	string[]	[]	Paste VietnamYello category, city, search, or individual company profile links directly. When provided, the Categories, Cities, and Search Keywords above are ignored.

Options

Parameter	Type	Default	Description
includeDetails	boolean	true	Open each company profile to add the full record — website, fax, opening hours, description, year established, employee count, registration code, VAT number, products, and review summary. Turn off for a faster, lighter run that returns just the core listing fields.
maxResults	integer	100	Total number of businesses to collect across all categories, cities, keywords, and URLs. Set to 0 for as much as possible. A safety ceiling of 50,000 applies to every run.

Output

Each result is one flat row per company. Here is a representative row with full details enabled:

{
    "companyName": "Mandarine Restaurant",
    "companyUrl": "https://www.vietnamyello.com/company/367879/mandarine-restaurant",
    "companyId": "367879",
    "phone": "+84 24 3823 9314",
    "fax": "+84 24 3823 9315",
    "website": "https://www.mandarine-restaurant.com",
    "streetAddress": "24 Phan Boi Chau Street, Hoan Kiem District",
    "city": "Hanoi",
    "country": "VN",
    "latitude": 21.024398,
    "longitude": 105.843242,
    "categories": ["Restaurants", "Vietnamese Cuisine"],
    "description": "Fine Vietnamese dining in the heart of Hanoi's Old Quarter...",
    "openingHours": ["Mon-Sun: 11:00 - 22:00"],
    "yearEstablished": "2000",
    "employeeCount": "51-100",
    "registrationCode": "0101234567",
    "vatNumber": "0101234567",
    "contactPerson": "Nguyen Van A",
    "verified": true,
    "listingType": "+14 Years With Us",
    "products": ["Set Menus", "Private Dining"],
    "reviewCount": 3,
    "reviewRating": 4.5,
    "logo": "https://www.vietnamyello.com/uploads/367879-logo.jpg",
    "searchType": "category",
    "searchTerm": "restaurants",
    "searchCity": "hanoi",
    "scrapedAt": "2026-07-16T14:30:00Z"
}

Core Business Fields

Field	Type	Description
companyName	string	Business name
companyUrl	string	VietnamYello profile URL
companyId	string	Numeric profile identifier
phone	string	Primary phone number
fax	string	Fax number (detail)
website	string	Resolved external company website (detail)
categories	string[]	Business categories and tags
description	string	Business description (detail)
logo	string	Logo / primary image URL
scrapedAt	string	ISO timestamp of extraction

Address & Location

Field	Type	Description
streetAddress	string	Street address
city	string	City or locality
country	string	Country code (VN)
latitude	number	GPS latitude
longitude	number	GPS longitude

Company Profile

Populated when includeDetails is on.

Field	Type	Description
yearEstablished	string	Year the business was founded
employeeCount	string	Employee band, e.g. "51-100"
registrationCode	string	Company registration code
vatNumber	string	VAT / tax registration number
contactPerson	string	Named contact, when listed
openingHours	string[]	Opening-hours lines
products	string[]	Products and services listed on the profile

Reviews, Status & Provenance

Field	Type	Description
reviewCount	number	Number of reviews on the profile
reviewRating	number	Average star rating
verified	boolean	Verified-listing flag
listingType	string	Listing tier / platform tenure, e.g. "+14 Years With Us"
searchType	string	How this row was found: category, location, keyword, or url
searchTerm	string	The category or keyword that produced this row
searchCity	string	The city slug that produced this row, when applicable

Tips for Best Results

• Start small. Set maxResults to 25-50 on your first run to confirm the data matches your needs, then scale up.
• Combine a category with a city to narrow, leave one blank to widen. Pairing categories and locations targets one exact segment (restaurants in Hanoi); an empty locations sweeps the whole category across Vietnam, and an empty categories grabs every business in a city.
• Copy slugs from the address bar. The category slug is the part after /category/ and the city slug is the part after /location/ in any VietnamYello URL — always lowercase and hyphenated (e.g. ho-chi-minh-city).
• Use keyword search for niche business types. When a trade has no dedicated category page, searchKeywords searches the entire directory across all of Vietnam.
• Toggle details for speed vs. depth. Turn includeDetails off for a fast listing-only sweep of names, phones, GPS, and categories; turn it on when you need website, registration code, VAT number, employees, and hours.
• Filter to established businesses. The verified flag and listingType tenure ("+N Years With Us") are the best signals for prioritising long-standing companies before you spend a run enriching profiles.
• Treat reviews as a bonus. Review density on this directory is low, so use reviewCount and reviewRating as a supporting signal rather than a primary filter.

Pricing

From $0.40 per 1,000 results — a single flat rate that includes full company detail and keyword search at no premium. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier.

Results	No discount	Bronze	Silver	Gold
100	$0.048	$0.045	$0.043	$0.040
1,000	$0.48	$0.45	$0.43	$0.40
10,000	$4.80	$4.50	$4.30	$4.00
100,000	$48.00	$45.00	$43.00	$40.00

A "result" is any company row in the output dataset. There are no compute or time-based charges — you pay per result, plus a small fixed per-run start fee.

Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

• Zapier / Make / n8n — Workflow automation
• Google Sheets — Direct spreadsheet export
• Slack / Email — Notifications on new results
• Webhooks — Trigger custom APIs on run completion
• Apify API — Full programmatic access

Legal & Ethical Use

This actor is designed for legitimate business research, market analysis, and lead generation. Users are responsible for complying with applicable laws and VietnamYello's Terms of Service. Do not use extracted data for spam, harassment, or any unlawful purpose, and handle any personal contact details in line with applicable data-protection regulations.