# CareerBuilder Scraper – Jobs, Salaries & Company Profiles (`abotapi/careerbuilder-scraper`) Actor Scrape CareerBuilder.com job listings by search or URL. Returns title, company profile, location with coordinates, salary range, employment type, apply link, posting dates, and full job description, with date sorting and optional detail enrichment. - **URL**: https://apify.com/abotapi/careerbuilder-scraper.md - **Developed by:** [Abot API](https://apify.com/abotapi) (community) - **Categories:** Jobs, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.20 / 1,000 job scrapeds 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/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 ## CareerBuilder Jobs Scraper Collect job listings from CareerBuilder. Search by keyword and location or paste links, then get a clean, flat record per job: title, hiring company with its profile, location with coordinates, salary range, employment type, apply link, posting dates, and the full job description. ### Why this scraper - Rich, flat records: 40+ fields per job, including the hiring company's profile (logo, website, size, description), map coordinates, salary min/max with currency and unit, remote/onsite, and the direct apply link. - Two ways to start: search by keyword and location with a date sort, or paste search-result and job-detail URLs. - Full descriptions on demand: turn on detail enrichment to attach each job's complete description. - Multi-search: give several keywords and several locations, and every combination is searched. - Optional export: pipe results straight into Notion, Linear, Airtable, or Apify via MCP connectors. ### Data you get > Sample shape, values are illustrative placeholders, not from a live listing. | Field | Example | |---|---| | jobId | `00000000-0000-0000-0000-000000000000` | | title | `Sample Software Engineer` | | company | `Sample Company` | | companyLogo | `https://media.example.com/logo.png` | | companyWebsite | `http://www.example.com` | | companySize | `100 to 499 employees` | | location | `New York, NY, US` | | city | `New York` | | state | `NY` | | country | `US` | | latitude | `40.714` | | longitude | `-74.006` | | isRemote | `false` | | employmentType | `FULL_TIME` | | industry | `Software` | | salary | `USD 160,000 - 185,000 Per year` | | salaryMin | `160000` | | salaryMax | `185000` | | salaryCurrency | `USD` | | salaryUnit | `Per year` | | snippet | `Short summary of the role.` | | description | `Full HTML job description (with detail enrichment on).` | | datePosted | `2026-01-01T00:00:00.000Z` | | dateRecency | `9 days ago` | | applyType | `INTEGRATED` | | applyUrl | `https://apply.example.com/job/000` | | directApply | `true` | | url | `https://www.careerbuilder.com/job-details/sample--00000000-0000-0000-0000-000000000000` | ### How to use Search by keyword and location: ```json { "mode": "search", "queries": ["software engineer"], "location": ["New York, NY"], "sortBy": "date", "fetchDetails": true, "maxItems": 50 } ```` Paste URLs: ```json { "mode": "url", "startUrls": [ "https://www.careerbuilder.com/jobs-registered-nurse-in-chicago,il", "https://www.careerbuilder.com/job-details/sample--00000000-0000-0000-0000-000000000000" ], "fetchDetails": true, "maxItems": 20 } ``` ### Input | Field | Description | |---|---| | mode | `search` (keywords + locations) or `url` (paste links). | | queries | Job titles or keywords to search (search mode). | | location | Optional locations as `City, ST` or a city name; each keyword is searched in each location. | | sortBy | `relevance` or `date` (most recent first). | | startUrls | CareerBuilder search-result or job-detail URLs (url mode). | | fetchDetails | Attach each job's full description. | | maxItems | Total jobs to return (the run cap). | | proxy | Connection settings (see below). | | mcpConnectors | Optionally pipe results into Notion, Linear, Airtable, or Apify. | ### Reviews CareerBuilder does not expose company reviews or ratings on its job data, so review fields are not part of the output. ### Connection CareerBuilder serves the United States market. For reliable results, use Apify Residential proxy with country = US. On datacenter connections or the free tier, results may be less reliable, so residential is recommended. ### Plan Requirement This actor runs on any Apify plan, including the free tier. ### Send results into your apps (MCP connectors) Optionally pipe every job straight into the apps you already use via Model Context Protocol (MCP) connectors. Authorize a connector under Apify then Settings then API & Integrations, then select it in the `mcpConnectors` input. Notion gets a page per job; Linear, Airtable, and Apify get a best-effort write. Leave it empty to skip. ### Pricing You are billed per run start, per job returned, and per job enriched with its full description (only when detail fetching is on). See the Store listing for current rates. # Actor input Schema ## `mode` (type: `string`): search = provide job keywords and optional locations. url = paste search-result or job-detail URLs and walk them. ## `queries` (type: `array`): One or more job titles or keywords, e.g. software engineer, registered nurse, truck driver. ## `location` (type: `array`): Optional. One or more locations as 'City, ST' (e.g. New York, NY) or a city name. Each keyword is searched in each location. Leave empty for nationwide. ## `sortBy` (type: `string`): Order of results within each search. ## `startUrls` (type: `array`): Paste CareerBuilder search-result URLs (jobs-...) or job-detail URLs (job-details/...). Multi-URL supported. ## `fetchDetails` (type: `boolean`): Attach the complete job description to each job. Leave off for description-light results. ## `maxItems` (type: `integer`): Total jobs to return across all searches or URLs. This is the run cap. ## `proxy` (type: `object`): CareerBuilder serves the United States market. Use Apify Residential proxy with country = US for reliable results. ## `mcpConnectors` (type: `array`): Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify then Settings then API & Integrations, then select it here. Notion gets a page-per-item export; other connectors get a best-effort write. Leave empty to skip. Supported: Notion, Linear, Airtable, Apify. ## `notionParentPageUrl` (type: `string`): URL or id of the Notion page under which item pages are created. Required only for the Notion export. ## `maxNotifyListings` (type: `integer`): Cap on items written to each connector per run. Does not affect the dataset. ## Actor input object example ```json { "mode": "search", "queries": [ "software engineer" ], "location": [ "New York, NY" ], "sortBy": "relevance", "startUrls": [ "https://www.careerbuilder.com/jobs-software-engineer-in-new-york,ny" ], "fetchDetails": false, "maxItems": 20, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" }, "maxNotifyListings": 50 } ``` # Actor output Schema ## `overview` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "queries": [ "software engineer" ], "location": [ "New York, NY" ], "startUrls": [ "https://www.careerbuilder.com/jobs-software-engineer-in-new-york,ny" ], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/careerbuilder-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "queries": ["software engineer"], "location": ["New York, NY"], "startUrls": ["https://www.careerbuilder.com/jobs-software-engineer-in-new-york,ny"], "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("abotapi/careerbuilder-scraper").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 '{ "queries": [ "software engineer" ], "location": [ "New York, NY" ], "startUrls": [ "https://www.careerbuilder.com/jobs-software-engineer-in-new-york,ny" ], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call abotapi/careerbuilder-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=abotapi/careerbuilder-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "CareerBuilder Scraper – Jobs, Salaries & Company Profiles", "description": "Scrape CareerBuilder.com job listings by search or URL. Returns title, company profile, location with coordinates, salary range, employment type, apply link, posting dates, and full job description, with date sorting and optional detail enrichment.", "version": "1.0", "x-build-id": "fitsepODfZvOKx2em" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~careerbuilder-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-careerbuilder-scraper", "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/abotapi~careerbuilder-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-careerbuilder-scraper", "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/abotapi~careerbuilder-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-careerbuilder-scraper", "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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "search = provide job keywords and optional locations. url = paste search-result or job-detail URLs and walk them.", "default": "search" }, "queries": { "title": "Job keywords", "type": "array", "description": "One or more job titles or keywords, e.g. software engineer, registered nurse, truck driver.", "items": { "type": "string" } }, "location": { "title": "Locations", "type": "array", "description": "Optional. One or more locations as 'City, ST' (e.g. New York, NY) or a city name. Each keyword is searched in each location. Leave empty for nationwide.", "items": { "type": "string" } }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Order of results within each search.", "default": "relevance" }, "startUrls": { "title": "URLs", "type": "array", "description": "Paste CareerBuilder search-result URLs (jobs-...) or job-detail URLs (job-details/...). Multi-URL supported.", "items": { "type": "string" } }, "fetchDetails": { "title": "Fetch full job details", "type": "boolean", "description": "Attach the complete job description to each job. Leave off for description-light results.", "default": false }, "maxItems": { "title": "Max jobs", "minimum": 0, "type": "integer", "description": "Total jobs to return across all searches or URLs. This is the run cap.", "default": 20 }, "proxy": { "title": "Proxy", "type": "object", "description": "CareerBuilder serves the United States market. Use Apify Residential proxy with country = US for reliable results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify then Settings then API & Integrations, then select it here. Notion gets a page-per-item export; other connectors get a best-effort write. Leave empty to skip. Supported: Notion, Linear, Airtable, Apify." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL or id of the Notion page under which item pages are created. Required only for the Notion export." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "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 } } } } } } } } } } ```