# Comeet Jobs Scraper (`jobsapi/comeet-jobs-search-scraper`) Actor

Extract public Comeet job listings with company metadata, locations, job URLs, update timestamps, and cleaned description sections.

- **URL**: https://apify.com/jobsapi/comeet-jobs-search-scraper.md
- **Developed by:** [Jobs API](https://apify.com/jobsapi) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.99 / 1,000 comeet career roles

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

## Comeet public job scraper

This Actor extracts source-backed public job data from Comeet-hosted career pages locally or on Apify Cloud. It reads the public company page, uses Comeet’s normal public positions endpoint, and enriches positions from the public detail endpoint. The page-provided access value is used only in memory for those requests; it is never logged, written to the dataset, or stored in the run summary.

### Modes

- `search`: fetch one or more public company career pages and enrich their current positions.
- `single`: fetch one public position URL supplied in `jobUrl` or `jobUrls`.
- `multiple`: fetch several public position URLs supplied in `jobUrls`, grouping requests by company page.

Example search input:

```json
{
  "mode": "search",
  "startUrls": [{ "url": "https://www.comeet.com/jobs/reeco/0A.00D" }],
  "maxItems": 25,
  "fetchDetails": true,
  "timeoutMs": 30000
}
```

Example direct input:

```json
{
  "mode": "multiple",
  "jobUrls": [
    "https://www.comeet.com/jobs/reeco/0A.00D/integrations-team-lead/06.F6B"
  ]
}
```

Each job record includes stable IDs, title/company/location data, employment and experience, remote details, full description and requirements text/HTML/sections, public questionnaires when exposed, employer metadata, public image metadata, application-related flags, selected public payloads, response hashes/statuses, and field-quality metadata. Empty/null values are omitted. Request diagnostics and receipts are stored under `DIAGNOSTICS`, never mixed into the jobs dataset.

The `OUTPUT` key-value record separates Apify's process `status` (`SUCCEEDED` or `FAILED`) from `resultStatus` (`COMPLETE`, `LIMITED`, `SKIPPED`, `DEFERRED`, `NO_DATA`, or `FAILED`). `NO_DATA` is used only when every requested company board's positions endpoint returned an explicit empty array with a successful HTTP receipt; each `no_data_evidence` entry includes the company URL, response URL, HTTP status, and response SHA-256. Empty or unrecognized responses without that evidence are `DEFERRED`. Direct-position mode cannot claim `NO_DATA` from an empty input. Explicit source denials (HTTP 401, 403, 429, or 451) and visible source-authored challenges stop further requests, discard staged job rows, and produce `SUCCEEDED`/`SKIPPED`. Generic transport or service unavailability is not treated as proof of a site block: with no stored jobs it produces `DEFERRED`, while stored jobs are preserved as `LIMITED`. Fatal non-block failures with no stored jobs produce `FAILED`/`FAILED` and invoke the Actor failure lifecycle. Only structurally valid, source-backed `comeet_job` records (including summary-only records) whose identity, content, job URL, and receipt match the requested source position are written to Dataset; diagnostics remain in key-value storage.

Run locally with `apify run --input-file INPUT.json`. Public detail requests are made one at a time using the runtime's ordinary request identity. If the site returns an explicit denial or human-verification challenge, the run stops without emitting job records; do not retry or route around that barrier. The Actor does not use login, proxy rotation, fingerprint overrides, or access-control bypass.

# Actor input Schema

## `mode` (type: `string`):

Search one or more company boards, fetch one position, or fetch several positions.

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

Public Comeet company career pages such as https://www.comeet.com/jobs/reeco/0A.00D. Position URLs are accepted and normalized to their company page in search mode.

## `jobUrls` (type: `array`):

Public Comeet position URLs for single and multiple modes.

## `jobUrl` (type: `string`):

Convenience input for single mode.

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

Maximum number of unique public job records to emit.

## `fetchDetails` (type: `boolean`):

Enrich search results from each public position detail endpoint. Direct modes always fetch their requested detail pages.

## `timeoutMs` (type: `integer`):

Maximum time allowed for each public page or API request.

## `timeoutSecs` (type: `integer`):

Compatibility alias for timeoutMs.

## Actor input object example

```json
{
  "mode": "search",
  "startUrls": [
    {
      "url": "https://www.comeet.com/jobs/reeco/0A.00D"
    }
  ],
  "jobUrls": [],
  "maxItems": 25,
  "fetchDetails": true,
  "timeoutMs": 30000
}
```

# Actor output Schema

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

No description

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

No description

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

No description

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("jobsapi/comeet-jobs-search-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("jobsapi/comeet-jobs-search-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 '{}' |
apify call jobsapi/comeet-jobs-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,jobsapi/comeet-jobs-search-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/D5qA8Plz3RavSbAp7/builds/Sw1QZVMJuWq2NmRJQ/openapi.json
