# Caterer Job Scraper (`jobscrawler/caterer-job-scraper`) Actor

The latest and most advanced Caterer Job Scraper. Our new Caterer Job Scraper extracts real-time job postings at scale from all over the world. A new research tool built for recruitment, insights and HR.

- **URL**: https://apify.com/jobscrawler/caterer-job-scraper.md
- **Developed by:** [Jobs Scraper](https://apify.com/jobscrawler) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 50.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.99 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Caterer Job Scraper

Collect active **Caterer.com** job listings through CareerScope's publicly accessible syndicated job feed. No vendor API key, login or proxy is required.

The Actor selects the board's **Caterer.com** provider and only accepts individual HTTPS Caterer job URLs. Jobs from other providers are excluded.

### Output

- Original Caterer job ID and canonical application URL
- Job title, source-provided location and employment type
- Source-provided description summary
- Employer URL identifier (`employerSlug`), copied from the original Caterer URL
- CareerScope retrieval provenance, active status and retrieval time
- Salary text when the public feed provides it

Descriptions are **syndicated summaries**, often truncated. `descriptionScope` is `syndicated_summary`; `descriptionIsTruncated` marks an ellipsis. Full descriptions, employer display names, dates and salaries are not invented when unavailable. The employer URL identifier is not a verified employer display name.

### Input

```json
{
  "startUrls": [{ "url": "https://www.caterer.com/jobs/chef" }],
  "maxItems": 10,
  "maxPages": 3,
  "requestTimeoutSecs": 30
}
```

`searchQuery` or `keyword` overrides the keyword derived from the Caterer search URL. `location` overrides a location in the URL and is also checked against returned records. `startUrl` optionally overrides `startUrls`.

An individual Caterer `/job/` URL returns only that job if it is present in the feed within `maxPages`. Coverage is limited to jobs currently syndicated to CareerScope, not a complete export of Caterer.com.

### Verification and limitations

Each record has `jobId`, `title`, `employerSlug`, `description`, `descriptionScope`, `jobUrl`, `originalSource`, `sourceUrl`, `sourceStatus` and `retrievedAt`. `rawData` retains the source summary, tracked apply link and provider identifier.

Run metadata is stored in `RUN_SUMMARY` and `SOURCE_METADATA`. Connection errors, provider changes and empty matched results fail with details in `ERROR_DIAGNOSTIC`; they never add placeholder rows to the dataset.

### Pricing

Result events cost **$0.00199 each ($1.99 per 1,000 results)**. The Actor Start event is **$0.00005**, plus Apify platform usage. The run spending limit may cap stored results.

### Public source

- [CareerScope job board](https://careerscope.uk.net/jobs/)
- [Public syndicated listings](https://jobs.careerscope.uk.net/list/jobs?no_logo=1)

The Actor uses the same public search endpoint and session token as the board's own search form. It requires no private API credential.

# Actor input Schema

## `startUrl` (type: `string`):

Optional Caterer.com search or individual job URL overriding startUrls. Individual jobs must exist in the partner feed within maxPages.

## `startUrls` (type: `array`):

Caterer.com search URLs used to derive keyword/location filters. Retrieval is through the public CareerScope Caterer feed.

## `maxItems` (type: `integer`):

Maximum records to output.

## `keyword` (type: `string`):

Optional case-insensitive title or description filter.

## `searchQuery` (type: `string`):

Optional partner-feed search term overriding the keyword derived from the Caterer URL.

## `location` (type: `string`):

Optional location filter. Every returned record must also match this location text.

## `requestTimeoutSecs` (type: `integer`):

Per-request timeout in seconds.

## `maxPages` (type: `integer`):

Bound pagination of the public Caterer feed. Each page contains up to 26 listings.

## Actor input object example

```json
{
  "startUrl": "",
  "startUrls": [
    {
      "url": "https://www.caterer.com/jobs/chef"
    }
  ],
  "maxItems": 10,
  "keyword": "",
  "searchQuery": "",
  "location": "",
  "requestTimeoutSecs": 30,
  "maxPages": 3
}
```

# Actor output Schema

## `dataset` (type: `string`):

Dataset containing extracted public records.

## `runSummary` (type: `string`):

Run status and output counts.

## `diagnostics` (type: `string`):

Source metadata and sanitized errors.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrl": "",
    "startUrls": [
        {
            "url": "https://www.caterer.com/jobs/chef"
        }
    ],
    "keyword": "",
    "searchQuery": "",
    "location": ""
};

// Run the Actor and wait for it to finish
const run = await client.actor("jobscrawler/caterer-job-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrl": "",
    "startUrls": [{ "url": "https://www.caterer.com/jobs/chef" }],
    "keyword": "",
    "searchQuery": "",
    "location": "",
}

# Run the Actor and wait for it to finish
run = client.actor("jobscrawler/caterer-job-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrl": "",
  "startUrls": [
    {
      "url": "https://www.caterer.com/jobs/chef"
    }
  ],
  "keyword": "",
  "searchQuery": "",
  "location": ""
}' |
apify call jobscrawler/caterer-job-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,jobscrawler/caterer-job-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/mwobTbVBxi40CeT3h/builds/UI6oUTMrSrNKm2ebL/openapi.json
