# S1jobs.com Scraper (`shahidirfan/s1jobs-com-scraper`) Actor Extract live job postings from S1jobs instantly. Get job titles, companies, salaries, descriptions & contact details. Perfect for recruitment automation, job market monitoring, salary benchmarking & building AI training datasets. Structured, scalable output. - **URL**: https://apify.com/shahidirfan/s1jobs-com-scraper.md - **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community) - **Categories:** Jobs, Automation, AI - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## s1jobs.com Jobs Scraper Extract comprehensive job listings from s1jobs.com — Scotland's leading job board. Collect detailed vacancy data including salary ranges, company profiles, skills, job types, and full descriptions. Perfect for recruitment analytics, job market research, and talent acquisition workflows. ### Features - **Rich job data** — Extracts 29 fields per vacancy including salary ranges, skills, company details, and full descriptions - **Flexible search** — Search by keyword, location, or provide a direct s1jobs.com URL - **Salary breakdown** — Get annual and hourly salary ranges when available - **Company intelligence** — Collect company logos, profile URLs, and agency/employer classification - **Job flags** — Identify graduate roles, apprenticeships, public sector positions, and sponsored listings - **Location data** — City, county, district, and country-level location info - **Automatic pagination** — Continues collecting until your desired result count is reached - **No browser required** — Fast, lightweight extraction --- ### Use Cases #### Recruitment Market Analysis Analyze salary trends, skill demands, and hiring patterns across Scottish industries. Track which skills appear most frequently in job postings to inform training programs and hiring strategies. #### Job Board Aggregation Build a comprehensive jobs database by collecting listings from s1jobs.com alongside other sources. Power your own job search platform or internal vacancy tracker with up-to-date data. #### Competitive Intelligence Monitor competitor hiring activity, new roles, and salary ranges. Understand which companies are expanding, what roles they're filling, and what skills they prioritize. #### Academic Research Collect structured employment data for labor market studies, regional economic analysis, or skills gap research across Scotland's job market. #### HR Benchmarking Compare your organization's salary ranges, job requirements, and benefits against current market postings to stay competitive in talent acquisition. --- ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `keyword` | String | No | `developer` | Job search keyword (e.g., "nurse", "engineer", "manager") | | `location` | String | No | `Glasgow` | Location filter (e.g., "Edinburgh", "Aberdeen", "Scotland") | | `startUrl` | String | No | — | Direct s1jobs.com search URL (overrides keyword/location) | | `results_wanted` | Integer | No | `20` | Maximum number of job listings to collect | | `max_pages` | Integer | No | `5` | Safety cap on number of search pages to visit | | `collectDetails` | Boolean | No | `true` | Include full job description HTML and plain text | | `proxyConfiguration` | Object | No | Apify Proxy | Proxy settings for reliable extraction | --- ### Output Data Each item in the dataset contains: | Field | Type | Description | |-------|------|-------------| | `title` | String | Job title | | `company` | String | Hiring company name | | `location` | String | City or area of the job | | `country` | String | Country (e.g., "Scotland") | | `county` | String | County (e.g., "Glasgow Area") | | `district` | String | District within the city | | `salary` | String | Salary text (e.g., "£32000 - £34000") | | `salary_annual_low` | Number | Lower bound of annual salary | | `salary_annual_high` | Number | Upper bound of annual salary | | `salary_hourly_low` | Number | Lower bound of hourly rate | | `salary_hourly_high` | Number | Upper bound of hourly rate | | `job_type` | String | Contract type and hours (e.g., "Permanent / Full") | | `working_pattern` | String | Working location (e.g., "Hybrid working", "Remote") | | `agency_or_employer` | String | Whether listed by agency or direct employer | | `date_posted` | String | Publication date (ISO 8601) | | `closing_date` | String | Application closing or expiry date | | `url` | String | Full URL to the job listing on s1jobs.com | | `skills` | Array | Required skills listed for the role | | `vacancy_id` | String | Unique vacancy identifier | | `company_id` | String | Company identifier on s1jobs.com | | `company_logo` | String | URL of the company logo image | | `company_profile_url` | String | Link to the company's profile page | | `is_featured` | Boolean | Whether the listing is featured | | `is_sponsored` | Boolean | Whether the listing is sponsored | | `is_public_sector` | Boolean | Whether it's a public sector role | | `graduate` | Boolean | Whether it's a graduate position | | `apprenticeship` | Boolean | Whether it's an apprenticeship | | `immediate_start` | Boolean | Whether immediate start is available | | `requires_cv` | Boolean | Whether a CV is required to apply | | `has_video` | Boolean | Whether the listing includes a video | | `job_source` | String | Source of the job listing | | `description_html` | String | Full job description in HTML format | | `description_text` | String | Plain text version of the description | --- ### Usage Examples #### Search by Keyword and Location Extract developer jobs in Glasgow: ```json { "keyword": "developer", "location": "Glasgow", "results_wanted": 50 } ```` #### Search by Direct URL Provide a pre-built s1jobs.com search URL: ```json { "startUrl": "https://www.s1jobs.com/jobs/edininburgh/", "results_wanted": 100 } ``` #### Targeted Search with High Volume Collect a large set of nursing roles across Scotland: ```json { "keyword": "nurse", "location": "Scotland", "results_wanted": 200, "max_pages": 10 } ``` #### Minimal Output (No Descriptions) Speed up extraction by skipping full descriptions: ```json { "keyword": "accountant", "location": "Edinburgh", "results_wanted": 50, "collectDetails": false } ``` *** ### Sample Output ```json { "title": "Credit Controller", "company": "Oliver Smith Recruitment", "location": "Glasgow", "country": "Scotland", "county": "Glasgow Area", "salary": "£32000 - £34000", "salary_annual_low": 32000, "salary_annual_high": 34000, "job_type": "Permanent / Full", "working_pattern": "Hybrid working", "agency_or_employer": "Agency", "date_posted": "2026-06-04T14:35:40Z", "closing_date": "2026-06-18T14:35:33Z", "url": "https://www.s1jobs.com/job/credit-controller-126935034", "skills": [ "Credit control", "Debt collection", "Cash flow forecasting", "Account management" ], "vacancy_id": "c2871a02-b7f1-496c-83da-5380873cebcb", "company_id": "2964129", "company_logo": "https://www.s1jobs.com//ui/img/shared/company_logos/bf7285acecdfc5bc9622639c246d871a.gif", "is_featured": false, "is_sponsored": false, "is_public_sector": false, "graduate": false, "immediate_start": false, "requires_cv": true, "description_text": "Credit Control\n\nSalary up to £34k\n\nFree Parking\n\nHybrid (3 days at home)\n\nGlasgow City Centre..." } ``` *** ### Tips for Best Results #### Use Specific Keywords - Broad terms like "manager" return many results — narrow with location for relevance - Use exact job titles (e.g., "Senior Developer" vs "developer") for targeted results #### Set Reasonable Result Limits - Start with 20-50 results for testing - Increase to 200+ for production runs - The `max_pages` cap prevents runaway pagination #### Leverage Proxy Configuration - Enable Apify Proxy for consistent, reliable extraction - Residential proxies are recommended for best results #### Combine with Scheduling - Run daily or weekly to track new postings - Monitor salary trends and hiring velocity over time *** ### Integrations Connect your job data with: - **Google Sheets** — Export for spreadsheet analysis and salary comparisons - **Airtable** — Build searchable vacancy databases and hiring pipelines - **Slack** — Get notified when new roles matching your criteria appear - **Webhooks** — Push data to your ATS or recruitment platform - **Make** — Automate recruitment workflows and notifications - **Zapier** — Trigger actions when new data arrives #### Export Formats Download data in multiple formats: - **JSON** — For developers and API integrations - **CSV** — For spreadsheet analysis and reporting - **Excel** — For business intelligence and dashboards - **XML** — For system integrations *** ### Frequently Asked Questions #### How many jobs can I collect? You can set `results_wanted` to any number. s1jobs.com typically has thousands of active listings across Scotland. #### Does the scraper handle pagination? Yes, the actor automatically navigates through search result pages until your desired count is reached or `max_pages` is hit. #### What locations are supported? Any location available on s1jobs.com — cities (Glasgow, Edinburgh, Aberdeen), regions (Highlands, Lothian), or country-wide (Scotland). #### Are salary figures always available? Not all listings include salary information. When available, both the text display and numeric annual/hourly ranges are extracted. #### Can I search without a keyword? Yes — provide only a location or a direct URL to browse all jobs in a specific area. #### Does the actor collect job descriptions? Yes, when `collectDetails` is enabled (default). Both HTML and plain text versions are included. Disable for faster extraction if descriptions aren't needed. #### How fresh is the data? The actor extracts live data from s1jobs.com at the time of each run. Use Apify's scheduling feature to keep your dataset updated automatically. *** ### Support For issues or feature requests, contact support through the Apify Console. #### Resources - [Apify Documentation](https://docs.apify.com/) - [API Reference](https://docs.apify.com/api/v2) - [Scheduling Runs](https://docs.apify.com/schedules) *** ### Legal Notice This actor is designed for legitimate data collection purposes. Users are responsible for ensuring compliance with s1jobs.com terms of service and applicable data protection laws. Use collected data responsibly and respect the platform's usage policies. # Actor input Schema ## `startUrl` (type: `string`): Start scraping from a specific s1jobs.com search URL (e.g. https://www.s1jobs.com/jobs/glasgow/). If provided, this will be used instead of Keyword/Location. ## `keyword` (type: `string`): Job search keyword(s), e.g., 'developer', 'nurse', 'manager'. ## `location` (type: `string`): Location (e.g., 'Glasgow', 'Edinburgh', 'Scotland'). ## `results_wanted` (type: `integer`): The maximum number of jobs to collect. Set to 20 for QA speed. ## `max_pages` (type: `integer`): A safety cap on the number of search result pages to visit. ## `proxyConfiguration` (type: `object`): Use Apify Proxy for reliable scraping. ## Actor input object example ```json { "keyword": "developer", "location": "Glasgow", "results_wanted": 20, "max_pages": 5, "proxyConfiguration": { "useApifyProxy": false } } ``` # 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 = { "keyword": "developer", "location": "Glasgow", "results_wanted": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("shahidirfan/s1jobs-com-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": "developer", "location": "Glasgow", "results_wanted": 20, } # Run the Actor and wait for it to finish run = client.actor("shahidirfan/s1jobs-com-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": "developer", "location": "Glasgow", "results_wanted": 20 }' | apify call shahidirfan/s1jobs-com-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=shahidirfan/s1jobs-com-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "S1jobs.com Scraper", "description": "Extract live job postings from S1jobs instantly. Get job titles, companies, salaries, descriptions & contact details. Perfect for recruitment automation, job market monitoring, salary benchmarking & building AI training datasets. Structured, scalable output.", "version": "0.0", "x-build-id": "QaOwWHzOKNXQVGDwG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~s1jobs-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-s1jobs-com-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/shahidirfan~s1jobs-com-scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-s1jobs-com-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/shahidirfan~s1jobs-com-scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-s1jobs-com-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": { "startUrl": { "title": "Start URL", "type": "string", "description": "Start scraping from a specific s1jobs.com search URL (e.g. https://www.s1jobs.com/jobs/glasgow/). If provided, this will be used instead of Keyword/Location." }, "keyword": { "title": "Keyword (if not using Start URL)", "type": "string", "description": "Job search keyword(s), e.g., 'developer', 'nurse', 'manager'." }, "location": { "title": "Location (if not using Start URL)", "type": "string", "description": "Location (e.g., 'Glasgow', 'Edinburgh', 'Scotland')." }, "results_wanted": { "title": "Maximum number of jobs", "minimum": 1, "type": "integer", "description": "The maximum number of jobs to collect. Set to 20 for QA speed.", "default": 20 }, "max_pages": { "title": "Maximum number of pages", "minimum": 1, "type": "integer", "description": "A safety cap on the number of search result pages to visit.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use Apify Proxy for reliable scraping.", "default": { "useApifyProxy": 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 } } } } } } } } } } ```