TopCV Scraper
Pricing
from $2.00 / 1,000 results
Search Vietnamese job listings on TopCV.vn by keyword and/or city and pull full job details (description, requirements, benefits, salary, employer info) -- no account or API key needed.
Input
_input
Optional
The keyword/city search or job ID/URL that produced this record.
Source strategy
_source
Optional
S1-jsonld (full-detail record, from the job page's own JobPosting JSON-LD), S1-html-search (compact search-summary record, from the SSR search results HTML), or none on failure.
Scraped at
_scrapedAt
Optional
UTC ISO 8601 timestamp when this record was scraped.
Error
_error
Optional
Present only on failed extractions (e.g. not_found, invalid_input, invalid_city).
Error detail
_errorDetail
Optional
Free-form diagnostic detail, present only alongside _error.
Warning
_warning
Optional
Present only when a search result's detail fetch failed and this record fell back to the compact search-summary fields instead (detail_fetch_failed_used_search_summary).
Job ID
job_id
Optional
Search-summary record -- topcv.vn's numeric job ID.
Job title
title
Optional
Both record shapes.
Job URL
url
Optional
Search-summary record -- canonical topcv.vn/viec-lam/.../.html link.
Company name
company_name
Optional
Search-summary record.
Company URL
company_url
Optional
Search-summary record -- topcv.vn/cong-ty/... link.
Company logo URL
company_logo_url
Optional
Search-summary record.
Salary (as displayed)
salary_text
Optional
Search-summary record -- e.g. "Tới 45 triệu" or "Thoả thuận" (negotiable), as shown on the site, not parsed into a number.
City / province
city
Optional
Search-summary record.
Experience required (as displayed)
experience_text
Optional
Search-summary record -- e.g. "5 năm".
Posted (relative, as displayed)
posted_text
Optional
Search-summary record -- e.g. "hôm nay".
Updated (relative, as displayed)
posted_updated_text
Optional
Search-summary record -- e.g. "Cập nhật 3 phút trước".
Verified employer
is_verified_employer
Optional
Search-summary record -- whether topcv.vn shows its verified-employer badge.
Full description
description
Optional
Full-detail record -- HTML-formatted job description, requirements, and benefits combined (topcv.vn's own JobPosting.description).
Employer identifier
identifier
Optional
Full-detail record -- {name, value} where value is the employer's numeric company ID.
Date posted
datePosted
Optional
Full-detail record -- ISO 8601 date.
Valid through
validThrough
Optional
Full-detail record -- ISO 8601 expiry timestamp.
Employment type
employmentType
Optional
Full-detail record -- e.g. FULL_TIME.
Hiring organization
hiringOrganization
Optional
Full-detail record -- {name, sameAs (company page URL), logo}.
Job location
jobLocation
Optional
Full-detail record -- {address: {streetAddress, addressLocality, addressRegion, postalCode, addressCountry}}.
Base salary
baseSalary
Optional
Full-detail record -- {currency, value: {unitText, minValue?, maxValue?}}. When the employer marks salary negotiable, value.value holds the literal Vietnamese string "Thoả thuận" instead of a numeric minValue/maxValue -- confirmed live, not a parsing gap.
Industry
industry
Optional
Full-detail record.
Job benefits
jobBenefits
Optional
Full-detail record -- HTML-formatted, also included inline within description.
Employer overview / responsibilities
employerOverview
Optional
Full-detail record -- HTML-formatted, also included inline within description.
Occupational category
occupationalCategory
Optional
Full-detail record -- e.g. "Nhân viên".
Experience requirements
experienceRequirements
Optional
Full-detail record -- {monthsOfExperience}.
Skills
skills
Optional
Full-detail record -- comma-separated skill/keyword string.
Total job openings
totalJobOpenings
Optional
Full-detail record -- number of open headcount for this posting.
