# SimplyHired Jobs Scraper | $0.8 / 1k | All In One (`fatihtahta/simplyhired-jobs-scraper`) Actor Extract structured SimplyHired job listings with titles, salaries, company data, locations, full descriptions and more across US, Canada, and all localized markets. Built for enterprise-grade hiring intelligence, labor market analysis, and automated recruiting or analytics pipelines. - **URL**: https://apify.com/fatihtahta/simplyhired-jobs-scraper.md - **Developed by:** [Fatih Tahta](https://apify.com/fatihtahta) (community) - **Categories:** Jobs, Automation, Developer tools - **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $0.80 / 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 ## SimplHired Scraper | All In One **Slug:** `fatihtahta/simplyhired-jobs-scraper` ### Overview SimplHired Scraper | All In One collects structured job listing data such as job title, company name, location, salary details, posting date, apply link, and full job description. It supports country-specific SimplyHired marketplaces across the United States, Canada, China, Argentina, Australia, Austria, Belgium, Brazil, Germany, Spain, France, India, Ireland, Italy, Japan, Mexico, the Netherlands, Portugal, South Africa, South Korea, Sweden, Switzerland, and the United Kingdom, which makes it useful for labor market research, hiring intelligence, and operational reporting. Instead of running manual searches and copying listings one by one, you can automate recurring collection with consistent filters and export-ready JSON output. The result is a cleaner, more dependable dataset that saves time for analysts, operators, and engineering teams. ### Why Use This Actor - **Market research and analytics teams:** Track job demand, salary ranges, hiring activity, and regional trends across keywords, locations, and countries. - **Product and content teams:** Identify hiring patterns, employer demand, and topic momentum to inform content calendars, landing pages, or roadmap priorities. - **Developers and data engineering teams:** Feed structured job records into ETL jobs, dashboards, internal search tools, enrichment pipelines, and reporting workflows. - **Lead generation and enrichment teams:** Find relevant employers, validate company hiring activity, and enrich outreach lists with current job and location context. - **Monitoring and competitive tracking teams:** Watch competitor hiring signals, compare posting velocity over time, and detect changes in role mix by market. ### Input Parameters Provide any combination of URLs, queries, and filters where supported; for this actor, most runs are driven by queries and search filters. | Parameter | Type | Description | Default | | --- | --- | --- | --- | | `country` | `string` | Country-specific SimplyHired marketplace to search. Allowed values: `united-states`, `canada`, `china`, `argentina`, `australia`, `austria`, `belgium`, `brazil`, `germany`, `spain`, `france`, `india`, `ireland`, `italy`, `japan`, `mexico`, `netherlands`, `portugal`, `south-africa`, `south-korea`, `sweden`, `switzerland`, `united-kingdom`. | `united-states` | | `queries` | `string[]` | One or more search terms, such as job titles, skills, industries, or employer names. Each entry runs as a separate search. | – | | `location` | `string` | Search area to focus results by city, state, ZIP or postal code, or place name. | – | | `radius` | `string` | Distance from the selected location. Allowed values: `exact`, `5`, `10`, `15`, `25`, `50`, `100`. | `25` | | `remote_only` | `boolean` | When `true`, limits results to remote jobs instead of location-based local results. | `false` | | `min_salary` | `integer` | Minimum salary threshold to include in results. Use `0` or higher. | – | | `sort_by` | `string` | Result ordering. Allowed values: `relevance`, `date`. | `relevance` | | `date_published` | `string` | Only include jobs posted within a recent window. Allowed values: `1` (last 24 hours), `7` (last 7 days), `14` (last 14 days), `30` (last 30 days). | – | | `job_type` | `string` | Filter by job type. Allowed values: `CF3CP` (Full time), `75GKK` (Part time), `NJXCK` (Contract), `4HKF7` (Temporary), `VDTG7` (Internship). | – | | `limit` | `integer` | Maximum number of listings to collect per search term. Leave empty to continue through available results. | – | ### Example Inputs #### Scenario: Query-driven hiring research ```json { "country": "united-states", "queries": ["data analyst", "business analyst"], "location": "Chicago, IL", "radius": "25", "sort_by": "relevance", "date_published": "7", "limit": 150 } ```` #### Scenario: Remote-only role discovery ```json { "country": "canada", "queries": ["customer success manager"], "remote_only": true, "min_salary": 80000, "sort_by": "date", "date_published": "14", "limit": 100 } ``` #### Scenario: Targeted local search with salary and job type filters ```json { "country": "united-kingdom", "queries": ["registered nurse"], "location": "London", "radius": "15", "job_type": "CF3CP", "min_salary": 45000, "sort_by": "date", "limit": 120 } ``` ### Output #### 6.1 Output destination The actor writes results to an Apify dataset as JSON records. And the dataset is designed for direct consumption by analytics tools, ETL pipelines, and downstream APIs without post-processing. #### 6.2 Record envelope (all items) This actor emits one logical record type: `job`. - **type** *(string, recommended for normalization)*: Use `job` when building a standardized record envelope across datasets. - **id** *(string, required)*: Stable SimplyHired job identifier. - **url** *(string, required)*: Canonical URL of the job listing. Recommended idempotency key: `type + ":" + id` Use that key for deduplication and upserts when the same listing appears across multiple queries, schedules, or exports. #### 6.3 Examples Example: job (`type = "job"`) ```json { "id": "GaXPoSWJs1pOWI0apJXzbncaacfasBpu_v0cgt3eDCizvbWFA5OT7g", "url": "https://www.simplyhired.com/job/GaXPoSWJs1pOWI0apJXzbncaacfasBpu_v0cgt3eDCizvbWFA5OT7g", "applyUrl": "https://www.simplyhired.com/out?r=Uw0JXvihu0NKcnDMvM6DyOHvnZoYlSzGBMUeF2BER-1hfYGTL47CoZ4BbPR5AcBqFQ6WCbnifJOJL4Ze1kMZIAHKtYqpiEAP4ahFUA0OLi42f1q3E50WFNfshyK7FlBqIh0UWpjHKnkV9oFIV9aFqRjfnzJWynXuVghftBe6krOEWAXHPF5T8Z0chIGEcIZf2u2MX-mVUbuWEqyn2IM4W7iWmi9CoRkLjk0QDpJbqWwlLfBz25P2uyQfPSns9jzP2o6nWQPtNBRD5uluqS-EgesZpnnrYb90PRslKfeS8D9ZaIdLKIYQg37iBe9TWfrrYa2xwtHyJNfc3dglgtgMGkYNPGueeyHYkHY8Tq_ncjMST3-zMafYtC8SZg2yFovlphvTTHFlUs0LlpfHrL-1pl5tUGbnBWNBGwfriMf_1hDZ7eGFeekKlYiL12KKRr3MQ_HuhYNylvipLxW7Z3_vcaD4bAqZbgw9LqJ5C9BL2RBWbrw3Z9NvOG1JKri-BSp7oe2lNelWoIxwbGowtTTZVPAv7EV7oUxmNhxwrcnTBoce6-yUv7cn8m1Wz-HfaXWQD5hmEOxtQYWebyGzI7CGPs5rk3XVddpjZRax4q1GIi-TOGOnolQEc9qAw_JFOV34R99KIvpRbEFFNB0z10PWUI70le8uyizDX3Mcpbum2Zuw8SK8Ufe64PYg5_akgbAImDTkL5C5VGmf3DiH9s1XrW-5MghUfJx_zX6PtIqmR141EoMUZ2rv8GY3luIef9_MwJw9M4GlAWdqxVAi4RGoMzoocmHuhok5KeglNGH_ppGhUWdudC9x", "title": "Nurse Manager – Cardiovascular Center, Westwood", "sourceUrl": "https://www.simplyhired.com/search?q=manager&l=90210&mip=150000&sr=5", "seedId": "ef38c2d88459", "seedType": "query", "seedValue": "manager", "pageIndex": 1, "company": "UCLA Health", "location": "Los Angeles, CA", "city": "Los Angeles", "state": "CA", "latitude": 34.065197, "longitude": -118.44658, "snippet": "Provides leadership and direct supervision, monitoring, and evaluation of the clinical and administrative clinic staff.", "description": "Description Major duties include but are not limited to: Accountable for the clinical care and the daily operations of the clinic. Provides direct operational oversight for the clinic in the absence of the Clinic Operations Manager. Provides leadership and direct supervision, monitoring, and evaluation of the clinical and administrative clinic staff. Responsible for coordination of clinical services for the staff, adherence to personnel policies and procedures. Provides continuous quality improvement for the clinic and creates a culture of teamwork to ensure successful and efficient daily operations, interdisciplinary collaborations, and the timely achievement of departmental and University objectives. Demonstrates leadership skills including advanced communication, coaching, and conflict resolution. Coordinates with the Clinic Operations Manager in hiring, recruiting and retention of qualified personnel; establishing departmental goals; and systems management of human, financial, and physical resources with autonomy. Manages resources and oversees compliance with internal policies and external regulatory agency requirements and contributes to strategic plans and policies. Utilizes a wide range of alternatives in problem solving and demonstrates a high degree of professional competence and skill. Responsible for maintaining an environment that aligns Oversee Westwood Cardiovascular Centers including Suites 630 West, 630 East, 690 and 545. Salary Range: $124,600 - $289,400 /annually Qualifications Required Graduate from an accredited school of nursing. BSN required. MSN preferred. CA RN License ACLS from American Heart Association or American Red Cross Two-year previous charge RN or leadership Knowledge of Cardiology and General Surgical patient population. Ability to supervise and provide leadership and direction to the clinical staff in accordance with organizations and departmental goals and objectives. Ability to complete a nursing physical assessment with strong critical thinking skills. Ability to apply a broad knowledge base to act effectively to coordinate and assess patient care and act as a liaison with nursing staff, outside agencies, team physicians, referring physicians, patient and family. Ability to represent the Medical Center in site visits and review by managed care, insurance groups, and regulatory entities. Ability to provide a leadership style that demonstrates principles of time management, conflict resolution, problem-solving and delegation. Ability to evaluate the effectiveness of interventions toward the attainment of established goals and to recognize the need to reassess or reset goal parameters Ability to delegate tasks in a management style that is consistent with promoting leadership and teamwork Knowledge base to provide education to patients, families, and other staff regarding clinical and patient care issues Excellent organizational skills, proficiency in meeting deadlines, ability to work independently and prioritize workload. Ability to manage numerous concurrent tasks in a high stress environment and deal with change. Preferred: Ambulatory clinic experience Spanish speaking skills", "descriptionHtml": "
Description

