# OCC Mundial Jobs Scraper (`normdata/occ-scraper`) Actor

Every job on OCC Mundial, Mexico's biggest job board, in one run: salary ranges in MXN, category, contract, work model, education, benefits, skills and full descriptions. Recruiters, HR teams and analysts get 1,000 jobs in under a minute.

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

## Pricing

from $10.00 / 1,000 jobs

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

![Norm Data](https://raw.githubusercontent.com/FabriAV/normdata/refs/heads/main/assets/banner_norm2.png)

## 💼 OCC Mundial Jobs Scraper

Extract job listings from **OCC Mundial**, Mexico's biggest job board: title, company, salary (as shown and as numbers in MXN), city, state, category, contract, schedule, work model, education, benefits, skills, screening questions and the full description. Search by keyword, state or city, and filter by category, work model, contract, education, salary range and posting date. About **1,000 jobs with full details in under a minute**.

OCC lists more than 55,000 open jobs. The site itself stops paging a search at about 10,000 results; this Actor splits bigger searches by category and state, so a run with no filters can return the whole board.

> 👉 **Try it now:** press **Start**. The ready-made input gives you 10 jobs in a few seconds.<br>
> 💰 **$0.014 per job** on the Free plan (10 jobs per run), from $0.0125 on paid plans. [See pricing](#-pricing)

### ✨ Why this scraper?

> - **Fast without shortcuts**<br>
>   About 1,000 jobs with full details in under a minute (14 seconds in our tests), with no browser and no proxy.
>
> - **Every filter, not just a keyword box**<br>
>   Category, work model, contract, education, salary and date are inputs you pick from a list.
>
> - **The whole board when you need it**<br>
>   Big searches are split into pieces OCC can page through completely, newest first, with no duplicates.
>
> - **Honest about what OCC shows**<br>
>   Confidential companies stay confidential (`company` is empty and `confidentialCompany` is true). Recruiter names, phones and emails are never collected.
>
> - **Search**<br>
>   By one or more keywords, in one or more states or cities, or across all of Mexico.
>
> - **Every OCC filter as a real input**<br>
>   Category (23), work model, contract type, education level, minimum and maximum salary, posting date, and sort order.
>
> - **Apify platform**<br>
>   Schedule runs, get only new jobs, export to Excel or CSV, use the API, or connect Google Sheets, Zapier and Make.

### ⚖️ How it compares

| Capability | This actor | [unfenced-group](https://apify.com/unfenced-group/occ-com-mx-scraper) | [corvuslab](https://apify.com/corvuslab/occ-mundial-jobs-scraper) | [gio21](https://apify.com/gio21/occmundial-jobs-scraper) | [stilled_stalagmite](https://apify.com/stilled_stalagmite/occ-mexico-jobs-scraper) |
|---|:--:|:--:|:--:|:--:|:--:|
| Several keywords and locations in one run | **yes** | no | no | no | no |
| Category filter | **several** | one | no | no | no |
| Work model, education, salary filters | **yes** | no | no | no | no |
| Contract filter | **several** | one | no | no | no |
| Posting date filter and newest-first sort | **yes** | no | no | no | no |
| Past OCC's 10,000-job paging limit | **yes** | no | no | no | no |
| Full description | **yes** | optional | yes | yes | yes |
| Skills and screening questions | **yes** | no | no | no | no |
| Benefits list | **yes** | no | no | no | no |
| Salary min/max numbers and pay period | **yes** | yes | partial | no | no |
| Proxy | **none needed** | not stated | not stated | not stated | not stated |

corvuslab adds incremental mode and Telegram, Slack or Discord alerts, and corvuslab and unfenced-group can return the description as HTML or markdown. Here the description is clean plain text with bullet points kept.

### 🚀 How to scrape OCC Mundial Jobs

1. Create a free Apify account.
2. Pick the filters you need, or keep the ready-made input.
3. Click **Start**.
4. Download the jobs as Excel, CSV or JSON from the **Output** tab.

### 💰 Pricing

#### How much does it cost to scrape OCC Mundial Jobs?

You pay a one-time **$0.003** per run, plus a price for each job saved:

| Charged for | Free | Bronze | Silver | Gold+ |
| --- | --- | --- | --- | --- |
| **Job**: One OCC Mundial job saved to your dataset, with full details. | 0.014 | 0.0125 | 0.011 | 0.01 |

Example: 1,000 jobs cost about **$12.5** on Bronze. No proxy or compute costs on top.

### 📦 What data you get

| Field | Description |
| --- | --- |
| `jobId`, `url` | OCC's job ID and the job page. |
| `title`, `company`, `confidentialCompany`, `verifiedCompany` | Job title and hiring company; confidential listings have no company name. Verified means OCC checked the employer. |
| `city`, `state` | Where the job is. |
| `salary`, `salaryMin`, `salaryMax`, `salaryCurrency`, `salaryPeriod` | The salary exactly as shown, the same as numbers in MXN, and the period (monthly, biweekly, weekly, daily, hourly, yearly). Empty when the company hides it. |
| `category`, `subcategory` | OCC's job category and subcategory. |
| `employmentType`, `workSchedule`, `workModel` | Contract (permanent, temporary...), schedule (full time, part time...) and onsite, hybrid or remote. |
| `education` | Minimum education asked for. |
| `benefits`, `skills`, `screeningQuestions` | Lists of benefits, required skills and the questions applicants must answer. |
| `description` | Full job description as plain text. |
| `companyLogo`, `companyJobsUrl` | Company logo and the page with all its jobs. |
| `postedAt`, `expiresAt` | Posting and expiry dates (YYYY-MM-DD). |
| `scrapedAt` | When the row was collected (UTC). |
| `error` | Only present when a job's details didn't load. |

### ⚙️ Input

| Section | What it's for |
| --- | --- |
| **Maximum jobs** | Always first, caps the whole run. Empty means no limit. |
| **Search** | Keywords, locations, or a pasted OCC search link. |
| **Job filters** | Category, work model, contract type, education, minimum and maximum salary, posting date, sort order. |

#### Input examples

#### 💰 Salary benchmark for sales roles in Jalisco

```json
{ "maxItems": 1000, "keywords": ["vendedor"], "locations": ["Jalisco"], "minSalary": 10000 }
```

#### 🏠 Remote IT jobs posted this week

```json
{ "maxItems": 500, "categories": ["tecnologias-de-la-informacion-sistemas"], "workModels": ["remote"], "postedWithin": "7" }
```

#### 🎓 Internships for students in Monterrey and CDMX

```json
{ "maxItems": 300, "locations": ["Monterrey", "Ciudad de México"], "contractTypes": ["becario-practicas"] }
```

#### 🗺️ The whole board, every job (leave Maximum jobs empty)

```json
{ "keywords": [] }
```

#### 🔗 Reuse a search you built on the site

```json
{ "maxItems": 200, "pageUrl": "https://www.occ.com.mx/empleos/de-contador/en-nuevo-leon/?smin=20000" }
```

### 🔗 Related scrapers

> - [Catho Jobs Scraper](https://apify.com/normdata/catho-scraper)
> - [Trabajando.cl Jobs Scraper](https://apify.com/normdata/trabajando-scraper): Chile Job Listings.
> - [Swiss Jobs Scraper (Job-Room / arbeit.swiss)](https://apify.com/normdata/jobroom-scraper)
> - [SS.com Scraper](https://apify.com/normdata/ss-com-scraper): Latvia Classifieds (Cars, Flats, Jobs).

### ❓ FAQ and troubleshooting

#### Is there an OCC Mundial Jobs API? Do I need an API key?

> OCC Mundial Jobs has no public data API for this. This Actor works as an OCC Mundial Jobs API alternative: it reads the public pages and gives you clean JSON, CSV or Excel, with no API key, no login and no code to maintain. You can also call it from your own code with the Apify API, or from an AI agent through MCP:
> `claude mcp add --transport http apify "https://mcp.apify.com?tools=normdata/occ-scraper"`

#### Why do I get only 10 jobs?

> On the Apify free plan each run saves up to 10 results, so you can try it before paying. Any paid plan removes the limit.

#### A location was skipped

> Use a state ("Jalisco", "Nuevo León") or a city ("Guadalajara", "Monterrey"). Accents are optional. If every location you gave is unrecognizable, the run stops with 0 results instead of searching all of Mexico.

#### Salary fields are empty

> The company chose to hide the salary ("Si el reclutador te contacta podrás conocer el sueldo"). The salary filters still work on those jobs because OCC applies them on its side.

#### Is this an official OCC Mundial Jobs tool?

> No. It is independent and not affiliated with OCC Mundial Jobs. It reads only data OCC Mundial Jobs publishes on its public pages, at a moderate pace. Use the data in line with OCC Mundial Jobs's terms and the laws that apply to you.

### 📧 Contact

Need a scraper for a different site, or found something wrong with this one? norm.data.scrapers@gmail.com

# Actor input Schema

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

Stop after this many jobs. Leave empty for no limit (the run stops once the matching jobs run out). The Apify Free plan is always capped at 10.

## `keywords` (type: `array`):

One or more searches, in Spanish as people search on OCC, e.g. "vendedor", "contador", "desarrollador java". Each one runs its own search and is tagged on every row it produces.

## `locations` (type: `array`):

Mexican states or cities, e.g. "Jalisco", "Monterrey", "Ciudad de México". Each location runs its own search. Leave empty for all of Mexico.

## `pageUrl` (type: `string`):

Already filtered a search on occ.com.mx? Paste that page's URL and it's reused exactly; every other search field and filter is then ignored.

## `categories` (type: `array`):

Only jobs in these OCC categories. Each one runs its own search.

## `workModels` (type: `array`):

On-site, hybrid or remote.

## `contractTypes` (type: `array`):

Only these types of contract.

## `education` (type: `array`):

Only jobs asking for this education level.

## `minSalary` (type: `integer`):

Only jobs paying at least this much per month, e.g. 15000. Jobs that hide their salary are left out when you set this.

## `maxSalary` (type: `integer`):

Only jobs paying up to this much per month.

## `postedWithin` (type: `string`):

Only jobs published in this window.

## `sortBy` (type: `string`):

Newest first (default) or OCC's own relevance order.

## Actor input object example

```json
{
  "maxItems": 10,
  "keywords": [
    "vendedor"
  ],
  "locations": [
    "Jalisco",
    "Monterrey"
  ],
  "pageUrl": "https://www.occ.com.mx/empleos/de-vendedor/en-jalisco/?tm=7",
  "postedWithin": "any",
  "sortBy": "newest"
}
```

# Actor output Schema

## `jobs` (type: `string`):

One row per job.

# 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 = {
    "maxItems": 10,
    "keywords": [
        "vendedor"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("normdata/occ-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 = {
    "maxItems": 10,
    "keywords": ["vendedor"],
}

# Run the Actor and wait for it to finish
run = client.actor("normdata/occ-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 '{
  "maxItems": 10,
  "keywords": [
    "vendedor"
  ]
}' |
apify call normdata/occ-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,normdata/occ-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/VPpcSGd1PtDR4xndH/builds/aeebjXLuRkfLJtyOb/openapi.json