Catererglobal Job Scraper

Extract hospitality and catering job listings from CatererGlobal with clean, structured output. Collect titles, employers, locations, salary details, posting dates, ranking metadata, and direct job links for job monitoring, market research, and lead generation.

---

Features

• Structured job output - Collect consistent job records with clean fields and direct source links
• Search by keyword or location - Target chef, hotel, restaurant, and broader hospitality searches
• Direct search URL support - Start from a CatererGlobal result page when you need full control over the search context
• Pagination support - Continue through multiple result pages until your target volume is reached
• Recency filtering - Keep only jobs from the last 24 hours, 7 days, 30 days, or any time
• Duplicate protection - Save only unique job records across pages
• Clean datasets - Empty and null-heavy values are removed before items are stored

---

Use Cases

Job Monitoring

Track newly posted hospitality jobs for a role, city, or region. Build repeatable searches and compare fresh openings over time.

Recruitment Research

Review which employers are hiring, where they are hiring, and how listings are positioned in search results. This helps agencies and in-house teams monitor demand.

Salary and Market Analysis

Collect salary text, posting cadence, and location coverage to understand market trends across hospitality roles.

Competitive Intelligence

Monitor featured employers, premium placements, and search-result positioning to understand how companies present open roles.

---

Input Parameters

Parameter	Type	Required	Default	Description
startUrl	String	No	-	Direct CatererGlobal search URL. When provided, it overrides keyword and location URL building.
keyword	String	No	-	Job title or search phrase such as chef, head chef, or restaurant manager.
location	String	No	-	Search location such as London, Dubai, or United Arab Emirates.
postedWithin	String	No	any	Keep only jobs posted within any, 24h, 7d, or 30d.
results_wanted	Integer	No	100	Maximum number of unique jobs to save.
max_pages	Integer	No	20	Maximum number of search result pages to process per search URL.
proxyConfiguration	Object	No	{"useApifyProxy": false}	Optional proxy settings. Disabled by default and can be enabled when needed.

---

Output Data

Each dataset item contains a cleaned job record. Fields appear only when CatererGlobal provides a value.

Field	Type	Description
job_id	Number	Source job identifier from CatererGlobal
harmonised_id	String	Stable harmonized job identifier used for deduplication
title	String	Job title
company	String	Employer name
company_id	Number	Employer identifier
company_url	String	Employer profile URL
company_logo_url	String	Employer logo image URL
location	String	Job location text
postcode	String	Postal code when available
salary	String	Salary text from the listing
unified_salary	Object	Structured salary information when available
date_posted	String	ISO timestamp for the listing date
period_posted_date	String	ISO timestamp for the period-based posting date
publish_from_date	String	ISO timestamp for the publish start date
publish_to_date	String	ISO timestamp for the publish end date
description	String	Listing snippet or summary text
url	String	Absolute URL to the job listing
labels	Array	Listing labels when provided
top_labels	Array	Prominent labels such as NEW or FEATURED
skills	Array	Skills extracted for the listing when available
section	String	Result section such as main or regional
job_posting_sequence	Number	Posting sequence value from the result data
position_on_page	Number	Position within the page
position_absolute	Number	Absolute position in the search results
is_anonymous	Boolean	Whether the employer is anonymous
is_highlighted	Boolean	Whether the listing is highlighted
is_sponsored	Boolean	Whether the listing is sponsored
is_top_job	Boolean	Whether the listing is marked as a top job
is_traffic_from_partner	Boolean	Whether the listing comes from a partner traffic source
has_future_posting	Boolean	Whether the listing has a future posting state
fingerprint_count	Number	Fingerprint count returned by the source
work_from_home	String	Work-from-home text when available
partnership	Object	Partnership flags for the listing
travel_time	String	Travel time text when available
unified_travel_time	Object	Structured travel-time data when available
cv_to_job_score	Object	Match score data when available

---

Usage Examples

Basic Search

{
  "keyword": "chef",
  "location": "London",
  "results_wanted": 20
}

