Caterer Jobs Scraper

Extract and collect hospitality and catering job listings from Caterer.com in a clean, structured dataset. Gather job titles, companies, locations, salaries, posting dates, and formatted descriptions for hiring research, market monitoring, and lead generation. Built for repeatable, scalable job data collection workflows.

Features

• Flexible search input — Run with startUrl or with keyword and location.
• Rich job coverage — Collect core listing data plus company and posting metadata.
• Dual description formats — Get both description_text and description_html.
• Duplicate-safe collection — Avoids duplicate listings within the same run.
• Pagination support — Collect across multiple result pages with clear limits.
• Optional proxy usage — Keep proxy off by default and enable only when needed.

Use Cases

Job Market Research

Track demand for specific hospitality roles across locations. Build reliable datasets for trend analysis, seasonality checks, and regional comparisons.

Recruitment Intelligence

Monitor hiring activity, salary signals, and role availability. Use consistent output for recruitment dashboards and sourcing workflows.

Lead Generation

Collect company and job listing data for outreach campaigns. Segment records by role, location, and posting freshness.

Content and Newsletter Workflows

Create automated job roundups for niche audiences. Feed fresh listings into newsletters, internal portals, or community channels.

---

Input Parameters

Parameter	Type	Required	Default	Description
startUrl	String	No	—	Direct Caterer jobs URL to start from.
keyword	String	No	"chef"	Job title or keyword query.
location	String	No	"london"	Location query used with keyword search.
results_wanted	Integer	No	20	Maximum number of jobs to save.
max_pages	Integer	No	2	Maximum number of pages to process.
proxyConfiguration	Object	No	{ "useApifyProxy": false }	Optional proxy settings for difficult targets.

---

Output Data

Each item in the dataset contains structured job listing data.

Field	Type	Description
id	Integer	Source listing ID.
job_id	Integer	Normalized job ID used in output.
title	String	Job title.
url	String	Absolute URL to the job listing.
company	String	Normalized company name.
companyName	String	Source company name field.
companyId	Integer	Source company identifier.
companyUrl	String	Company reference URL.
companyLogoUrl	String	Company logo URL when available.
location	String	Job location text.
salary	String	Salary or compensation text when available.
postCode	String	Postcode when available.
datePosted	String	Source posting date-time.
date_posted	String	Normalized ISO posting date-time.
periodPostedDate	String	Additional posting period value.
publishFromDate	String	Listing publish start date-time.
publishToDate	String	Listing publish end date-time.
description_text	String	Plain text listing description.
description_html	String	Safe formatted description (p, br, strong, ul, li).
source	String	Source website identifier.
keyword_search	String	Keyword used for this run when applicable.
location_search	String	Location used for this run when applicable.
extracted_at	String	ISO extraction timestamp.

Additional source metadata fields may appear when provided by the listing.

---

Usage Examples

Basic Keyword and Location Search

{
  "keyword": "chef",
  "location": "london",
  "results_wanted": 20,
  "max_pages": 2
}

Start from a Direct URL

{
  "startUrl": "https://www.caterer.com/jobs/chef/in-london",
  "results_wanted": 30,
  "max_pages": 3
}

Optional Proxy-Enabled Run

{
  "keyword": "restaurant manager",
  "location": "manchester",
  "results_wanted": 25,
  "max_pages": 2,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "GB"
  }
}

---

Sample Output

{
  "id": 106814258,
  "job_id": 106814258,
  "title": "Chef",
  "url": "https://www.caterer.com/job/chef/lamb-and-lion-job106814258",
  "company": "Lamb and Lion",
  "companyName": "Lamb and Lion",
  "companyId": 1451088,
  "companyUrl": "https://www.caterer.com/jobs/lamb-and-lion?cmpId=1451088&q=Lamb+and+Lion&cmp=1",
  "location": "Isle Brewers, Taunton (TA3), TA10 0AT",
  "salary": "From £26,000 to £30,000 per annum",
  "datePosted": "2026-02-26T14:42:56.81Z",
  "date_posted": "2026-02-26T14:42:56.810Z",
  "description_text": "We are looking for a chef or someone with culinary skills to join our team...",
  "description_html": "<p>We are looking for a chef or someone with culinary skills to join our team...</p>",
  "source": "caterer.com",
  "keyword_search": "chef",
  "location_search": "london",
  "extracted_at": "2026-03-10T08:10:49.068Z"
}

---

Tips for Best Results

Use Focused Search Terms

• Use specific role keywords such as chef, sous chef, or restaurant manager.
• Add location for higher relevance and cleaner datasets.

Start Small, Then Scale

• Begin with results_wanted: 20 for quick validation.
• Increase volume after confirming output quality.

Use Direct URLs for Monitoring

• Use startUrl for repeatable tracking of the same search view.
• Keep max_pages aligned with your collection goal.

Enable Proxy Only If Needed

• Keep proxy disabled for lower-cost runs.
• Enable proxy when requests are blocked or unstable.

---

Integrations

Connect the dataset with:

• Google Sheets — Build searchable tracking sheets.
• Airtable — Maintain structured hiring databases.
• Slack — Push new job alerts to channels.
• Webhooks — Trigger downstream systems automatically.
• Make — Automate enrichment and routing flows.
• Zapier — Connect jobs data with business apps.

Export Formats

• JSON — Application workflows and APIs.
• CSV — Spreadsheet filtering and analysis.
• Excel — Business reporting.
• XML — Structured integrations.

---

Frequently Asked Questions

Can I run this scraper without keyword and location?

Yes. You can run with startUrl, or use defaults from your actor input settings.

What happens if I provide startUrl and keyword/location?

startUrl is used as the run entry point.

Does the output include both plain and formatted descriptions?

Yes. Output includes description_text and description_html.

Is proxy mandatory for every run?

No. Proxy is optional and disabled by default.

Can some fields be missing in certain records?

Yes. Some listings may not publish every field, such as salary or postcode.

How do I control how much data is collected?

Use results_wanted and max_pages to control total output volume.

---

Support

For issues or feature requests, use support options in the Apify Console.

Resources

• Apify Documentation
• Apify API Reference
• Apify Schedules

---

Legal Notice

This actor is intended for lawful data collection and research. You are responsible for compliance with website terms and all applicable laws in your jurisdiction. Use collected data responsibly.