# Canada Job Bank Posting and Hourly Wage Trends (`thirdwatch/canada-job-bank-trends`) Actor

Compare two official Canadian Job Bank releases by region and occupation. Track posting counts, reported vacancies and changes in advertised minimum hourly wages.

- **URL**: https://apify.com/thirdwatch/canada-job-bank-trends.md
- **Developed by:** [Thirdwatch](https://apify.com/thirdwatch) (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 $1.40 / 1,000 job bank occupation, region and release comparisons

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

## Canada Job Bank Posting and Hourly Wage Trends

> Compare two official Canadian Job Bank releases by region and occupation. Track posting counts, reported vacancies and changes in advertised minimum hourly wages.

### What you get

A labor analyst can compare advertised wage floors between two months for the same NOC occupation and Canadian region.

### Output fields

The default example produces these top-level fields. Nested records can be expanded in JSON or selected during export.

| Field | Meaning |
| --- | --- |
| `province` | Province reported or calculated for this record. |
| `economicRegion` | Published Canadian economic region, when disclosed. |
| `noc2021` | Five-digit National Occupational Classification 2021 code. |
| `previousMonth` | Earlier or current monthly reporting period. |
| `month` | Earlier or current monthly reporting period. |
| `previous` | Earlier record or measurements for this identity, when available. |
| `current` | Current record or measurements for the same identity. |
| `change` | Change or observation category assigned to this row. |
| `scope` | Coverage of the provided reports, feeds or market records. |
| `publisher` | Publisher reported or calculated for this record. |
| `licence` | Licence published for the source dataset. |
| `datasetUrl` | Source or dataset location associated with the row. |
| `previousResourceUrl` | Earlier source release used in the comparison. |
| `resourceUrl` | Source or dataset location associated with the row. |
| `previousResourceModified` | Publication resource’s reported modification timestamp. |
| `resourceModified` | Publication resource’s reported modification timestamp. |

### Example output

Selected fields from one verified public-source run. The JSON below is an excerpt from one row.

```json
{
  "province": "Alberta",
  "noc2021": "64301",
  "previousMonth": "2026-09",
  "month": "2026-10",
  "previous": {
    "postingLocationRecords": 0,
    "reportedVacancies": 0,
    "recordsReportingVacancies": 0,
    "meanAdvertisedHourlyMinimumCAD": null,
    "recordsReportingHourlyMinimum": 0
  },
  "current": {
    "postingLocationRecords": 1,
    "reportedVacancies": 1,
    "recordsReportingVacancies": 1,
    "meanAdvertisedHourlyMinimumCAD": 20.51,
    "recordsReportingHourlyMinimum": 1
  },
  "change": {
    "postingLocationRecords": 1,
    "reportedVacancies": 1,
    "recordsReportingVacancies": 1,
    "meanAdvertisedHourlyMinimumCAD": null,
    "recordsReportingHourlyMinimum": 1
  },
  "publisher": "Employment and Social Development Canada, Job Bank"
}
```

### Input parameters

In the input form, switch to JSON, paste the input below and start the actor. Open the run’s dataset to inspect or export the result.

The input reads complete official September and October 2026 Job Bank releases.

The example loads two complete published months and narrows the output to Alberta occupation 64301. You may instead supply two adjacent official excerpts; rows are then labeled as excerpt-only coverage.

<details>
<summary>Copy the complete, runnable input</summary>

```json
{
  "endMonth": "2026-10",
  "province": "Alberta",
  "nocCode": "64301"
}
```

</details>

| Parameter | Use | Meaning |
| --- | --- | --- |
| `endMonth` | Optional / mode-specific | YYYY-MM. Leave blank to take the latest available English release and its preceding month. |
| `province` | Optional / mode-specific | Full province or territory name, such as Alberta or Quebec. Case and accents are ignored. Leave blank for all regions. |
| `nocCode` | Optional / mode-specific | Optional five-digit occupation code, including leading zeros. |
| `releaseExcerpts` | Optional / mode-specific | Optional two objects with month, sourceUrl, and csv text. Results cover only the supplied rows and are labelled accordingly. |

### Use cases and integration

For a reproducible baseline, save the input as an Apify Task. Adjust the input to select the next file, period or item you want to check. For an API integration, submit JSON to [this actor’s run endpoint](https://api.apify.com/v2/acts/thirdwatch~canada-job-bank-trends/runs). On success, read `defaultDatasetId` from the run and export its items as JSON or CSV.

### Limitations

Counts refer to posting-location records and reported vacancies, not completed hires. Supplied excerpts describe only those rows; complete official releases support market-level totals.

With no province or occupation filter, a run returns one row for every region and occupation group: 12,743 rows for the September and October 2026 releases. Each row is charged, so set a filter or a maximum charge if you only need part of the data.

If nothing matches your filters, the run succeeds with an empty dataset and its status message says why. No rows are written, so there are no row charges. A malformed month or occupation code, or a month Job Bank has not published, is rejected with a plain message. If Open Canada cannot be read after three attempts, the run fails instead of reporting an empty result.

### Licence and attribution

Employment and Social Development Canada publishes this dataset under the [Open Government Licence – Canada](https://open.canada.ca/en/open-government-licence-canada), which permits commercial use. If you copy, adapt or publish the results, acknowledge the source with this statement and, where possible, link to the licence:

> Contains information licensed under the Open Government Licence – Canada.

The licence gives no rights to personal information, to third-party rights the publisher cannot license, to official names, crests and logos, or to information covered by other intellectual property rights. It also gives no right to suggest official status, or that the publisher endorses you or your use. Each dataset row names the `publisher` and links to the `licence` and the source `datasetUrl`.

[Job Bank open dataset](https://open.canada.ca/data/en/dataset/ea639e28-c0fc-48bf-b5dd-b8899bd43072) · [Open Government Licence – Canada](https://open.canada.ca/en/open-government-licence-canada)

### Compared to alternatives

Use a vacancy-search tool for individual openings. For workforce comparisons, this actor uses dated government releases and reports how many observations contribute to each wage figure. Related options: [getascraper/jobbank-scraper](https://apify.com/getascraper/jobbank-scraper) and [memo23/jobbank-scraper](https://apify.com/memo23/jobbank-scraper).

### FAQ

**Why does the hourly wage coverage count differ from posting count?**

Only records with a disclosed hourly pay period and minimum contribute to the wage mean. Salaried and undisclosed observations stay out of it.

Last verified: 2026-11. The verified sample run returned 8 dataset rows. [Thirdwatch](https://thirdwatch.dev)

# Actor input Schema

## `endMonth` (type: `string`):

YYYY-MM. Leave blank to take the latest available English release and its preceding month.

## `province` (type: `string`):

Full province or territory name, such as Alberta or Quebec. Case and accents are ignored. Leave blank for all regions.

## `nocCode` (type: `string`):

Optional five-digit occupation code, including leading zeros.

## `releaseExcerpts` (type: `array`):

Optional two objects with month, sourceUrl, and csv text. Results cover only the supplied rows and are labelled accordingly.

## Actor input object example

```json
{
  "endMonth": "2026-10",
  "province": "Alberta",
  "nocCode": "64301"
}
```

# Actor output Schema

## `results` (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 = {
    "endMonth": "2026-10",
    "province": "Alberta",
    "nocCode": "64301"
};

// Run the Actor and wait for it to finish
const run = await client.actor("thirdwatch/canada-job-bank-trends").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 = {
    "endMonth": "2026-10",
    "province": "Alberta",
    "nocCode": "64301",
}

# Run the Actor and wait for it to finish
run = client.actor("thirdwatch/canada-job-bank-trends").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 '{
  "endMonth": "2026-10",
  "province": "Alberta",
  "nocCode": "64301"
}' |
apify call thirdwatch/canada-job-bank-trends --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,thirdwatch/canada-job-bank-trends"
        }
    }
}
```

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/pqyOcWo7ptvNdbI9x/builds/GHdfiTMINoJma36xA/openapi.json
