# SimplyHired Scraper (`parseforge/simplyhired-scraper`) Actor
Scrape job listings from SimplyHired with structured salary data, skill extraction, and company details. Returns 27 fields per listing including parsed salary ranges, detected skills, requirements, benefits, remote flags, and experience levels. Supports keyword, location, and job type filters.
- **URL**: https://apify.com/parseforge/simplyhired-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Jobs, Lead generation, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $7.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.
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
## 💼 SimplyHired Scraper
Whether you're a recruiter tracking hiring trends, a data analyst benchmarking salaries, or a business owner monitoring your competition's job postings, this actor makes it easy to extract structured job listing data from SimplyHired at scale.
> **The SimplyHired Scraper extracts detailed job listings with salary data and company info, with 25+ structured fields per listing, plus smart skill and requirement extraction from job descriptions.**
### ✨ What Does It Do
- 🔍 **Keyword & Location Search** — Search for any job title, skill, or keyword in any location worldwide
- 💰 **Salary Parsing** — Automatically extracts and structures salary ranges into min, max, currency, and pay period
- 🛠️ **Skill Extraction** — Identifies programming languages, frameworks, cloud platforms, and tools mentioned in descriptions
- 📋 **Requirement Mining** — Pulls structured requirements, qualifications, and benefits from job descriptions
- 🏢 **Company Intelligence** — Captures company names, ratings, and profile links for lead generation
- 🏠 **Remote Detection** — Automatically flags remote, hybrid, and on-site positions
- 📊 **Job Type Classification** — Detects full-time, part-time, contract, temporary, and internship positions
- 🎯 **Experience Level Detection** — Classifies listings as entry-level, mid-level, senior, or director
- 📄 **Full Descriptions** — Captures both plain text and HTML formatted job descriptions
### 🎬 Demo Video
_Coming soon_
### 🔧 Input
**keyword** — The job search term. Use job titles like "software engineer" or skills like "Python developer". Default: `software engineer`.
**location** — Where to search. Accepts cities ("New York, NY"), states ("California"), countries ("USA"), or "Remote". Default: `USA`.
**startUrls** — Direct SimplyHired search URLs. When provided, keyword and location are ignored. Useful for pre-filtered searches you've built on the site.
**jobType** — Filter by employment type: Full-time, Part-time, Contract, Temporary, or Internship.
**datePosted** — Filter by posting recency: Last 24 hours, Last 3 days, Last 7 days, or Last 14 days.
**salaryMin** — Minimum salary filter (e.g., "50000" for $50k+).
**remote** — Set to true to filter for remote positions only.
**scrapeJobDetails** — Visit each job page for full descriptions, skills, and requirements. Enabled by default. Disable for faster but less detailed results.
**maxItems** — Maximum number of job listings to collect.
```json
{
"keyword": "data engineer",
"location": "San Francisco, CA",
"jobType": "fulltime",
"datePosted": "7",
"remote": false,
"scrapeJobDetails": true,
"maxItems": 100
}
````
### 📊 Output
| 📌 | Field | Description |
|---|---|---|
| 🔗 | url | Direct link to the job listing |
| 🔑 | jobKey | Unique job identifier for deduplication |
| 📝 | title | Job title |
| 🏢 | company | Hiring company name |
| 🔗 | companyUrl | Link to company profile |
| ⭐ | companyRating | Company rating when available |
| 📍 | location | Job location |
| 💰 | salary | Full salary text as displayed |
| 💵 | salaryMin | Parsed minimum salary amount |
| 💵 | salaryMax | Parsed maximum salary amount |
| 💱 | salaryCurrency | Currency code (USD, EUR, GBP) |
| 📅 | salaryPeriod | Pay period (YEAR, MONTH, HOUR) |
| 📋 | jobType | Employment type (Full-time, Contract, etc.) |
| ✂️ | snippet | Short preview from search results |
| 📄 | descriptionText | Full job description in plain text |
| 🖥️ | descriptionHtml | Full job description in HTML |
| ✅ | requirements | Extracted requirements list |
| 🛠️ | skills | Detected technical skills and tools |
| 🎁 | benefits | Extracted benefits and perks |
| 🎓 | qualifications | Required qualifications |
| 🏠 | remoteAttributes | Remote/Hybrid/On-site flags |
| 📊 | experienceLevel | Detected seniority level |
| 📌 | sponsored | Whether listing is sponsored |
| 📅 | datePosted | Original posting date |
| 🔗 | sourceSearchUrl | Search URL that found this listing |
| 🌐 | source | Data source (SimplyHired) |
| ⏰ | scrapedAt | Extraction timestamp |
```json
{
"url": "https://www.simplyhired.com/job/example123",
"jobKey": "example123",
"title": "Senior Software Engineer",
"company": "Acme Corp",
"companyUrl": "https://www.simplyhired.com/company/acme",
"companyRating": 4.2,
"location": "New York, NY",
"salary": "$140,000 - $180,000 a year",
"salaryMin": 140000,
"salaryMax": 180000,
"salaryCurrency": "USD",
"salaryPeriod": "YEAR",
"jobType": "Full-time",
"snippet": "We are looking for a Senior Software Engineer to join our team...",
"descriptionText": "Full job description text...",
"descriptionHtml": "Full job description HTML...
",
"requirements": ["5+ years of experience with distributed systems", "Strong proficiency in Python or Go"],
"skills": ["Python", "Go", "AWS", "Kubernetes", "PostgreSQL"],
"benefits": ["Health insurance", "401(k) matching", "Unlimited PTO"],
"qualifications": [],
"remoteAttributes": ["Hybrid"],
"experienceLevel": "Senior",
"sponsored": false,
"datePosted": "2026-03-28",
"sourceSearchUrl": "https://www.simplyhired.com/search?q=software+engineer&l=New+York",
"source": "SimplyHired",
"scrapedAt": "2026-04-01T12:00:00.000Z"
}
```
### 💎 Why Choose the SimplyHired Scraper?
| Feature | Our Actor | Alternatives |
|---|---|---|
| Output Fields | 27 structured fields | 10-15 fields |
| Salary Parsing | Min/Max/Currency/Period | Raw text only |
| Skill Extraction | Automatic from descriptions | Not available |
| Requirement Mining | Structured lists | Not available |
| Experience Level | Auto-detected | Not available |
| Remote Detection | Automatic flags | Manual only |
| Job Type Detection | Multiple types per listing | Single or none |
| Free Preview | 10 items free | Limited or none |
### 📋 How to Use
1. **Sign Up** — [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) on Apify
2. **Configure** — Enter your search keyword, location, and any filters. Set maxItems for the number of results you need
3. **Run It** — Click Start and let the actor collect your data
That's it. No coding, no setup, no API keys needed.
### 🎯 Business Use Cases
- 🧑💼 **Recruiters** — Monitor job market trends across locations and roles. Track which companies are hiring and at what salary ranges to optimize your placement strategy
- 📊 **HR Analytics Teams** — Build compensation benchmarking datasets. Compare salary ranges across regions, industries, and experience levels to inform hiring budgets
- 🏢 **Competitive Intelligence** — Track competitor hiring patterns. Know when rivals are scaling specific teams or entering new markets based on their job postings
- 🔬 **Market Researchers** — Analyze demand for specific skills and technologies over time. Identify emerging roles and declining ones across industries
- 🤖 **Job Aggregators** — Feed structured job data into your platform. Enrich listings with parsed skills, salary ranges, and experience levels
- 💡 **Career Coaches** — Advise clients using real salary data and skill demand metrics. Show which skills command the highest compensation
### ❓ FAQ
#### 🔍 How many jobs can I collect per run?
Free users can preview up to 10 results. Paid users can collect up to 1,000,000 listings per run, limited only by available search results.
#### 💰 Why are some salary fields empty?
Not all employers include salary information in their job postings. When salary is listed, the actor automatically parses it into structured min, max, currency, and period fields.
#### 🛠️ How are skills extracted?
The actor uses pattern matching to identify programming languages, frameworks, cloud platforms, databases, and other technical tools mentioned anywhere in the job description.
#### 📄 What's the difference between descriptionText and descriptionHtml?
`descriptionText` is plain text suitable for analysis and search. `descriptionHtml` preserves the original formatting with headings, lists, and links.
#### 🔄 Can I run this on a schedule?
Yes. Use Apify's built-in scheduling to run the actor daily, weekly, or at any interval. New results are deduplicated by job key.
#### 🌐 Does it work for non-US locations?
Yes. SimplyHired covers multiple countries. Enter any location supported by SimplyHired in the location field.
### 🔗 Integrate SimplyHired Scraper with any app
- [Google Sheets](https://docs.apify.com/platform/integrations/google-sheets) — Export job data directly to spreadsheets for team analysis
- [Slack](https://docs.apify.com/platform/integrations/slack) — Get notified when new jobs matching your criteria are found
- [Webhooks](https://docs.apify.com/platform/integrations/webhooks) — Send results to your own API endpoints in real-time
- [Zapier](https://docs.apify.com/platform/integrations/zapier) — Connect to 5,000+ apps without writing code
- [Make](https://docs.apify.com/platform/integrations/make) — Build powerful no-code automation workflows
### 💡 More ParseForge Actors
- [LinkedIn Jobs Scraper](https://apify.com/parseforge/linkedin-jobs-scraper) — Extract job postings from LinkedIn with salary and skill data
- [Google Maps Reviews Scraper](https://apify.com/parseforge/google-maps-reviews-scraper) — Collect business reviews with sentiment analysis
- [SEEK New Zealand Scraper](https://apify.com/parseforge/seek-new-zealand-scraper) — Job listings from New Zealand's largest job site
Browse our complete collection at [ParseForge on Apify Store](https://apify.com/parseforge).
### 🚀 Ready to Start?
[Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) and start collecting SimplyHired job data in minutes.
### 🆘 Need Help?
- 📖 Check the FAQ section above
- 📚 Visit [Apify Documentation](https://docs.apify.com/)
- 💬 [Contact us](https://tally.so/r/parseforge-support) for custom requirements
### ⚠️ Disclaimer
> This Actor is an independent tool and is not affiliated with, endorsed by, or connected to SimplyHired or Indeed Inc. in any way. It is designed for legitimate data collection and research purposes. Users are responsible for complying with applicable terms of service and data protection regulations.
# Actor input Schema
## `keyword` (type: `string`):
Job search keyword (e.g., 'software engineer', 'data analyst', 'product manager')
## `location` (type: `string`):
Location to filter jobs by (e.g., 'New York, NY', 'Remote', 'USA')
## `startUrls` (type: `array`):
Direct SimplyHired search URLs. If provided, keyword and location are ignored
## `jobType` (type: `string`):
Filter by employment type
## `datePosted` (type: `string`):
Filter by when the job was posted
## `salaryMin` (type: `string`):
Minimum salary filter (e.g., '50000', '80000')
## `remote` (type: `boolean`):
Filter for remote jobs only
## `scrapeJobDetails` (type: `boolean`):
Visit each job page to get full description, requirements, and benefits. Slower but more data
## `maxItems` (type: `integer`):
Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000
## `proxyConfiguration` (type: `object`):
Proxy settings for reliable collection
## Actor input object example
```json
{
"keyword": "software engineer",
"location": "USA",
"remote": false,
"scrapeJobDetails": true,
"maxItems": 10,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
```
# 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 = {
"keyword": "software engineer",
"location": "USA",
"maxItems": 10,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/simplyhired-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 = {
"keyword": "software engineer",
"location": "USA",
"maxItems": 10,
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
},
}
# Run the Actor and wait for it to finish
run = client.actor("parseforge/simplyhired-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 '{
"keyword": "software engineer",
"location": "USA",
"maxItems": 10,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}' |
apify call parseforge/simplyhired-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=parseforge/simplyhired-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "SimplyHired Scraper",
"description": "Scrape job listings from SimplyHired with structured salary data, skill extraction, and company details. Returns 27 fields per listing including parsed salary ranges, detected skills, requirements, benefits, remote flags, and experience levels. Supports keyword, location, and job type filters.",
"version": "1.0",
"x-build-id": "wMS4vTMIDL6wfNNI6"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/parseforge~simplyhired-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-parseforge-simplyhired-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/parseforge~simplyhired-scraper/runs": {
"post": {
"operationId": "runs-sync-parseforge-simplyhired-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/parseforge~simplyhired-scraper/run-sync": {
"post": {
"operationId": "run-sync-parseforge-simplyhired-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",
"properties": {
"keyword": {
"title": "Search Keyword",
"type": "string",
"description": "Job search keyword (e.g., 'software engineer', 'data analyst', 'product manager')"
},
"location": {
"title": "Location",
"type": "string",
"description": "Location to filter jobs by (e.g., 'New York, NY', 'Remote', 'USA')"
},
"startUrls": {
"title": "Start URLs",
"type": "array",
"description": "Direct SimplyHired search URLs. If provided, keyword and location are ignored",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"title": "URL",
"description": "SimplyHired search URL"
}
}
}
},
"jobType": {
"title": "Job Type",
"enum": [
"",
"fulltime",
"parttime",
"contract",
"temporary",
"internship"
],
"type": "string",
"description": "Filter by employment type"
},
"datePosted": {
"title": "Date Posted",
"enum": [
"",
"1",
"3",
"7",
"14"
],
"type": "string",
"description": "Filter by when the job was posted"
},
"salaryMin": {
"title": "Minimum Salary",
"type": "string",
"description": "Minimum salary filter (e.g., '50000', '80000')"
},
"remote": {
"title": "Remote Only",
"type": "boolean",
"description": "Filter for remote jobs only",
"default": false
},
"scrapeJobDetails": {
"title": "Scrape Full Job Details",
"type": "boolean",
"description": "Visit each job page to get full description, requirements, and benefits. Slower but more data",
"default": true
},
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
},
"proxyConfiguration": {
"title": "Proxy Configuration",
"type": "object",
"description": "Proxy settings for reliable collection"
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```