{ "data": { "id": "TJjUQ7nV32MbcqsSD", "actId": "7RmIU4jIs8a7yOKmM", "userId": "zq8lKbpLzTjGDayPC", "startedAt": "2026-10-18T14:37:31.531Z", "finishedAt": "2026-10-18T14:37:35.085Z", "status": "SUCCEEDED", "meta": { "origin": "CLI" }, "stats": { "durationMillis": 3472, "runTimeSecs": 3.472, "computeUnits": 0.0038577777777777777, "imageSizeBytes": 318846464 }, "options": { "useCache": true, "betaPackages": false, "memoryMbytes": 4096, "diskMbytes": 8192 }, "createdByOrganizationMemberUserId": "GK9YjZRyQZVzOdoH5", "exitCode": 0, "inputSchema": "{\n \"title\": \"Hcareers Hospitality Jobs Scraper Input\",\n \"description\": \"Search Hcareers jobs by keyword, location, state/province, category or brand, walk the site's full jobs index, fetch specific job posting URLs, or scrape employer profiles.\",\n \"type\": \"object\",\n \"schemaVersion\": 1,\n \"properties\": {\n \"mode\": {\n \"title\": \"Mode\",\n \"type\": \"string\",\n \"description\": \"What to fetch.\",\n \"editor\": \"select\",\n \"enum\": [\n \"search\",\n \"allJobs\",\n \"byUrls\",\n \"employers\"\n ],\n \"enumTitles\": [\n \"Search / browse jobs\",\n \"Every open job (full inventory)\",\n \"Fetch specific job URLs\",\n \"Company / employer profiles\"\n ],\n \"default\": \"search\",\n \"prefill\": \"search\"\n },\n \"keywords\": {\n \"title\": \"Keywords\",\n \"type\": \"string\",\n \"description\": \"Free-text search terms (job title, skill, employer/brand name). Leave empty to browse by category/state/brand only. (mode=search)\",\n \"editor\": \"textfield\",\n \"prefill\": \"chef\"\n },\n \"location\": {\n \"title\": \"Location\",\n \"type\": \"string\",\n \"description\": \"City, region, or landmark to search near (e.g. `New York, NY`, `Miami Beach`). (mode=search)\",\n \"editor\": \"textfield\"\n },\n \"state\": {\n \"title\": \"State / Province\",\n \"type\": \"string\",\n \"description\": \"Restrict to a US state or Canadian province. Oregon, Puerto Rico and Quebec are kept for older saved tasks; they have no current Hcareers postings. (mode=search)\",\n \"editor\": \"select\",\n \"enum\": [\n \"AL\",\n \"AR\",\n \"AZ\",\n \"BC\",\n \"CA\",\n \"CO\",\n \"CT\",\n \"DC\",\n \"DE\",\n \"FL\",\n \"GA\",\n \"HI\",\n \"IA\",\n \"ID\",\n \"IL\",\n \"IN\",\n \"KS\",\n \"KY\",\n \"LA\",\n \"MA\",\n \"MD\",\n \"ME\",\n \"MI\",\n \"MN\",\n \"MO\",\n \"MS\",\n \"MT\",\n \"NC\",\n \"NH\",\n \"NJ\",\n \"NM\",\n \"NS\",\n \"NV\",\n \"NY\",\n \"OH\",\n \"OK\",\n \"ON\",\n \"OR\",\n \"PA\",\n \"PR\",\n \"QC\",\n \"RI\",\n \"SC\",\n \"TN\",\n \"TX\",\n \"UT\",\n \"VA\",\n \"VT\",\n \"WA\",\n \"WI\",\n \"WV\",\n \"WY\"\n ],\n \"enumTitles\": [\n \"Alabama\",\n \"Arkansas\",\n \"Arizona\",\n \"British Columbia (Canada)\",\n \"California\",\n \"Colorado\",\n \"Connecticut\",\n \"District of Columbia\",\n \"Delaware\",\n \"Florida\",\n \"Georgia\",\n \"Hawaii\",\n \"Iowa\",\n \"Idaho\",\n \"Illinois\",\n \"Indiana\",\n \"Kansas\",\n \"Kentucky\",\n \"Louisiana\",\n \"Massachusetts\",\n \"Maryland\",\n \"Maine\",\n \"Michigan\",\n \"Minnesota\",\n \"Missouri\",\n \"Mississippi\",\n \"Montana\",\n \"North Carolina\",\n \"New Hampshire\",\n \"New Jersey\",\n \"New Mexico\",\n \"Nova Scotia (Canada)\",\n \"Nevada\",\n \"New York\",\n \"Ohio\",\n \"Oklahoma\",\n \"Ontario (Canada)\",\n \"Oregon (no current postings)\",\n \"Pennsylvania\",\n \"Puerto Rico (no current postings)\",\n \"Quebec (Canada, no current postings)\",\n \"Rhode Island\",\n \"South Carolina\",\n \"Tennessee\",\n \"Texas\",\n \"Utah\",\n \"Virginia\",\n \"Vermont\",\n \"Washington\",\n \"Wisconsin\",\n \"West Virginia\",\n \"Wyoming\"\n ]\n },\n \"category\": {\n \"title\": \"Job category\",\n \"type\": \"string\",\n \"description\": \"Restrict to a specific hospitality job category. (mode=search)\",\n \"editor\": \"select\",\n \"enum\": [\n \"administrative\",\n \"bartender-mixologist\",\n \"catering-banquet\",\n \"chefs-kitchen\",\n \"development-construction\",\n \"engineering-maintenance\",\n \"executive\",\n \"finance-accounting\",\n \"food-and-beverage\",\n \"food-service\",\n \"gaming\",\n \"general-manager\",\n \"guest-services\",\n \"housekeeping\",\n \"human-resources\",\n \"internships\",\n \"meetings-events\",\n \"operations\",\n \"recreation-entertainment\",\n \"revenue\",\n \"rooms\",\n \"sales-and-marketing\",\n \"security\",\n \"spa\",\n \"technology\",\n \"transportation\"\n ],\n \"enumTitles\": [\n \"Administrative\",\n \"Bartender/Mixologist\",\n \"Catering/Banquet\",\n \"Chefs/Kitchen\",\n \"Development/Construction\",\n \"Engineering/Maintenance\",\n \"Executive/Corporate\",\n \"Finance/Accounting\",\n \"Food & Beverage\",\n \"Food Service\",\n \"Gaming/Casino\",\n \"General Manager\",\n \"Guest Services\",\n \"Housekeeping\",\n \"Human Resources\",\n \"Internships\",\n \"Meetings/Events\",\n \"Operations\",\n \"Recreation/Entertainment\",\n \"Revenue Management\",\n \"Rooms Division\",\n \"Sales & Marketing\",\n \"Security\",\n \"Spa\",\n \"Technology/IT\",\n \"Transportation\"\n ]\n },\n \"brand\": {\n \"title\": \"Hotel brand\",\n \"type\": \"string\",\n \"description\": \"Restrict to jobs at properties of a specific hotel brand or group. (mode=search)\",\n \"editor\": \"select\",\n \"enum\": [\n \"ac-hotels\",\n \"aloft-hotels\",\n \"autograph-collection\",\n \"baymont-inn-suites\",\n \"best-western\",\n \"cambria-hotels\",\n \"candlewood-suites\",\n \"canopy-by-hilton\",\n \"courtyard-by-marriott\",\n \"crowne-plaza\",\n \"curio-collection\",\n \"doubletree-by-hilton\",\n \"element-hotels\",\n \"embassy-suites\",\n \"fairfield-by-marriott\",\n \"fairmont\",\n \"four-points-by-sheraton\",\n \"four-seasons\",\n \"grand-hyatt\",\n \"hampton\",\n \"hilton\",\n \"hilton-garden-inn\",\n \"holiday-inn\",\n \"holiday-inn-express\",\n \"home2-suites\",\n \"homewood-suites\",\n \"hyatt-centric\",\n \"hyatt-place\",\n \"hyatt-regency\",\n \"independent\",\n \"intercontinental-hotels-resorts\",\n \"la-quinta-inns-suites\",\n \"marriott-hotels\",\n \"moxy-hotels\",\n \"omni\",\n \"park-hyatt\",\n \"residence-inn-by-marriott\",\n \"sheraton\",\n \"sofitel\",\n \"springhill-suites-by-marriott\",\n \"staybridge-suites\",\n \"studio-6\",\n \"tapestry-collection\",\n \"tempo\",\n \"the-luxury-collection\",\n \"towneplace-suites-by-marriott\",\n \"tribute-portfolio\",\n \"westin\",\n \"wyndham\"\n ],\n \"enumTitles\": [\n \"AC Hotels\",\n \"Aloft Hotels\",\n \"Autograph Collection\",\n \"Baymont Inn & Suites\",\n \"Best Western\",\n \"Cambria Hotels\",\n \"Candlewood Suites\",\n \"Canopy by Hilton\",\n \"Courtyard by Marriott\",\n \"Crowne Plaza\",\n \"Curio Collection\",\n \"Doubletree by Hilton\",\n \"Element Hotels\",\n \"Embassy Suites\",\n \"Fairfield by Marriott\",\n \"Fairmont\",\n \"Four Points by Sheraton\",\n \"Four Seasons\",\n \"Grand Hyatt\",\n \"Hampton\",\n \"Hilton\",\n \"Hilton Garden Inn\",\n \"Holiday Inn\",\n \"Holiday Inn Express\",\n \"Home2 Suites\",\n \"Homewood Suites\",\n \"Hyatt Centric\",\n \"Hyatt Place\",\n \"Hyatt Regency\",\n \"Independent\",\n \"InterContinental Hotels & Resorts\",\n \"La Quinta Inns & Suites\",\n \"Marriott Hotels\",\n \"Moxy Hotels\",\n \"Omni\",\n \"Park Hyatt\",\n \"Residence Inn by Marriott\",\n \"Sheraton\",\n \"Sofitel\",\n \"SpringHill Suites by Marriott\",\n \"Staybridge Suites\",\n \"Studio 6\",\n \"Tapestry Collection\",\n \"Tempo\",\n \"The Luxury Collection\",\n \"TownePlace Suites by Marriott\",\n \"Tribute Portfolio\",\n \"Westin\",\n \"Wyndham\"\n ]\n },\n \"remoteOnly\": {\n \"title\": \"Remote jobs only\",\n \"type\": \"boolean\",\n \"description\": \"Only remote-eligible positions. On its own this uses Hcareers' dedicated remote list; combined with other filters it keeps only remote matches of the combined search. (mode=search)\",\n \"default\": false,\n \"prefill\": false\n },\n \"employmentTypes\": {\n \"title\": \"Employment type\",\n \"type\": \"array\",\n \"description\": \"Keep only jobs whose listing badges match one of the selected types. (mode=search)\",\n \"editor\": \"select\",\n \"items\": {\n \"type\": \"string\",\n \"enum\": [\n \"Full-Time\",\n \"Part-Time\",\n \"Temporary\",\n \"On-Call\",\n \"Seasonal\"\n ],\n \"enumTitles\": [\n \"Full-time\",\n \"Part-time\",\n \"Temporary\",\n \"On-call\",\n \"Seasonal\"\n ]\n },\n \"default\": [],\n \"prefill\": []\n },\n \"jobUrls\": {\n \"title\": \"Job URLs (mode=byUrls)\",\n \"type\": \"array\",\n \"description\": \"Direct Hcareers job posting URLs or job IDs, e.g. `https://www.hcareers.com/jobs/4239412-bell-person` or `4239412`.\",\n \"editor\": \"stringList\",\n \"default\": [],\n \"prefill\": []\n },\n \"employerUrls\": {\n \"title\": \"Employer profiles (mode=employers)\",\n \"type\": \"array\",\n \"description\": \"Hcareers employer profile URLs or slugs, e.g. `https://www.hcareers.com/omni-hotels-resorts` or `grand-casinos`.\",\n \"editor\": \"stringList\",\n \"default\": [],\n \"prefill\": []\n },\n \"includeEmployerJobs\": {\n \"title\": \"Include employer's open jobs\",\n \"type\": \"boolean\",\n \"description\": \"Also collect each employer's open job postings beside its profile. (mode=employers)\",\n \"default\": true,\n \"prefill\": true\n },\n \"fetchFullDescription\": {\n \"title\": \"Fetch full job descriptions\",\n \"type\": \"boolean\",\n \"description\": \"In mode=search, visit each job's detail page for the full description, pay, apply link, photos and property profile. Always on for mode=allJobs and mode=byUrls. (mode=search)\",\n \"default\": true,\n \"prefill\": true\n },\n \"updatedSince\": {\n \"title\": \"Only jobs updated since (mode=allJobs)\",\n \"type\": \"string\",\n \"description\": \"Optional cutoff for incremental runs — a date `2026-10-11` or a full timestamp `2026-10-11T08:30:00`. Only jobs whose Hcareers index entry changed on/after it are returned.\",\n \"editor\": \"textfield\"\n },\n \"maxItems\": {\n \"title\": \"Max items\",\n \"type\": \"integer\",\n \"description\": \"Hard cap on emitted records (jobs plus employer profiles).\",\n \"minimum\": 1,\n \"maximum\": 5000,\n \"default\": 24,\n \"prefill\": 24\n }\n },\n \"required\": [\n \"mode\"\n ]\n}", "readme": "# Hcareers Hotel & Restaurant Job Finder by Category\n\n[Hcareers](https://www.hcareers.com) is the dedicated job board for hotels, resorts, restaurants, casinos and the wider hospitality industry. This actor searches it by keyword, city, state/province, any of its 26 job categories or 49 hotel brands, walks the site's entire jobs index, fetches specific job postings, and scrapes employer profiles — returning pay ranges, perks, apply links, photos, full descriptions and property details. No login, proxy, or cookies required.\n\n## What this actor does\n\n- **Four modes:** `search` (keyword / location / state / category / brand browsing), `allJobs` (the complete open-jobs index, with an optional `updatedSince` date for incremental runs), `byUrls` (specific job postings), and `employers` (company profiles, with their open jobs)\n- **Complete filter surface:** 26 hospitality job categories, 49 live state/province pages (US + Canada), 49 hotel-brand pages, free-text city search, remote-only, and employment-type filtering\n- **Rich job records:** advertised pay with parsed `salaryMin`/`salaryMax`/`salaryPeriod`, perks, the application link (employer ATS when available), photo galleries, and the employer's property profile\n- **Employer data:** company description, address, property type, property/job counts, parent brand details and sister properties\n- **Empty fields are omitted** — a field the listing genuinely lacks is left out, never sent as `null`\n\n## Output per job\n\n- `jobId`, `jobUrl`, `title`\n- `employer`, `employerLogoUrl`, `employerProfileUrl`\n- `brand`, `brandLogoUrl`, `brandProfileUrl` — parent hotel group, when the property is managed by one\n- `location`, `locationRaw`, `locationCity`, `locationState`, `locationPostalCode`, `locationCountry`\n- `category` — set when a category filter was used\n- `employmentType`, `employmentTypeBadges[]`, `isRemote`\n- `compensationRaw` — pay exactly as advertised; `salaryMin`, `salaryMax`, `salaryCurrency`, `salaryPeriod` — parsed from the advertised text (`HOUR`, `YEAR`, `MONTH`, …) only when the listing states it; `compensationAmount` — structured amount when the site provides one\n- `perks` — advertised perks (e.g. signing bonus)\n- `applyUrl` — the job's application link (employer's ATS, or Hcareers' own application flow)\n- `description` (plain text), `descriptionHtml`, `photoUrl`, `photoUrls[]`\n- `industry`, `datePosted`, `closingDate` — ISO 8601, `postedRelative` (e.g. `\"6 days ago\"`)\n- `employerAbout`, `employerAddress`, `employerPropertyType`, `employerPropertyCount`, `employerJobCount`, `brandAbout`\n- `recordType: \"job\"`, `scrapedAt`\n\n## Output per employer (mode = `employers`)\n\n- `employerName`, `employerProfileUrl`\n- `about`, `address`, `propertyType`, `propertyCount`, `jobCount`\n- `brandName`, `brandProfileUrl`, `brandAbout`\n- `properties[]` — sister properties with `name`, `location`, `jobCount`, `url`\n- `recordType: \"employer\"`, `scrapedAt`\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search` / `allJobs` / `byUrls` / `employers` |\n| `keywords` | string | – | Free-text search terms (mode=search) |\n| `location` | string | – | City/region/landmark (mode=search) |\n| `state` | select | – | US state or Canadian province with live pages (mode=search). Oregon, Puerto Rico and Quebec are kept for older saved tasks; they have no current postings |\n| `category` | select | – | One of 26 hospitality job categories (mode=search) |\n| `brand` | select | – | One of 49 hotel brands or groups (mode=search) |\n| `remoteOnly` | bool | `false` | Remote-eligible positions only (mode=search) |\n| `employmentTypes` | array (enum) | `[]` | Full-Time / Part-Time / Temporary / On-Call / Seasonal (mode=search) |\n| `jobUrls` | array | – | Job URLs or job IDs (mode=byUrls) |\n| `employerUrls` | array | – | Employer profile URLs or slugs (mode=employers) |\n| `includeEmployerJobs` | bool | `true` | Also collect the employer's open jobs (mode=employers) |\n| `fetchFullDescription` | bool | `true` | Visit each job's detail page for the full record (mode=search) |\n| `updatedSince` | string | – | Date or timestamp incremental cutoff, e.g. `2026-10-11` or `2026-10-11T08:30:00` (mode=allJobs) |\n| `maxItems` | int | `24` | Hard cap on emitted records (1–5000) |\n\n### Example: kitchen jobs in California, full-time\n\n```json\n{\n \"mode\": \"search\",\n \"category\": \"chefs-kitchen\",\n \"state\": \"CA\",\n \"employmentTypes\": [\"Full-Time\"],\n \"maxItems\": 50\n}\n```\n\n### Example: every open job, refreshed weekly\n\n```json\n{\n \"mode\": \"allJobs\",\n \"updatedSince\": \"2026-10-11\",\n \"maxItems\": 5000\n}\n```\n\n### Example: Marriott-brand remote roles\n\n```json\n{\n \"mode\": \"search\",\n \"brand\": \"marriott-hotels\",\n \"remoteOnly\": true,\n \"maxItems\": 100\n}\n```\n\n### Example: specific postings and employer profiles\n\n```json\n{\n \"mode\": \"employers\",\n \"employerUrls\": [\"omni-hotels-resorts\"],\n \"includeEmployerJobs\": true,\n \"maxItems\": 200\n}\n```\n\n## Use cases\n\n- **Hospitality recruitment intelligence** — track hiring activity by brand, state, category and property\n- **Compensation benchmarking** — aggregate advertised pay ranges by role, category, brand or region\n- **Job feeds for career sites** — refresh a hospitality job board with structured records and working apply links\n- **Employer/competitor research** — follow which properties a management group is staffing and where\n- **Labor-market datasets** — incremental exports of the whole board for analysis and dashboards\n\n## FAQ\n\n**Does this require an Hcareers account?** No — every listing, company profile and job detail page used is public.\n\n**What's the difference between `search` and `allJobs`?** `search` supports filters and returns what matches; `allJobs` walks Hcareers' complete jobs index, so it is the way to export every open posting (with `updatedSince` for incremental refresh — a date or an exact timestamp). Hcareers does not print a job category on posting pages, so `allJobs` records carry no `category`; use `search` with a category filter when you need that field.\n\n**Why is pay missing on some jobs?** Many hospitality employers don't advertise pay at all. When they do, `compensationRaw` carries the exact text and `salaryMin`/`salaryMax`/`salaryPeriod` are parsed from it; if the text can't be parsed faithfully, only the raw text is returned. Pay mentioned only informally somewhere inside the free-text description (often ambiguous — a price or discount, not a wage) is deliberately not guessed into the structured fields.\n\n**Why does `applyUrl` sometimes point back to hcareers.com?** Some employers accept applications through Hcareers' own application flow (which asks applicants for a free account); others link straight to their ATS. The actor returns whichever the posting uses.\n\n**Why do some jobs show a `brand` and others don't?** Independent properties have no parent group. When a hotel is managed by a brand or management company, Hcareers surfaces it as \"A property of: …\" and the actor includes it.\n\n**What is the property profile?** Each job's detail page includes the employer's company description, address, property type, and property and job counts; the actor copies these to `employer*` fields. Mode `employers` returns the same data as its own record, with sister properties.\n\n**Can I combine category, state, brand and keywords?** Yes — filters combine with AND logic in `search` mode.\n\n**Is this affiliated with Hcareers?** No, this is a third-party actor using only publicly visible pages.\n\n**How fresh is the data?** Every run reads live pages, so listings reflect the site at run time; new postings appear on the same day they're added.\n", "actorDefinition": { "actorSpecification": 1, "name": "hcareers-hotel-and-restaurant-job-finder", "title": "Hcareers Hotel & Restaurant Job Finder by Category", "description": "Scrape Hcareers hospitality jobs by keyword, location, state, category or brand, walk the full jobs index, fetch specific job URLs, or scrape employer profiles. Returns apply links, pay ranges, perks, photos and full descriptions.", "version": "1.0", "buildTag": "latest", "dockerfile": "./Dockerfile", "readme": "# Hcareers Hotel & Restaurant Job Finder by Category\n\n[Hcareers](https://www.hcareers.com) is the dedicated job board for hotels, resorts, restaurants, casinos and the wider hospitality industry. This actor searches it by keyword, city, state/province, any of its 26 job categories or 49 hotel brands, walks the site's entire jobs index, fetches specific job postings, and scrapes employer profiles — returning pay ranges, perks, apply links, photos, full descriptions and property details. No login, proxy, or cookies required.\n\n## What this actor does\n\n- **Four modes:** `search` (keyword / location / state / category / brand browsing), `allJobs` (the complete open-jobs index, with an optional `updatedSince` date for incremental runs), `byUrls` (specific job postings), and `employers` (company profiles, with their open jobs)\n- **Complete filter surface:** 26 hospitality job categories, 49 live state/province pages (US + Canada), 49 hotel-brand pages, free-text city search, remote-only, and employment-type filtering\n- **Rich job records:** advertised pay with parsed `salaryMin`/`salaryMax`/`salaryPeriod`, perks, the application link (employer ATS when available), photo galleries, and the employer's property profile\n- **Employer data:** company description, address, property type, property/job counts, parent brand details and sister properties\n- **Empty fields are omitted** — a field the listing genuinely lacks is left out, never sent as `null`\n\n## Output per job\n\n- `jobId`, `jobUrl`, `title`\n- `employer`, `employerLogoUrl`, `employerProfileUrl`\n- `brand`, `brandLogoUrl`, `brandProfileUrl` — parent hotel group, when the property is managed by one\n- `location`, `locationRaw`, `locationCity`, `locationState`, `locationPostalCode`, `locationCountry`\n- `category` — set when a category filter was used\n- `employmentType`, `employmentTypeBadges[]`, `isRemote`\n- `compensationRaw` — pay exactly as advertised; `salaryMin`, `salaryMax`, `salaryCurrency`, `salaryPeriod` — parsed from the advertised text (`HOUR`, `YEAR`, `MONTH`, …) only when the listing states it; `compensationAmount` — structured amount when the site provides one\n- `perks` — advertised perks (e.g. signing bonus)\n- `applyUrl` — the job's application link (employer's ATS, or Hcareers' own application flow)\n- `description` (plain text), `descriptionHtml`, `photoUrl`, `photoUrls[]`\n- `industry`, `datePosted`, `closingDate` — ISO 8601, `postedRelative` (e.g. `\"6 days ago\"`)\n- `employerAbout`, `employerAddress`, `employerPropertyType`, `employerPropertyCount`, `employerJobCount`, `brandAbout`\n- `recordType: \"job\"`, `scrapedAt`\n\n## Output per employer (mode = `employers`)\n\n- `employerName`, `employerProfileUrl`\n- `about`, `address`, `propertyType`, `propertyCount`, `jobCount`\n- `brandName`, `brandProfileUrl`, `brandAbout`\n- `properties[]` — sister properties with `name`, `location`, `jobCount`, `url`\n- `recordType: \"employer\"`, `scrapedAt`\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search` / `allJobs` / `byUrls` / `employers` |\n| `keywords` | string | – | Free-text search terms (mode=search) |\n| `location` | string | – | City/region/landmark (mode=search) |\n| `state` | select | – | US state or Canadian province with live pages (mode=search). Oregon, Puerto Rico and Quebec are kept for older saved tasks; they have no current postings |\n| `category` | select | – | One of 26 hospitality job categories (mode=search) |\n| `brand` | select | – | One of 49 hotel brands or groups (mode=search) |\n| `remoteOnly` | bool | `false` | Remote-eligible positions only (mode=search) |\n| `employmentTypes` | array (enum) | `[]` | Full-Time / Part-Time / Temporary / On-Call / Seasonal (mode=search) |\n| `jobUrls` | array | – | Job URLs or job IDs (mode=byUrls) |\n| `employerUrls` | array | – | Employer profile URLs or slugs (mode=employers) |\n| `includeEmployerJobs` | bool | `true` | Also collect the employer's open jobs (mode=employers) |\n| `fetchFullDescription` | bool | `true` | Visit each job's detail page for the full record (mode=search) |\n| `updatedSince` | string | – | Date or timestamp incremental cutoff, e.g. `2026-10-11` or `2026-10-11T08:30:00` (mode=allJobs) |\n| `maxItems` | int | `24` | Hard cap on emitted records (1–5000) |\n\n### Example: kitchen jobs in California, full-time\n\n```json\n{\n \"mode\": \"search\",\n \"category\": \"chefs-kitchen\",\n \"state\": \"CA\",\n \"employmentTypes\": [\"Full-Time\"],\n \"maxItems\": 50\n}\n```\n\n### Example: every open job, refreshed weekly\n\n```json\n{\n \"mode\": \"allJobs\",\n \"updatedSince\": \"2026-10-11\",\n \"maxItems\": 5000\n}\n```\n\n### Example: Marriott-brand remote roles\n\n```json\n{\n \"mode\": \"search\",\n \"brand\": \"marriott-hotels\",\n \"remoteOnly\": true,\n \"maxItems\": 100\n}\n```\n\n### Example: specific postings and employer profiles\n\n```json\n{\n \"mode\": \"employers\",\n \"employerUrls\": [\"omni-hotels-resorts\"],\n \"includeEmployerJobs\": true,\n \"maxItems\": 200\n}\n```\n\n## Use cases\n\n- **Hospitality recruitment intelligence** — track hiring activity by brand, state, category and property\n- **Compensation benchmarking** — aggregate advertised pay ranges by role, category, brand or region\n- **Job feeds for career sites** — refresh a hospitality job board with structured records and working apply links\n- **Employer/competitor research** — follow which properties a management group is staffing and where\n- **Labor-market datasets** — incremental exports of the whole board for analysis and dashboards\n\n## FAQ\n\n**Does this require an Hcareers account?** No — every listing, company profile and job detail page used is public.\n\n**What's the difference between `search` and `allJobs`?** `search` supports filters and returns what matches; `allJobs` walks Hcareers' complete jobs index, so it is the way to export every open posting (with `updatedSince` for incremental refresh — a date or an exact timestamp). Hcareers does not print a job category on posting pages, so `allJobs` records carry no `category`; use `search` with a category filter when you need that field.\n\n**Why is pay missing on some jobs?** Many hospitality employers don't advertise pay at all. When they do, `compensationRaw` carries the exact text and `salaryMin`/`salaryMax`/`salaryPeriod` are parsed from it; if the text can't be parsed faithfully, only the raw text is returned. Pay mentioned only informally somewhere inside the free-text description (often ambiguous — a price or discount, not a wage) is deliberately not guessed into the structured fields.\n\n**Why does `applyUrl` sometimes point back to hcareers.com?** Some employers accept applications through Hcareers' own application flow (which asks applicants for a free account); others link straight to their ATS. The actor returns whichever the posting uses.\n\n**Why do some jobs show a `brand` and others don't?** Independent properties have no parent group. When a hotel is managed by a brand or management company, Hcareers surfaces it as \"A property of: …\" and the actor includes it.\n\n**What is the property profile?** Each job's detail page includes the employer's company description, address, property type, and property and job counts; the actor copies these to `employer*` fields. Mode `employers` returns the same data as its own record, with sister properties.\n\n**Can I combine category, state, brand and keywords?** Yes — filters combine with AND logic in `search` mode.\n\n**Is this affiliated with Hcareers?** No, this is a third-party actor using only publicly visible pages.\n\n**How fresh is the data?** Every run reads live pages, so listings reflect the site at run time; new postings appear on the same day they're added.\n", "input": { "title": "Hcareers Hospitality Jobs Scraper Input", "description": "Search Hcareers jobs by keyword, location, state/province, category or brand, walk the site's full jobs index, fetch specific job posting URLs, or scrape employer profiles.", "type": "object", "schemaVersion": 1, "properties": { "mode": { "title": "Mode", "type": "string", "description": "What to fetch.", "editor": "select", "enum": [ "search", "allJobs", "byUrls", "employers" ], "enumTitles": [ "Search / browse jobs", "Every open job (full inventory)", "Fetch specific job URLs", "Company / employer profiles" ], "default": "search", "prefill": "search" }, "keywords": { "title": "Keywords", "type": "string", "description": "Free-text search terms (job title, skill, employer/brand name). Leave empty to browse by category/state/brand only. (mode=search)", "editor": "textfield", "prefill": "chef" }, "location": { "title": "Location", "type": "string", "description": "City, region, or landmark to search near (e.g. `New York, NY`, `Miami Beach`). (mode=search)", "editor": "textfield" }, "state": { "title": "State / Province", "type": "string", "description": "Restrict to a US state or Canadian province. Oregon, Puerto Rico and Quebec are kept for older saved tasks; they have no current Hcareers postings. (mode=search)", "editor": "select", "enum": [ "AL", "AR", "AZ", "BC", "CA", "CO", "CT", "DC", "DE", "FL", "GA", "HI", "IA", "ID", "IL", "IN", "KS", "KY", "LA", "MA", "MD", "ME", "MI", "MN", "MO", "MS", "MT", "NC", "NH", "NJ", "NM", "NS", "NV", "NY", "OH", "OK", "ON", "OR", "PA", "PR", "QC", "RI", "SC", "TN", "TX", "UT", "VA", "VT", "WA", "WI", "WV", "WY" ], "enumTitles": [ "Alabama", "Arkansas", "Arizona", "British Columbia (Canada)", "California", "Colorado", "Connecticut", "District of Columbia", "Delaware", "Florida", "Georgia", "Hawaii", "Iowa", "Idaho", "Illinois", "Indiana", "Kansas", "Kentucky", "Louisiana", "Massachusetts", "Maryland", "Maine", "Michigan", "Minnesota", "Missouri", "Mississippi", "Montana", "North Carolina", "New Hampshire", "New Jersey", "New Mexico", "Nova Scotia (Canada)", "Nevada", "New York", "Ohio", "Oklahoma", "Ontario (Canada)", "Oregon (no current postings)", "Pennsylvania", "Puerto Rico (no current postings)", "Quebec (Canada, no current postings)", "Rhode Island", "South Carolina", "Tennessee", "Texas", "Utah", "Virginia", "Vermont", "Washington", "Wisconsin", "West Virginia", "Wyoming" ] }, "category": { "title": "Job category", "type": "string", "description": "Restrict to a specific hospitality job category. (mode=search)", "editor": "select", "enum": [ "administrative", "bartender-mixologist", "catering-banquet", "chefs-kitchen", "development-construction", "engineering-maintenance", "executive", "finance-accounting", "food-and-beverage", "food-service", "gaming", "general-manager", "guest-services", "housekeeping", "human-resources", "internships", "meetings-events", "operations", "recreation-entertainment", "revenue", "rooms", "sales-and-marketing", "security", "spa", "technology", "transportation" ], "enumTitles": [ "Administrative", "Bartender/Mixologist", "Catering/Banquet", "Chefs/Kitchen", "Development/Construction", "Engineering/Maintenance", "Executive/Corporate", "Finance/Accounting", "Food & Beverage", "Food Service", "Gaming/Casino", "General Manager", "Guest Services", "Housekeeping", "Human Resources", "Internships", "Meetings/Events", "Operations", "Recreation/Entertainment", "Revenue Management", "Rooms Division", "Sales & Marketing", "Security", "Spa", "Technology/IT", "Transportation" ] }, "brand": { "title": "Hotel brand", "type": "string", "description": "Restrict to jobs at properties of a specific hotel brand or group. (mode=search)", "editor": "select", "enum": [ "ac-hotels", "aloft-hotels", "autograph-collection", "baymont-inn-suites", "best-western", "cambria-hotels", "candlewood-suites", "canopy-by-hilton", "courtyard-by-marriott", "crowne-plaza", "curio-collection", "doubletree-by-hilton", "element-hotels", "embassy-suites", "fairfield-by-marriott", "fairmont", "four-points-by-sheraton", "four-seasons", "grand-hyatt", "hampton", "hilton", "hilton-garden-inn", "holiday-inn", "holiday-inn-express", "home2-suites", "homewood-suites", "hyatt-centric", "hyatt-place", "hyatt-regency", "independent", "intercontinental-hotels-resorts", "la-quinta-inns-suites", "marriott-hotels", "moxy-hotels", "omni", "park-hyatt", "residence-inn-by-marriott", "sheraton", "sofitel", "springhill-suites-by-marriott", "staybridge-suites", "studio-6", "tapestry-collection", "tempo", "the-luxury-collection", "towneplace-suites-by-marriott", "tribute-portfolio", "westin", "wyndham" ], "enumTitles": [ "AC Hotels", "Aloft Hotels", "Autograph Collection", "Baymont Inn & Suites", "Best Western", "Cambria Hotels", "Candlewood Suites", "Canopy by Hilton", "Courtyard by Marriott", "Crowne Plaza", "Curio Collection", "Doubletree by Hilton", "Element Hotels", "Embassy Suites", "Fairfield by Marriott", "Fairmont", "Four Points by Sheraton", "Four Seasons", "Grand Hyatt", "Hampton", "Hilton", "Hilton Garden Inn", "Holiday Inn", "Holiday Inn Express", "Home2 Suites", "Homewood Suites", "Hyatt Centric", "Hyatt Place", "Hyatt Regency", "Independent", "InterContinental Hotels & Resorts", "La Quinta Inns & Suites", "Marriott Hotels", "Moxy Hotels", "Omni", "Park Hyatt", "Residence Inn by Marriott", "Sheraton", "Sofitel", "SpringHill Suites by Marriott", "Staybridge Suites", "Studio 6", "Tapestry Collection", "Tempo", "The Luxury Collection", "TownePlace Suites by Marriott", "Tribute Portfolio", "Westin", "Wyndham" ] }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Only remote-eligible positions. On its own this uses Hcareers' dedicated remote list; combined with other filters it keeps only remote matches of the combined search. (mode=search)", "default": false, "prefill": false }, "employmentTypes": { "title": "Employment type", "type": "array", "description": "Keep only jobs whose listing badges match one of the selected types. (mode=search)", "editor": "select", "items": { "type": "string", "enum": [ "Full-Time", "Part-Time", "Temporary", "On-Call", "Seasonal" ], "enumTitles": [ "Full-time", "Part-time", "Temporary", "On-call", "Seasonal" ] }, "default": [], "prefill": [] }, "jobUrls": { "title": "Job URLs (mode=byUrls)", "type": "array", "description": "Direct Hcareers job posting URLs or job IDs, e.g. `https://www.hcareers.com/jobs/4239412-bell-person` or `4239412`.", "editor": "stringList", "default": [], "prefill": [] }, "employerUrls": { "title": "Employer profiles (mode=employers)", "type": "array", "description": "Hcareers employer profile URLs or slugs, e.g. `https://www.hcareers.com/omni-hotels-resorts` or `grand-casinos`.", "editor": "stringList", "default": [], "prefill": [] }, "includeEmployerJobs": { "title": "Include employer's open jobs", "type": "boolean", "description": "Also collect each employer's open job postings beside its profile. (mode=employers)", "default": true, "prefill": true }, "fetchFullDescription": { "title": "Fetch full job descriptions", "type": "boolean", "description": "In mode=search, visit each job's detail page for the full description, pay, apply link, photos and property profile. Always on for mode=allJobs and mode=byUrls. (mode=search)", "default": true, "prefill": true }, "updatedSince": { "title": "Only jobs updated since (mode=allJobs)", "type": "string", "description": "Optional cutoff for incremental runs — a date `2026-10-11` or a full timestamp `2026-10-11T08:30:00`. Only jobs whose Hcareers index entry changed on/after it are returned.", "editor": "textfield" }, "maxItems": { "title": "Max items", "type": "integer", "description": "Hard cap on emitted records (jobs plus employer profiles).", "minimum": 1, "maximum": 5000, "default": 24, "prefill": 24 } }, "required": [ "mode" ] }, "output": { "actorOutputSchemaVersion": 1, "title": "Hcareers Hotel & Restaurant Job Finder by Category Output", "description": "Hospitality job postings and employer profiles from Hcareers — titles, employers, brands, locations, pay ranges, perks, apply links, full descriptions, and company details.", "properties": { "jobs": { "type": "string", "title": "Hcareers jobs & employers", "description": "Dataset containing all scraped job postings and employer profiles.", "template": "{{links.apiDefaultDatasetUrl}}/items" } } }, "storages": { "dataset": { "actorSpecification": 1, "views": { "overview": { "title": "Jobs", "transformation": { "fields": [ "title", "employer", "location", "category", "employmentType", "compensation", "jobUrl" ] }, "display": { "component": "table", "properties": {} } } } } }, "environmentVariables": {} }, "buildNumber": "1.0.2", "imageDigest": "f3857472b371a89e923b3e07339ace802c1fe10d2a97ba97bcaccc20e45bc2bb", "actVersion": { "sourceType": "SOURCE_FILES", "buildTag": "latest", "versionNumber": "1.0" }, "usage": { "ACTOR_COMPUTE_UNITS": 0.0038577777777777777 } } }