# Jobberman Job Scraper (`blackfalcondata/jobberman-scraper`) Actor Scrape jobberman.com — Nigeria's leading job board. Salary metadata, experience filters, and incremental monitoring. - **URL**: https://apify.com/blackfalcondata/jobberman-scraper.md - **Developed by:** [Black Falcon Data](https://apify.com/blackfalcondata) (community) - **Categories:** Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 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/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 ### What does Jobberman Job Scraper do? Jobberman Job Scraper extracts structured job data from [jobberman.com](https://jobberman.com) — including salary data, contact details, company metadata, and full descriptions. It supports keyword search, location filters, and controllable result limits, so you can run the same query consistently over time. The actor also offers detail enrichment (full descriptions, company profiles, and contact information) where the source provides them, incremental monitoring that only returns new or changed results on recurring runs, and a compact output mode for AI-agent and MCP workflows. ### What data can you extract from jobberman.com? Each result includes Core listing fields (`jobId`, `jobKey`, `title`, `location`, `category`, `industry`, `experienceLevel`, and `experienceRequirement`, and more), detail fields when enrichment is enabled (`description`, `descriptionHtml`, `descriptionLength`, and `detailFetched`), contact and apply information (`applyUrl`, `externalApplyUrl`, `contactEmail`, and `easyApply`), and company metadata (`company` and `companyUrl`). In standard mode, all fields are always present — unavailable data points are returned as `null`, never omitted. In compact mode, only core fields are returned. Enable detail enrichment in the input to get richer fields such as full descriptions, company profiles, and contact information where the source provides them. ### Input The main inputs are a search keyword, an optional location filter, and a result limit. Additional filters and options are available in the input schema. Key parameters: - **`query`** — Keyword query for Jobberman search. Use a JSON array string only if you want multiple keyword runs in one actor input. - **`country`** — Jobberman market to search. Current implementation supports Nigeria. (default: `"NG"`) - **`location`** — Location slug or label such as `lagos`, `abuja`, `remote`, or `rest-nigeria`. Use a JSON array string only if you want multiple locations. - **`jobFunction`** — Job function slug such as `engineering-technology`, `software-data`, or `accounting-auditing-finance`. Use a JSON array string for multiple values. - **`industry`** — Industry slug such as `it-telecoms`, `construction`, or `manufacturing-warehousing`. Use a JSON array string for multiple values. - **`experience`** — Experience filter for Jobberman. (default: `"mid-level"`) - **`startUrls`** — Optional direct Jobberman search or detail URLs. Useful for replaying a known search path or a single listing. - **`maxResults`** — Maximum total job listings to return across all search sources. Use `0` for unlimited. (default: `25`) - **`maxPages`** — Maximum Jobberman search result pages to scrape per search source. (default: `5`) - **`includeDetails`** — Fetch each Jobberman detail page for full description, salary metadata, dates, and apply URL. (default: `true`) - **`includeCompanyProfile`** — Reserved for later company profile enrichment. Current implementation does not fetch dedicated company pages yet. (default: `false`) - **`descriptionMaxLength`** — Truncate `description` to this many characters. Use `0` for no truncation. (default: `0`) - ...and 5 more parameters #### Input example ```json { "query": "engineer", "country": "NG", "location": "lagos", "experience": "mid-level", "maxResults": 5, "maxPages": 5, "includeDetails": true, "includeCompanyProfile": false, "descriptionMaxLength": 0, "compact": false, "incrementalMode": false, "emitUnchanged": false, "emitExpired": false } ```` ### Output Each run produces a dataset of structured job records. Results can be downloaded as JSON, CSV, or Excel from the Dataset tab in Apify Console. #### Example job record ```json { "jobId": "52d14c86fdf489491543c69d876b1b3825bf5eab4066161bb49ef6386898b2ab", "jobKey": "site-engineer-n9pxrm", "title": "Site Engineer", "company": "MEP Insights Ltd", "companyUrl": null, "location": "Lagos", "category": "Engineering & Technology", "industry": "Energy & Utilities", "experienceLevel": "Mid level", "experienceRequirement": "3 years", "description": "Responsibilities: Supervise and manage on-site construction activitiesInterpret design drawings, supervise implement and update drawings based on site constraintsGive recommendations on works based on...", "descriptionHtml": "\n
Responsibilities:
\n\n