Search With Recency Filter

{
  "keyword": "restaurant manager",
  "location": "Dubai",
  "postedWithin": "7d",
  "results_wanted": 30,
  "max_pages": 5
}

Start From A Direct Search URL

{
  "startUrl": "https://www.catererglobal.com/jobs/in-london",
  "results_wanted": 50,
  "max_pages": 4
}

Enable Proxy For Higher Reliability

{
  "keyword": "chef",
  "location": "Dubai",
  "results_wanted": 30,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}

---

Sample Output

{
  "job_id": 106879677,
  "harmonised_id": "7f7d9437-c293-4f74-8b7f-83650e603123",
  "title": "Pastry Chef",
  "company": "The Curve Hotel",
  "company_id": 1119415,
  "company_url": "https://www.catererglobal.com/jobs/the-curve-hotel?cmpId=1119415&cmp=1",
  "company_logo_url": "https://www.catererglobal.com/CompanyLogos/2c075a144655440f8e953e9e4974be65.png",
  "location": "Qatar",
  "salary": "Unspecified",
  "date_posted": "2026-03-09T18:01:39.937Z",
  "period_posted_date": "2026-03-09T18:01:39.937Z",
  "publish_from_date": "2026-03-09T18:01:39.937Z",
  "publish_to_date": "2026-04-20T17:01:39.937Z",
  "description": "We are seeking a talented Pastry Chef to join our culinary team.",
  "url": "https://www.catererglobal.com/job/pastry-chef/the-curve-hotel-job106879677",
  "top_labels": [
    {
      "label": "NEW",
      "type": "NEW"
    }
  ],
  "section": "main",
  "job_posting_sequence": 1,
  "position_on_page": 1,
  "position_absolute": 1,
  "is_anonymous": false,
  "is_highlighted": false,
  "is_sponsored": false,
  "is_top_job": false,
  "is_traffic_from_partner": false,
  "has_future_posting": false,
  "fingerprint_count": 1,
  "partnership": {
    "isPartnershipJob": false,
    "showPartnershipLabel": false,
    "isBackfilled": false,
    "isCrossPosted": false
  }
}

---

Tips For Best Results

Use Specific Searches

• Combine a role and location for tighter result sets
• Use startUrl when you want to preserve a search page exactly as shown on CatererGlobal

Control Collection Size

• Start with results_wanted between 20 and 50 for quick validation
• Increase max_pages only when broader coverage is needed

Use Recency Filters Carefully

• 24h is useful for alerting workflows
• 7d and 30d are better for broader market snapshots

Enable Proxy Support When Needed

• Proxy is disabled by default and only used when you enable it in input
• Use proxy configuration for more reliable collection in production
• Residential proxies are often the safest choice for repeat runs

---

Integrations

• Google Sheets - Export jobs for tracking and reporting
• Airtable - Build searchable recruitment databases
• Make - Send fresh listings into automated workflows
• Zapier - Trigger follow-up tasks when new jobs appear
• Webhooks - Deliver results to internal services

Export data in JSON, CSV, Excel, XML, or HTML from the dataset tab.

---

Frequently Asked Questions

How many jobs can I collect?

You can collect as many jobs as are available for your search, subject to the results_wanted and max_pages values you choose.

Does the actor handle pagination?

Yes. It continues through result pages until it reaches your requested item count or the available page limit.

Are duplicate records removed?

Yes. The actor keeps only unique jobs across processed pages.

Why are some fields missing from some jobs?

Not every listing includes the same metadata. Fields are only stored when the source provides a usable value.

Can I start from a CatererGlobal search page directly?

Yes. Use startUrl to run from a specific CatererGlobal result page instead of building a search from keyword and location.

---

Support

For issues or feature requests, use the Apify Console issue and support channels.

Resources

• Apify Documentation
• Apify API Reference
• Apify Scheduling

---

Legal Notice

This actor is intended for legitimate data collection and research workflows. Users are responsible for ensuring their use complies with applicable laws, platform terms, and internal data-handling requirements.