Major duties include but are not limited to:

Salary Range: $124,600 - $289,400 /annually
Qualifications

Required

Preferred:

", "salaryText": "$124,600 - $298,100 a year", "salaryMin": 124600, "salaryMax": 298100, "salaryCurrency": "$", "salaryPeriod": "year", "publishedAt": "2026-03-31T05:00:00+00:00", "companyRating": 4.1, "normalizedTitle": "nurse manager", "requirements": [ "Spanish", "Nursing", "RN License", "ACLS Certification", "Outpatient", "Clinic", "Team management", "Conflict management", "Bachelor of Science in Nursing", "Recruiting", "Organizational skills", "Senior level", "Leadership", "Communication skills", "Cardiology" ], "qualifications": [ "Collaborate with healthcare professionals", "Direct patient care", "Spanish", "Nursing department supervision", "Nursing", "Managerial strategic planning", "Strategic management", "Clinical supervision", "Recruitment process management", "Operations management", "Healthcare resource management", "Managed care", "RN License", "Outpatient clinic experience", "Patient assessment", "Regulatory compliance", "Master's degree in nursing", "Employee retention", "ACLS Certification", "Outpatient", "Diagnostic evaluation", "Team management", "Cardiology", "Conflict management", "Bachelor of Science in Nursing", "Clinical staff recruitment", "Recruiting", "Organizational skills", "Healthcare team management", "Charge experience", "MSN", "Bachelor's degree in nursing", "Continuous quality improvement (CQI)", "Financial management", "Patient treatment", "Senior level", "Patient education", "Care coordination", "Leadership", "Healthcare compliance", "Communication skills", "Staffing management" ], "uncategorized": [ "Collaborate with healthcare professionals", "Direct patient care", "Nursing department supervision", "Managerial strategic planning", "Strategic management", "Clinical supervision", "Recruitment process management", "Operations management", "Healthcare resource management", "Managed care", "Outpatient clinic experience", "Patient assessment", "Regulatory compliance", "Master's degree in nursing", "Employee retention", "Diagnostic evaluation", "Cardiology", "Clinical staff recruitment", "Healthcare team management", "Charge experience", "MSN", "Bachelor's degree in nursing", "Continuous quality improvement (CQI)", "Financial management", "Patient treatment", "Patient education", "Care coordination", "Healthcare compliance", "Staffing management" ], "companyPageUrl": "https://www.simplyhired.com/browse-jobs/companies/Ucla-Health", "employerSquareLogoUrl": "https://d2q79iu7y748jz.cloudfront.net/s/_squarelogo/128x128/afdaaed7658a3871b2e037f7ea059a12", "indeedApply": false, "sponsored": true, "auction": true, "expired": false, "domain": "simplyhired.com" } ``` ### Field reference #### Job fields (`type = "job"`) - **id** *(string, required)*: Stable job identifier. - **url** *(string, required)*: Canonical job listing URL. - **applyUrl** *(string, optional)*: Apply or outbound application URL. - **title** *(string, optional)*: Job title as listed. - **sourceUrl** *(string, required)*: Search results page where the listing was found. - **seedId** *(string, required)*: Stable identifier for the originating search input. - **seedType** *(string, required)*: Origin type for the search seed. Current value: `query`. - **seedValue** *(string, required)*: Original query value that led to the result. - **pageIndex** *(integer, required)*: Search results page index where the record was found. - **company** *(string, optional)*: Employer name. - **location** *(string, optional)*: Display location text. - **city** *(string, optional)*: City parsed from the listing. - **state** *(string, optional)*: State or region parsed from the listing. - **latitude** *(number, optional)*: Listing latitude when available. - **longitude** *(number, optional)*: Listing longitude when available. - **snippet** *(string, optional)*: Short preview text from the listing. - **description** *(string, optional)*: Plain-text job description. - **descriptionHtml** *(string, optional)*: HTML-formatted job description. - **salaryText** *(string, optional)*: Salary text as displayed. - **salaryMin** *(number, optional)*: Parsed minimum compensation. - **salaryMax** *(number, optional)*: Parsed maximum compensation. - **salaryCurrency** *(string, optional)*: Currency symbol or code when available. - **salaryPeriod** *(string, optional)*: Compensation period, such as `hour` or `year`. - **publishedAt** *(string, optional)*: Publication timestamp in ISO 8601 format. - **companyRating** *(number, optional)*: Employer rating when available. - **normalizedTitle** *(string, optional)*: Normalized version of the job title. - **requirements** *(array\[string], optional)*: Extracted requirements or skill tags. - **jobTypes** *(array\[string], optional)*: Job type labels associated with the listing. - **benefits** *(array\[string], optional)*: Benefits mentioned in the listing. - **remoteAttributes** *(array\[string], optional)*: Remote-work attributes when available. - **workSettings** *(array\[string], optional)*: Work setting labels such as onsite, hybrid, or remote when available. - **qualifications** *(array\[string], optional)*: Extracted qualifications. - **uncategorized** *(array\[string], optional)*: Additional extracted attributes that do not fit another category. - **companyPageUrl** *(string, optional)*: Public employer page URL on SimplyHired. - **employerSquareLogoUrl** *(string, optional)*: Employer logo image URL. - **indeedApply** *(boolean, optional)*: Indicates whether the listing shows an Indeed Apply flow. - **sponsored** *(boolean, optional)*: Indicates whether the listing is marked as sponsored. - **auction** *(boolean, optional)*: Indicates whether the listing is flagged with auction-related metadata. - **expired** *(boolean, optional)*: Indicates whether the listing appears expired. - **domain** *(string, optional)*: Source SimplyHired domain, such as `simplyhired.com`. ### Data guarantees & handling - **Best-effort extraction:** fields may vary by region, session, availability, and UI experiments. - **Optional fields:** null-check in downstream code. - **Deduplication:** recommend `type + ":" + id`. ### How to Run on Apify 1. Open the Actor in Apify Console. 2. Configure your search parameters, such as country, keywords, location, salary threshold, and posting window. 3. Set the maximum number of outputs to collect per search term if you want a bounded run. 4. Click **Start** and wait for the run to finish. 5. Download results in JSON, CSV, Excel, or other supported formats. ### Scheduling & Automation #### Scheduling **Automated Data Collection** You can schedule runs to keep your job dataset fresh without manually re-running the actor. This is useful for recurring market tracking, hiring monitoring, and regular reporting. - Navigate to **Schedules** in Apify Console - Create a new schedule (daily, weekly, or custom cron) - Configure input parameters - Enable notifications for run completion - Optional: add webhooks for automated processing #### Integration Options - **Webhooks:** Trigger downstream actions when a run completes - **Zapier:** Connect to 5,000+ apps without coding - **Make (Integromat):** Build multi-step automation workflows - **Google Sheets:** Export results to a spreadsheet - **Slack/Discord:** Receive notifications and summaries - **Email:** Send automated reports via email ### Performance These timings are estimates and will vary by search scope and output size. - **Small runs (< 1,000 outputs):** ~2–3 minutes - **Medium runs (1,000–5,000 outputs):** ~5–15 minutes - **Large runs (5,000+ outputs):** ~15–30 minutes Execution time varies based on filters, result volume, and how much information is returned per record. ### Compliance & Ethics #### Responsible Data Collection This actor collects publicly available job listing information from SimplyHired marketplaces in the United States, Canada, China, Argentina, Australia, Austria, Belgium, Brazil, Germany, Spain, France, India, Ireland, Italy, Japan, Mexico, the Netherlands, Portugal, South Africa, South Korea, Sweden, Switzerland, and the United Kingdom for legitimate business purposes. Common use cases include labor market research and market analysis, talent intelligence and recruitment operations, and competitive hiring tracking. This section is informational and not legal advice. - **Labor market** research and market analysis - **Talent intelligence** and recruitment operations - **Competitive hiring** tracking and benchmarking #### Best Practices - Use collected data in accordance with applicable laws, regulations, and the target site’s terms - Respect individual privacy and personal information - Use data responsibly and avoid disruptive or excessive collection - Do not use this actor for spamming, harassment, or other harmful purposes - Follow relevant data protection requirements where applicable, including GDPR and CCPA ### Support For help, use the Issues section on the actor page in Apify Console. Include the input you used with sensitive values redacted, the run ID, the expected behavior versus the actual behavior, and, if helpful, a small output sample. # Actor input Schema ## `country` (type: `string`): Select the country version of SimplyHired you want to search. This decides which local job marketplace the run uses and helps return listings that match that region. ## `queries` (type: `array`): Enter one or more keywords such as job titles, tools, industries, or employer names. Use multiple entries if you want to compare different searches in the same run. ## `location` (type: `string`): Enter a city, state, ZIP or postal code, or place name to focus the search on that area. If you type a place name, the actor will try to match it to the location format SimplyHired expects. ## `radius` (type: `string`): Choose how far from your selected location results can appear. Use a smaller radius for highly local roles or a larger one to include nearby cities and suburbs. ## `remote_only` (type: `boolean`): Turn this on to focus the run on remote opportunities instead of a physical search area. This is useful when you want work-from-home roles regardless of city or region. Country selection still applies. ## `min_salary` (type: `integer`): Enter the lowest salary you want included in the search results. This helps reduce noise when you only want roles above a certain pay threshold. ## `date_published` (type: `string`): Choose how recently a job must have been posted to appear in the results. This is helpful when you want to focus on active opportunities from the past few days or weeks. ## `job_type` (type: `string`): Select a job type to narrow results to the kinds of roles that fit your needs. Leave it unset if you want a broader mix of opportunities. ## `sort_by` (type: `string`): Sort results by relevance when you want the best keyword matches first, or by date when you want to review the most recently posted jobs first. ## `limit` (type: `integer`): Set the maximum number of listings to collect for each search term. Leave this empty if you want the actor to keep going until it reaches all available results. ## `maximize_coverage` (type: `boolean`): When enabled, the actor checks the search result count and recursively splits large searches into narrower child searches using available filters such as job type and salary thresholds. The actor respects any filters you already set and will not override user-selected values like job type. ## Actor input object example ```json { "country": "united-states", "radius": "25", "sort_by": "relevance", "maximize_coverage": false } ``` # Actor output Schema ## `results` (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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("fatihtahta/simplyhired-jobs-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 = {} # Run the Actor and wait for it to finish run = client.actor("fatihtahta/simplyhired-jobs-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 '{}' | apify call fatihtahta/simplyhired-jobs-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fatihtahta/simplyhired-jobs-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SimplyHired Jobs Scraper | $0.8 / 1k | All In One", "description": "Extract structured SimplyHired job listings with titles, salaries, company data, locations, full descriptions and more across US, Canada, and all localized markets. Built for enterprise-grade hiring intelligence, labor market analysis, and automated recruiting or analytics pipelines.", "version": "0.0", "x-build-id": "8md9aAs0xYxOQnIzQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~simplyhired-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-simplyhired-jobs-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/fatihtahta~simplyhired-jobs-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-simplyhired-jobs-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/fatihtahta~simplyhired-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-simplyhired-jobs-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": { "country": { "title": "Choose a Country to Search", "enum": [ "united-states", "canada", "china", "argentina", "australia", "austria", "belgium", "brazil", "germany", "spain", "france", "india", "ireland", "italy", "japan", "mexico", "netherlands", "portugal", "south-africa", "south-korea", "sweden", "switzerland", "united-kingdom" ], "type": "string", "description": "Select the country version of SimplyHired you want to search. This decides which local job marketplace the run uses and helps return listings that match that region.", "default": "united-states" }, "queries": { "title": "Add Search Terms", "type": "array", "description": "Enter one or more keywords such as job titles, tools, industries, or employer names. Use multiple entries if you want to compare different searches in the same run.", "items": { "type": "string" } }, "location": { "title": "Choose a Search Location (City, State or a Zip Code)", "type": "string", "description": "Enter a city, state, ZIP or postal code, or place name to focus the search on that area. If you type a place name, the actor will try to match it to the location format SimplyHired expects." }, "radius": { "title": "Set the Search Radius", "enum": [ "exact", "5", "10", "15", "25", "50", "100" ], "type": "string", "description": "Choose how far from your selected location results can appear. Use a smaller radius for highly local roles or a larger one to include nearby cities and suburbs.", "default": "25" }, "remote_only": { "title": "Show Only Remote Jobs", "type": "boolean", "description": "Turn this on to focus the run on remote opportunities instead of a physical search area. This is useful when you want work-from-home roles regardless of city or region. Country selection still applies." }, "min_salary": { "title": "Set a Minimum Salary", "minimum": 0, "type": "integer", "description": "Enter the lowest salary you want included in the search results. This helps reduce noise when you only want roles above a certain pay threshold." }, "date_published": { "title": "Filter by Posting Date", "enum": [ "1", "7", "14", "30" ], "type": "string", "description": "Choose how recently a job must have been posted to appear in the results. This is helpful when you want to focus on active opportunities from the past few days or weeks." }, "job_type": { "title": "Choose a Job Type", "enum": [ "CF3CP", "75GKK", "NJXCK", "4HKF7", "VDTG7" ], "type": "string", "description": "Select a job type to narrow results to the kinds of roles that fit your needs. Leave it unset if you want a broader mix of opportunities." }, "sort_by": { "title": "Choose How to Sort Results", "enum": [ "relevance", "date" ], "type": "string", "description": "Sort results by relevance when you want the best keyword matches first, or by date when you want to review the most recently posted jobs first.", "default": "relevance" }, "limit": { "title": "Limit Results per Search Term", "minimum": 1, "type": "integer", "description": "Set the maximum number of listings to collect for each search term. Leave this empty if you want the actor to keep going until it reaches all available results." }, "maximize_coverage": { "title": "Maximize Coverage", "type": "boolean", "description": "When enabled, the actor checks the search result count and recursively splits large searches into narrower child searches using available filters such as job type and salary thresholds. The actor respects any filters you already set and will not override user-selected values like job type.", "default": false } } }, "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 } } } } } } } } } } ```