# JobStreet Scraper (`trev0n/jobstreet-scraper`) Actor

Scrape JobStreet jobs across Malaysia, Singapore, Indonesia and the Philippines. Filters, full descriptions, and incremental monitoring that emits only new/updated listings on recurring runs.

- **URL**: https://apify.com/trev0n/jobstreet-scraper.md
- **Developed by:** [Paweł](https://apify.com/trev0n) (community)
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## 💼 JobStreet Scraper

🎯 **Pull thousands of fresh JobStreet jobs across Malaysia, Singapore, Indonesia and the Philippines — with full descriptions, salaries, and smart change-tracking that only charges you for what's new.**

This scraper collects clean, structured job data from JobStreet: titles, companies, locations, salary ranges, work types, categories, full job descriptions, contact details, and more. Run it once for a bulk export, or schedule it as a monitor that quietly watches your favorite searches and tells you the moment a matching job appears.

### 🚀 What Does It Do?

This scraper automatically searches JobStreet and collects **structured, ready-to-use data** for every matching job — no manual browsing needed. Just set your filters and hit Start.

💡 **Two modes of operation:**

1. **🔍 Discovery Mode** — Give it a keyword, market and filters; it pages through all results and exports every job, optionally enriched with the full description and recruiter contact details.
2. **📡 Monitoring Mode** — Turn on incremental tracking and schedule it. The first run builds a baseline; every run after that emits **only new, updated or reappeared jobs** — so daily monitoring stays fast and cheap.

### 👥 Who Is This For?

| 🏢 Use Case                     | 💬 How It Helps                                                                 |
| ------------------------------- | ------------------------------------------------------------------------------- |
| 🧑‍💼 **Recruiters & headhunters** | Track competitor postings and spot fresh openings the minute they go live       |
| 📊 **Job-market analysts**      | Build salary benchmarks and hiring-trend datasets across four SEA markets       |
| 🤖 **Job-board aggregators**    | Feed a continuously updated, deduplicated stream of listings into your own site |
| 🎯 **Lead-gen agencies**        | Find companies that are actively hiring and pull their contact details          |
| 🧑‍🎓 **Job seekers & coaches**    | Get instant alerts for roles matching very specific keyword + salary filters    |

### ✨ Features

- 🌐 **4 Markets** — Malaysia, Singapore, Indonesia and the Philippines, all from one actor
- 📄 **Full Job Details** — Complete descriptions in text, HTML or Markdown, plus phone numbers and extracted emails
- 💰 **Structured Salaries** — Min/max amounts, currency and pay period parsed out of the raw label
- 📡 **Incremental Monitoring** — Recurring runs emit only what changed, with up to 80–95% savings on daily tracking
- 🔁 **Repost Detection** — Spot listings re-posted under a fresh ID so you don't double-count them
- 🔔 **Instant Alerts** — Push new jobs straight to Telegram, Discord, Slack or any webhook
- 🎛️ **Smart Filters** — Keyword, location, work type, work arrangement, category, salary range, posting date, and include/exclude keyword matching
- 🔗 **Direct URLs** — Drop in JobStreet search or job URLs to scrape them as-is
- ⚡ **Fast & Scalable** — Pulls thousands of jobs per run with no browser overhead
- 🧹 **Deduplication** — Every job appears once, even across multiple search pages
- 📤 **Export Anywhere** — Download results as JSON, CSV, Excel, or push to Google Sheets, Zapier, Make, or your CRM

### 🎛️ Filters & Options

| Option                            | What It Does                                             |
| --------------------------------- | -------------------------------------------------------- |
| 🔎 **Search keywords**            | The job terms to search for (e.g. "software developer")  |
| 🌏 **Market**                     | Choose Malaysia, Singapore, Indonesia or the Philippines |
| 📍 **Location**                   | Filter by city, state or region                          |
| 🏷️ **Work type**                  | Full time, part time, contract or casual                 |
| 🏠 **Work arrangement**           | On-site, remote or hybrid                                |
| 🗂️ **Category**                   | Filter by job category and sub-category                  |
| 💵 **Salary range**               | Minimum / maximum salary, monthly or annual              |
| 📅 **Posted within**              | Only jobs posted in the last 1 / 3 / 7 / 14 / 31 days    |
| ➕ **Include / exclude keywords** | Keep or drop jobs by words in the title or description   |
| 📡 **Incremental monitoring**     | Emit only new / updated jobs across scheduled runs       |
| 🔔 **Notifications**              | Send fresh jobs to Telegram, Discord, Slack or a webhook |
| 🔢 **Max results**                | Control how many jobs to extract per run                 |
| 🔗 **Direct URLs**                | Optionally provide specific JobStreet URLs to scrape     |

### 📦 What You Get (Output Fields)

Every job includes:

#### Listing Info

| Field              | Example                                                                    |
| ------------------ | -------------------------------------------------------------------------- |
| jobId              | `92790786`                                                                 |
| title              | `Frontend Web Developer`                                                   |
| url                | `https://my.jobstreet.com/job/92790786`                                    |
| listingDate        | `2026-06-15T08:21:00Z`                                                     |
| listingDateDisplay | `4d ago`                                                                   |
| teaser             | `Build modern web apps with React and TypeScript for our fintech platform` |

#### Company

| Field        | Example                                                            |
| ------------ | ------------------------------------------------------------------ |
| company      | `Vell Malaysia Sdn. Bhd.`                                          |
| companyUrl   | `https://my.jobstreet.com/companies/vell-malaysia-168551206136908` |
| companyLogo  | `https://bx-branding-gateway.cloud.seek.com.au/712f30b4.1/jdpLogo` |
| advertiserId | `60312397`                                                         |

#### Location & Category

| Field           | Example                                  |
| --------------- | ---------------------------------------- |
| location        | `Kuala Lumpur`                           |
| locationCountry | `MY`                                     |
| category        | `Information & Communication Technology` |
| subCategory     | `Developers/Programmers`                 |
| roleId          | `frontend-developer`                     |

#### Compensation & Work

| Field           | Example                         |
| --------------- | ------------------------------- |
| salaryText      | `RM 5,000 – RM 7,000 per month` |
| salaryMin       | `5000`                          |
| salaryMax       | `7000`                          |
| salaryCurrency  | `RM`                            |
| salaryType      | `monthly`                       |
| workTypes       | `["Full time"]`                 |
| workArrangement | `["Hybrid"]`                    |

#### Full Details (optional)

| Field               | Example                                                                                             |
| ------------------- | --------------------------------------------------------------------------------------------------- |
| description         | `Company Description\nVell is a fast-growing fintech company building digital payment solutions...` |
| descriptionMarkdown | `## Key Responsibilities\n- Develop and maintain web applications...`                               |
| phoneNumber         | `+60 3-1234 5678`                                                                                   |
| extractedEmails     | `["careers@vell.com"]`                                                                              |
| jobStatus           | `Active`                                                                                            |

#### Monitoring (incremental mode)

| Field       | Example                                    |
| ----------- | ------------------------------------------ |
| changeType  | `NEW`                                      |
| firstSeenAt | `2026-06-18T06:00:00.000Z`                 |
| lastSeenAt  | `2026-06-19T06:00:00.000Z`                 |
| isRepost    | `false`                                    |
| repostOfId  | `null`                                     |
| contentHash | `030a3e29e214efd7a0062a960a08bd146a91fbb2` |

### 📊 Example Output

```json
{
    "jobId": "92790786",
    "title": "Frontend Web Developer",
    "url": "https://my.jobstreet.com/job/92790786",
    "searchQuery": "react developer",
    "company": "Vell Malaysia Sdn. Bhd.",
    "companyUrl": "https://my.jobstreet.com/companies/vell-malaysia-168551206136908",
    "advertiserId": "60312397",
    "companyLogo": "https://bx-branding-gateway.cloud.seek.com.au/712f30b4.1/jdpLogo",
    "location": "Kuala Lumpur",
    "locationCountry": "MY",
    "salaryText": "RM 5,000 – RM 7,000 per month",
    "salaryMin": 5000,
    "salaryMax": 7000,
    "salaryCurrency": "RM",
    "salaryType": "monthly",
    "workTypes": ["Full time"],
    "workArrangement": ["Hybrid"],
    "category": "Information & Communication Technology",
    "subCategory": "Developers/Programmers",
    "roleId": "frontend-developer",
    "teaser": "Build modern web apps with React and TypeScript for our fintech platform",
    "isFeatured": false,
    "listingDate": "2026-06-15T08:21:00Z",
    "listingDateDisplay": "4d ago",
    "description": "Company Description\nVell is a fast-growing fintech company building digital payment and mobile app solutions...",
    "phoneNumber": null,
    "extractedEmails": ["careers@vell.com"],
    "extractedPhones": [],
    "extractedUrls": ["https://vell.com/careers"],
    "jobStatus": "Active",
    "detailFetched": true,
    "changeType": "NEW",
    "firstSeenAt": "2026-06-19T06:00:00.000Z",
    "lastSeenAt": "2026-06-19T06:00:00.000Z",
    "isRepost": false,
    "sourceMarket": "MY",
    "scrapedAt": "2026-06-19T06:00:00.000Z"
}
```

### 📋 Dataset Views

The Apify Console gives you **4 ready-made table views** to quickly browse your results:

| View                | What It Shows                                                                |
| ------------------- | ---------------------------------------------------------------------------- |
| 📊 **Overview**     | Title, company, location, salary, work type and link                         |
| 📡 **Monitoring**   | Change type, first/last seen and repost flag — for scheduled monitoring runs |
| 💰 **Salary**       | Structured min/max/currency/period compensation data                         |
| 📋 **Full Details** | Every single field — the complete dataset                                    |

### ❓ FAQ

**🤔 Which JobStreet sites does it cover?**
Malaysia, Singapore, Indonesia and the Philippines — pick the market in the input, or paste URLs from any of them.

**🤔 Can I get the full job description and recruiter contact details?**
Yes. Turn on "Include full job details" and each job comes back with its complete description (text, HTML or Markdown), phone number, and any emails/links found in the posting.

**🤔 How does the monitoring mode save me money?**
The first run records every job it finds. On later runs it compares against that baseline and outputs only jobs that are new, updated or have reappeared — so for daily monitoring you typically pay for a handful of changes instead of the whole result set.

**🤔 Can it notify me when new jobs appear?**
Yes — connect a Telegram bot, Discord channel, Slack channel or any webhook, and you'll get a message listing the fresh jobs each run.

**🤔 Can I export the data?**
Yes — JSON, CSV, Excel, XML, HTML, RSS. You can also push data directly to Google Sheets, Zapier, Make, or any webhook/API endpoint.

**🤔 How often should I run this?**
For fresh data, run daily or weekly. You can schedule automatic runs on Apify with just a few clicks, and monitoring mode keeps each run cheap.

**🤔 Does it work with proxies?**
Yes — it runs fine without one, and works with Apify's built-in proxy service for large or frequent runs.

### 🛠️ Need Custom Filters or Features?

**I'm happy to customize this scraper for your specific needs!** 🤝

Whether you need:

- 🎯 Additional filters (specific company watchlists, exact salary bands, niche categories, multi-keyword OR searches)
- 📊 Extra data fields or custom output formats
- 🔄 Integration with your CRM, Google Sheets, or database
- ⏰ Scheduled monitoring with automatic deduplication and instant alerts
- 🌐 Scraping from other job platforms (Jora, JobsDB, SEEK, LinkedIn) alongside JobStreet

👉 **Don't hesitate to reach out via private message** — I respond quickly and I'm always open to building exactly what you need. No request is too small or too specific!

### ⚖️ Legal & Ethical Use

This scraper collects **only publicly available information** from JobStreet. It does not access private data, bypass authentication, or log into any account. Please use the data responsibly and in compliance with applicable laws and platform terms of service.

# Actor input Schema

## `query` (type: `string`):

Job keywords to search for (e.g. "software developer"). Leave empty to search by location/category only or to use Start URLs.

## `country` (type: `string`):

JobStreet market to search.

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

City / state / region to filter by (e.g. "Kuala Lumpur").

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

Optional JobStreet search-result or job-detail URLs to scrape directly instead of (or alongside) a keyword search.

## `maxResults` (type: `integer`):

Maximum number of jobs to collect (0 = unlimited).

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

Cap on search-result pages to fetch per query (0 = no cap).

## `sortMode` (type: `string`):

Order search results by relevance or by listing date.

## `dateRange` (type: `integer`):

Only jobs posted within this many days. Snaps to the nearest of 1/3/7/14/31. 0 = any time.

## `workType` (type: `string`):

Employment type filter.

## `workArrangement` (type: `string`):

On-site / remote / hybrid filter.

## `classification` (type: `string`):

SEEK classification id to filter by (e.g. 6281 = Information & Communication Technology).

## `subClassification` (type: `string`):

SEEK sub-classification id (e.g. 6290 = Engineering - Software).

## `salaryMin` (type: `integer`):

Lower bound of the salary range filter (market currency).

## `salaryMax` (type: `integer`):

Upper bound of the salary range filter (market currency).

## `salaryType` (type: `string`):

Salary period the range applies to.

## `includeKeywords` (type: `array`):

Keep only jobs whose title/teaser/description contains at least one of these terms.

## `excludeKeywords` (type: `array`):

Drop jobs whose title/teaser/description contains any of these terms.

## `maxAgeMinutes` (type: `integer`):

Drop jobs older than this many minutes by listing date (0 = no limit).

## `includeDetails` (type: `boolean`):

Fetch each job's full description, phone number and extracted contacts. Slower but much richer.

## `descriptionFormat` (type: `string`):

How to output the job description when full details are fetched.

## `descriptionMaxLength` (type: `integer`):

Truncate descriptions to this many characters (0 = no limit).

## `compact` (type: `boolean`):

Output only the core fields — handy for AI workflows.

## `excludeEmptyFields` (type: `boolean`):

Omit null / empty fields from each record.

## `detailConcurrency` (type: `integer`):

How many job-detail requests to run in parallel (1-10).

## `incrementalMode` (type: `boolean`):

Track state across runs and emit only NEW / UPDATED / REAPPEARED jobs. The first run builds a baseline; later runs charge only for the diff — ideal for cheap recurring monitoring.

## `stateKey` (type: `string`):

Custom identifier for the monitoring baseline. Leave empty to derive it from the search config automatically.

## `emitUnchanged` (type: `boolean`):

Also output jobs whose content didn't change since the last run.

## `emitExpired` (type: `boolean`):

Also output a record for jobs that disappeared since the last run (changeType = EXPIRED).

## `skipReposts` (type: `boolean`):

Drop new jobs detected as reposts of a recently expired listing (same content, new id).

## `notifyOnlyChanges` (type: `boolean`):

Only send notifications when there are new/updated jobs.

## `notificationLimit` (type: `integer`):

Maximum number of jobs listed in a single notification message.

## `includeRunSummary` (type: `boolean`):

Attach the run summary object to the generic webhook payload.

## `webhookUrl` (type: `string`):

Generic webhook to POST results to (JSON).

## `telegramBotToken` (type: `string`):

Telegram bot token for notifications.

## `telegramChatId` (type: `string`):

Telegram chat id to send notifications to.

## `discordWebhookUrl` (type: `string`):

Discord channel webhook for notifications.

## `slackWebhookUrl` (type: `string`):

Slack incoming webhook for notifications.

## `proxyConfiguration` (type: `object`):

Proxy settings. The API works without a proxy, but a proxy helps for large or frequent runs.

## Actor input object example

```json
{
  "query": "developer",
  "country": "MY",
  "maxResults": 100,
  "maxPages": 0,
  "sortMode": "relevance",
  "dateRange": 0,
  "salaryMin": 0,
  "salaryMax": 0,
  "maxAgeMinutes": 0,
  "includeDetails": false,
  "descriptionFormat": "text",
  "descriptionMaxLength": 0,
  "compact": false,
  "excludeEmptyFields": false,
  "detailConcurrency": 5,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "skipReposts": false,
  "notifyOnlyChanges": true,
  "notificationLimit": 10,
  "includeRunSummary": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `detailed` (type: `string`):

No description

## `salary` (type: `string`):

No description

## `monitoring` (type: `string`):

No description

## `runSummary` (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 = {
    "query": "developer"
};

// Run the Actor and wait for it to finish
const run = await client.actor("trev0n/jobstreet-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 = { "query": "developer" }

# Run the Actor and wait for it to finish
run = client.actor("trev0n/jobstreet-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 '{
  "query": "developer"
}' |
apify call trev0n/jobstreet-scraper --silent --output-dataset

```

## MCP server setup

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