# OnlineJobs.ph Job Radar Actor (`vjkhush/onlinejobsph-job-radar-actor`) Actor Scrape job listings from OnlineJobs.ph, the largest Filipino remote job board. Search by keywords, filter by recency, and get structured job data with title, salary, employer, and direct links. - **URL**: https://apify.com/vjkhush/onlinejobsph-job-radar-actor.md - **Developed by:** [Richard v](https://apify.com/vjkhush) (community) - **Categories:** AI, Automation, Agents - **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 job 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## OnlineJobs.ph Job Radar Scrape job listings from [OnlineJobs.ph](https://www.onlinejobs.ph), the largest Filipino remote job board. Search by keywords, filter by recency, and get structured job data with title, salary, employer, and direct links. ### What you get per result - Job title, employer name, salary/budget - Direct link to the full listing - Posting date and job ID - Deduplicated, structured JSON ready for integration ### Key features - **Multi-keyword search** — run multiple queries in a single crawl - **Recency filter** — only get jobs posted in the last 24 hours or 3 days - **Company name filter** — target specific employers - **Remote/WFH filter** — isolate remote-friendly listings - **Smart deduplication** — no duplicate records across keyword searches - **Budget-aware** — stops automatically when your event limit is reached ### Use cases - Daily job monitoring for recruiters and job seekers - Talent market research across the Philippines - Competitive salary benchmarking - Building job alert pipelines with webhooks ### Output fields Each dataset item includes: | Field | Example | Description | |-------|---------|-------------| | `job_id` | `1647384` | OnlineJobs.ph numeric job ID | | `title` | `Web Developer (PHP, WordPress)` | Job title | | `company` | `Josephine Adams` | Employer name (when available) | | `location` | `Philippines` | Always Philippines for this platform | | `salary` | `$4-8 / hour` | Salary/budget as shown on listing | | `posted_at` | `2026-05-15 13:03:42` | Original posting timestamp | | `refreshed_at` | `2026-05-15 13:03:42` | Same as posted_at for this platform | | `url` | `https://www.onlinejobs.ph/jobseekers/job/...` | Direct link to the full listing | | `source` | `onlinejobsph` | Fixed identifier for this actor | | `scraped_at` | `2026-05-15T06:25:01.872Z` | ISO timestamp of when the record was scraped | ### Input examples #### Quick start ```json { "keywords": ["virtual assistant", "web developer"], "maximumItems": 200, "dateFilter": "LAST_3_DAYS" } ```` #### Multi-keyword discovery ```json { "keywords": [ "virtual assistant", "web developer", "graphic designer", "data entry", "content writer", "social media manager" ], "maximumItems": 500, "maxListingPages": 15, "dateFilter": "LAST_3_DAYS", "maxConcurrency": 1, "maxRequestRetries": 5, "minListingDelayMs": 700, "maxListingDelayMs": 2200, "proxyConfiguration": { "useApifyProxy": true, "groups": ["RESIDENTIAL"] } } ``` #### With filters ```json { "keywords": ["developer"], "maximumItems": 200, "dateFilter": "LAST_24_HOURS", "companyName": "acme", "remoteWork": true } ``` ### Filter behavior | Filter | How it works | |--------|-------------| | **Posting freshness** (`dateFilter`) | Compares the listing's `posted_at` timestamp against the current time. Only jobs within the window are kept. | | **Company contains** (`companyName`) | Case-insensitive substring match on the employer name. | | **Remote-first** (`remoteWork`) | Scans title and description for remote/hybrid/WFH keywords. Most OJP listings are remote by default, so this is rarely needed. | All filters are applied after scraping, so they reduce the final output but don't speed up the crawl. To reduce crawl time, lower `maxListingPages` or `maximumItems`. ### Why counts vary - `maximumItems` is a cap, not a guarantee — actual results depend on search volume and filters. - Narrow or niche keywords may produce fewer listings than the target. - More keywords increase coverage but also increase run time. - Deduplication removes overlapping results across keyword searches. - The recency filter (`dateFilter`) is strict — `LAST_24_HOURS` can significantly reduce output. ### Recommended presets #### Daily monitoring (low-cost) - 2-4 keywords - `maximumItems`: 100-200 - `maxListingPages`: 5-8 - `dateFilter`: `LAST_24_HOURS` - `maxConcurrency`: 1 #### Weekly sweep (broad coverage) - 5-10 keywords - `maximumItems`: 300-500 - `maxListingPages`: 15-25 - `dateFilter`: `LAST_3_DAYS` - `maxConcurrency`: 1 #### Targeted search - 1-2 specific keywords - `companyName` set to filter a specific employer - `maximumItems`: 50-100 - `maxListingPages`: 3-5 ### Proxy guidance OnlineJobs.ph blocks datacenter IPs aggressively. **Residential proxies are required** for reliable results. The default configuration uses Apify residential proxies, which works out of the box. If you see frequent 403 errors or empty results: 1. Ensure `proxyConfiguration.groups` includes `RESIDENTIAL`. 2. Lower `maxConcurrency` to 1. 3. Increase `minListingDelayMs` and `maxListingDelayMs` for slower, more human-like pacing. ### Integration tips - **Scheduled runs**: Set up a daily or weekly schedule on Apify to monitor new listings automatically. - **Webhooks**: Use Apify webhooks to trigger notifications (Slack, email, etc.) when new jobs are found. - **API access**: Fetch results programmatically via the [Apify API](https://docs.apify.com/api/v2) using the dataset ID from each run. - **Deduplication across runs**: Use `job_id` as the primary key to deduplicate records across multiple runs in your own database. ### Free trial 5 results included so you can verify the output format before committing. # Actor input Schema ## `keywords` (type: `array`): Add one or more role/skill keywords. Each keyword becomes a separate search on OnlineJobs.ph. Examples: "web developer", "virtual assistant", "graphic designer", "data entry". Comma-separated values inside a single entry are also supported. ## `keyword` (type: `string`): Optional fallback keyword if you prefer a single text field. Comma-separated values are supported (e.g. "SEO, content writer"). If both this and Keywords above are provided, they are merged. ## `maximumItems` (type: `integer`): Maximum number of job records to output. The actor stops crawling once this limit is reached. Actual results may be fewer if the search yields less or recency filters narrow the set. Each result requires a detail page visit, so higher values take longer. ## `dateFilter` (type: `string`): Only keep jobs posted within this window. "Last 3 days" is the default and recommended for daily monitoring. "Last 24 hours" is stricter — useful for high-volume keywords. ## `companyName` (type: `string`): Optional filter: only keep jobs where the employer name contains this text. Case-insensitive substring match. Leave empty to include all employers. ## `remoteWork` (type: `boolean`): Enable to keep only jobs that mention remote, hybrid, work-from-home, or home-based in the title or description. Note: most OnlineJobs.ph listings are already remote by nature. ## `proxyConfiguration` (type: `object`): Proxy setup for request routing and anti-block resilience. If you see frequent 403 errors or blocked pages, switch to residential proxies or lower concurrency. ## `maxListingPages` (type: `integer`): Maximum number of listing pages to crawl per keyword. Each page has ~30 results. Keep low since each result also needs a detail page visit. ## `maxConcurrency` (type: `integer`): Number of browser pages running at the same time. Keep at 1 for stability — OnlineJobs.ph is aggressive with rate limiting. Increase only if you have high-quality residential proxies. ## `maxRequestRetries` (type: `integer`): How many times to retry a failed request before giving up. Higher values improve resilience against transient blocks but increase run time. ## `minListingDelayMs` (type: `integer`): Minimum random delay (in milliseconds) before parsing each listing page. Adds human-like pacing to reduce detection. 700ms is a safe default. ## `maxListingDelayMs` (type: `integer`): Maximum random delay (in milliseconds) before parsing each listing page. The actual delay is randomized between min and max. 2200ms is a safe default. ## Actor input object example ```json { "keywords": [ "virtual assistant" ], "keyword": "", "maximumItems": 50, "dateFilter": "LAST_3_DAYS", "companyName": "", "remoteWork": false, "maxListingPages": 3, "maxConcurrency": 1, "maxRequestRetries": 3, "minListingDelayMs": 700, "maxListingDelayMs": 2200 } ``` # Actor output Schema ## `jobListings` (type: `string`): All scraped job listings in structured JSON format. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("vjkhush/onlinejobsph-job-radar-actor").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("vjkhush/onlinejobsph-job-radar-actor").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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 vjkhush/onlinejobsph-job-radar-actor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=vjkhush/onlinejobsph-job-radar-actor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "OnlineJobs.ph Job Radar Actor", "description": "Scrape job listings from OnlineJobs.ph, the largest Filipino remote job board. Search by keywords, filter by recency, and get structured job data with title, salary, employer, and direct links.", "version": "0.1", "x-build-id": "y1reYofpDt6FxyTFi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vjkhush~onlinejobsph-job-radar-actor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vjkhush-onlinejobsph-job-radar-actor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/vjkhush~onlinejobsph-job-radar-actor/runs": { "post": { "operationId": "runs-sync-vjkhush-onlinejobsph-job-radar-actor", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/vjkhush~onlinejobsph-job-radar-actor/run-sync": { "post": { "operationId": "run-sync-vjkhush-onlinejobsph-job-radar-actor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "maximumItems" ], "properties": { "keywords": { "title": "🧠 Keywords (multi)", "type": "array", "description": "Add one or more role/skill keywords. Each keyword becomes a separate search on OnlineJobs.ph. Examples: \"web developer\", \"virtual assistant\", \"graphic designer\", \"data entry\". Comma-separated values inside a single entry are also supported.", "default": [ "virtual assistant" ], "items": { "type": "string" } }, "keyword": { "title": "🧠 Single keyword (optional)", "type": "string", "description": "Optional fallback keyword if you prefer a single text field. Comma-separated values are supported (e.g. \"SEO, content writer\"). If both this and Keywords above are provided, they are merged.", "default": "" }, "maximumItems": { "title": "🎯 Target results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of job records to output. The actor stops crawling once this limit is reached. Actual results may be fewer if the search yields less or recency filters narrow the set. Each result requires a detail page visit, so higher values take longer.", "default": 50 }, "dateFilter": { "title": "🕒 Posting freshness", "enum": [ "LAST_24_HOURS", "LAST_3_DAYS" ], "type": "string", "description": "Only keep jobs posted within this window. \"Last 3 days\" is the default and recommended for daily monitoring. \"Last 24 hours\" is stricter — useful for high-volume keywords.", "default": "LAST_3_DAYS" }, "companyName": { "title": "🏢 Company contains", "type": "string", "description": "Optional filter: only keep jobs where the employer name contains this text. Case-insensitive substring match. Leave empty to include all employers.", "default": "" }, "remoteWork": { "title": "🏡 Remote-first only", "type": "boolean", "description": "Enable to keep only jobs that mention remote, hybrid, work-from-home, or home-based in the title or description. Note: most OnlineJobs.ph listings are already remote by nature.", "default": false }, "proxyConfiguration": { "title": "🛰 Proxy mode", "type": "object", "description": "Proxy setup for request routing and anti-block resilience. If you see frequent 403 errors or blocked pages, switch to residential proxies or lower concurrency." }, "maxListingPages": { "title": "📄 Listing page cap", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of listing pages to crawl per keyword. Each page has ~30 results. Keep low since each result also needs a detail page visit.", "default": 3 }, "maxConcurrency": { "title": "⚡ Parallel pages", "minimum": 1, "maximum": 20, "type": "integer", "description": "Number of browser pages running at the same time. Keep at 1 for stability — OnlineJobs.ph is aggressive with rate limiting. Increase only if you have high-quality residential proxies.", "default": 1 }, "maxRequestRetries": { "title": "🔁 Retry budget", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many times to retry a failed request before giving up. Higher values improve resilience against transient blocks but increase run time.", "default": 3 }, "minListingDelayMs": { "title": "⏱ Min page pause (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Minimum random delay (in milliseconds) before parsing each listing page. Adds human-like pacing to reduce detection. 700ms is a safe default.", "default": 700 }, "maxListingDelayMs": { "title": "⏱ Max page pause (ms)", "minimum": 0, "maximum": 20000, "type": "integer", "description": "Maximum random delay (in milliseconds) before parsing each listing page. The actual delay is randomized between min and max. 2200ms is a safe default.", "default": 2200 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```