Hcareers Hospitality Jobs Scraper

Scrape Hcareers — the leading job board for the hotel, resort, restaurant and broader hospitality industry. Search by keyword, location, or US state/Canadian province, browse by 26 hospitality job categories, filter by employment type and remote-only, or fetch specific job posting URLs directly. HTTP-only against public hcareers.com pages. No auth, no proxy, no cookies.

What this actor does

• Two modes: search (keyword / location / state / category browsing) and byUrls (fetch specific job posting URLs)
• Full category coverage: 26 hospitality job categories (Chefs/Kitchen, Front Desk & Guest Services, Housekeeping, Revenue Management, Spa, Technology/IT, etc.)
• Geographic coverage: all 47 supported US states/territories + 3 Canadian provinces, plus free-text location search
• Remote-only browsing via Hcareers' dedicated remote-jobs listing
• Employment-type filter (full-time / part-time), matched against each listing's badges
• Full job descriptions: optionally visits each job's detail page for the complete description, structured location, parent brand, and posting/expiry dates
• Empty fields are omitted

Output per job

• title, jobUrl, jobId
• employer, employerLogoUrl, brand, brandLogoUrl (parent hospitality group, when the property is managed by one)
• location, locationCity, locationState, locationPostalCode, locationCountry
• category (when filtering by category)
• employmentType, employmentTypeBadges[]
• compensationRaw (as advertised, e.g. "$18.00 to $21.00 per hour"), compensationAmount, salaryCurrency, salaryPeriod (when a structured amount is available)
• description (full plain-text job description), photoUrl, industry
• datePosted, closingDate — ISO 8601 (from detail page); postedRelative (e.g. "6 days ago", from listing)
• recordType: "job", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / byUrls
keywords	string	chef	Free-text search terms
location	string	–	City/region/landmark
state	select	–	US state or Canadian province
category	select	–	One of 26 hospitality job categories
remoteOnly	bool	false	Only remote-eligible positions
employmentTypes	array (enum)	–	Full-Time / Part-Time
jobUrls	array	–	Direct job URLs (mode=byUrls)
fetchFullDescription	bool	true	Visit detail page for full description/location/brand/dates
maxItems	int	24	Hard cap (1–1000)

Example: kitchen jobs in California, full-time

{
  "mode": "search",
  "category": "chefs-kitchen",
  "state": "CA",
  "employmentTypes": ["Full-Time"],
  "maxItems": 50
}

Example: remote hospitality roles

{
  "mode": "search",
  "remoteOnly": true,
  "maxItems": 50
}

Example: fetch specific job postings

{
  "mode": "byUrls",
  "jobUrls": ["https://www.hcareers.com/jobs/4239412-bell-person"]
}

Use cases

• Hospitality recruitment intelligence — track hiring trends across hotel brands, resorts and restaurant groups
• Compensation benchmarking — aggregate advertised pay ranges by category, state, or brand
• Franchise/brand research — discover which properties a hospitality group is actively hiring for
• Career discovery — build a filtered job feed for a specific category (e.g. Spa, Revenue Management) or region
• Remote hospitality roles — surface the (relatively rare) remote-eligible positions in the industry

FAQ

Does this require an Hcareers account? No — all listings and job detail pages scraped are publicly accessible without login.

Why do some jobs show a brand field and others don't? Many hotels are managed by a parent hospitality group (e.g. a Marriott franchisee); Hcareers surfaces this as "A property of: ...". Independent properties omit this field.

Why is compensationAmount sometimes missing? Hcareers frequently advertises pay as a free-text range (e.g. "$18.00 to $21.00 per hour") rather than a single structured number. In that case only compensationRaw is populated.

Can I combine category, state, and keywords? Yes — all filters combine with AND logic.

How fresh is the data? Hcareers lists new roles continuously; datePosted/closingDate reflect each employer's own posting dates, and postedRelative reflects the listing page's relative-time label.