/` path. Examples: `glasgow`, `edinburgh`, `aberdeen`, `dundee`, `fife`, `highlands`, `orkney`. | `[]` |
| `maxItems` | integer | Maximum job rows to emit per search URL (1-10000). | `100` |
| `includeDescription` | boolean | Emit full HTML description. Set `false` for lean B2B lead rows (~1 KB instead of ~10 KB). | `true` |
| `dateWithinDays` | integer | Only emit jobs posted within the last N days. `0` = no filter. | `0` |
| `maxConcurrency` | integer | Parallel HTTP requests for detail pages (1-20). | `8` |
| `maxRequestRetries` | integer | Per-URL retry budget on transient errors and 5xx (0-10). | `3` |
| `proxyConfiguration` | object | S1 Jobs does not block datacenter IPs. Leave disabled for cheapest runs. | `{ "useApifyProxy": false }` |
#### Example input
```json
{
"keywords": ["electrician", "driver"],
"locations": ["glasgow", "edinburgh"],
"maxItems": 250,
"includeDescription": true,
"dateWithinDays": 30,
"maxConcurrency": 8
}
```
### 📦 Output
Each row is one job posting. Download the dataset in JSON, CSV, HTML, or Excel. The Actor also writes a `run-summary` to the key-value store with top employers, top locations, salary distribution, and contract type counts.
#### Example row
```json
{
"rowType": "job",
"listingUrl": "https://www.s1jobs.com/jobs/electrician/in-glasgow/",
"jobId": "126836433",
"jobUrl": "https://www.s1jobs.com/job/electrician-engineer-126836433",
"title": "Electrician Engineer",
"description": "Electrician Engineer
Contract: Government...",
"datePosted": "2026-05-13",
"validThrough": "2026-06-10",
"employmentType": "FULL_TIME, OTHER",
"industry": null,
"directApply": true,
"jobLocationType": null,
"employer": {
"name": "ISS Facility Services",
"url": "",
"logoUrl": "https://www.s1jobs.com//ui/img/shared/company_logos/1f50adaef0bda3b04b964a4d5df6c710.png"
},
"location": {
"text": "Hairmyres, South Lanarkshire, G758EA, UK",
"locality": "Hairmyres",
"region": "South Lanarkshire",
"postalCode": "G758EA",
"country": "UK",
"lat": 55.7581,
"lng": -4.23012
},
"salary": {
"rawText": null,
"min": null,
"max": null,
"currency": "GBP",
"period": "annum"
},
"scrapedAt": "2026-06-07T03:55:00.000Z"
}
```
### 📊 Data table
| Field | Type | Description |
| --- | --- | --- |
| `rowType` | string | Always `job` for job rows. |
| `listingUrl` | string | The search page the job was discovered on. |
| `jobId` | string | The 9-digit S1 Jobs vacancy ID, parsed from the URL. |
| `jobUrl` | string | Canonical URL of the job detail page. |
| `title` | string | Job title as listed. |
| `description` | string | Full HTML description (or empty if `includeDescription=false`). |
| `datePosted` | string | ISO date the job was posted. |
| `validThrough` | string | null | ISO date the listing closes. |
| `employmentType` | string | null | Comma-joined list (e.g. `FULL_TIME, OTHER`). |
| `industry` | string | null | Industry tag if provided. |
| `directApply` | boolean | null | Whether the job supports direct apply on s1jobs.com. |
| `jobLocationType` | string | null | `TELECOMMUTE` for remote roles. |
| `employer.name` | string | Hiring organization name. |
| `employer.url` | string | Hiring organization website if provided. |
| `employer.logoUrl` | string | null | URL of the employer logo image. |
| `location.text` | string | Joined `locality, region, postalCode, country`. |
| `location.locality` | string | null | City or town. |
| `location.region` | string | null | County or region. |
| `location.postalCode` | string | null | UK postcode. |
| `location.country` | string | Country code (always `UK` for S1 Jobs). |
| `location.lat` | number | null | Latitude. |
| `location.lng` | number | null | Longitude. |
| `salary.rawText` | string | null | Original visible salary string when JSON-LD omits min/max. |
| `salary.min` | number | null | Minimum salary. |
| `salary.max` | number | null | Maximum salary. |
| `salary.currency` | string | Currency code (always `GBP` for S1 Jobs). |
| `salary.period` | string | null | `annum`, `hour`, `day`, `week`, or `month`. |
| `scrapedAt` | string | ISO timestamp when the row was written to the dataset. |
### 💰 Pricing
$1.99 per 1,000 results. Pay only for the data you extract. A 5,000-row run costs about $9.95 of platform credit. Compute and storage costs are negligible because the Actor runs on lightweight HTTP, not a browser. No subscription, no minimums, no proxy overhead.
### ⭐ Enjoying S1 Jobs Scraper?
⭐ ⭐ ⭐ ⭐ ⭐
Skip hours of manual searching and get every live Scottish vacancy with salary and geo data in one run.
A 5-star rating takes 10 seconds and helps other recruiters and salary researchers find it. Your feedback also tells us what to build next.
|
|
★ Rate this Actor on Apify
|
### ✨ Tips or Advanced options
- **Use `startUrls` for precision.** If you only want jobs from a specific listing, paste the URL directly. Direct detail URLs always emit 1 row each.
- **Combine keywords and locations.** Every keyword is paired with every location, so `["electrician", "driver"]` x `["glasgow", "edinburgh"]` produces 4 search URLs.
- **Trim descriptions for B2B lead lists.** Set `includeDescription: false` to drop description HTML. Rows shrink from ~10 KB to ~1 KB, so a 10,000-row run costs 10x less to store.
- **Tighten freshness.** Set `dateWithinDays: 7` to only emit jobs posted in the last week. Great for daily job alerts.
- **Avoid burning rate limits.** S1 Jobs is open. Default `maxConcurrency: 8` is comfortable. If you observe 429s, drop to 4 or enable Apify Residential GB.
- **Use the B2B Leads view.** In the Output tab, switch to the `leads` view to see a clean table of title, employer, location, and apply URL ready for CRM import.
### ❓ FAQ, disclaimers, and support
**Is scraping S1 Jobs legal?** This Actor accesses publicly available job postings. You are responsible for ensuring your use case complies with s1jobs.com's Terms of Service, the UK Computer Misuse Act, and applicable data protection laws. Do not republish full descriptions verbatim. This Actor is intended for personal research, recruitment analytics, and CRM enrichment, not bulk redistribution.
**How fresh is the data?** The Actor fetches live pages in real time. Job postings appear in your dataset within seconds of the run completing.
**Why are some salaries missing?** S1 Jobs JSON-LD sometimes includes only `unitText` (e.g. `YEAR`) without numeric min/max values. The Actor captures the period but leaves min/max as `null`. Set `includeDescription: true` and parse the visible salary string in your downstream pipeline for a second pass.
**What's the difference between S1 Jobs Scraper and `cwjobs-scraper`?** CWJobs targets the UK tech / IT job market on cwjobs.co.uk. S1 Jobs targets general Scottish vacancies on s1jobs.com. They are sister Actors in the same portfolio and use the same JSON-LD extraction logic.
**How do I report a bug or request a feature?** Open an issue in the [Issues tab](https://console.apify.com/actors/~console/runs). Include the run ID and a sample URL that reproduces the problem.
Need a custom scraper for another regional job board or a vertical-specific extractor? Custom development is available on request.
### 🔗 Other actors
- [CWJobs Scraper](https://apify.com/getascraper/cwjobs-scraper) ↗ - extracts UK tech job listings, salaries, and geo data from CWJobs.
- [WTTJ Jobs Scraper](https://apify.com/getascraper/welcome-to-the-jungle-jobs-scraper) ↗ - pulls European job listings from Welcome to the Jungle as raw JSON or RAG-ready chunks.
- [HigherEdJobs Scraper](https://apify.com/getascraper/higheredjobs-com-scraper) ↗ - collects academic and university job listings from HigherEdJobs.
- [Goodmoves Jobs Scraper](https://apify.com/getascraper/goodmoves-jobs-scraper) ↗ - extracts Scottish charity and voluntary sector vacancies from Goodmoves.
# Actor input Schema
## `startUrls` (type: `array`):
Optional. Paste S1 Jobs listing URLs (e.g. https://www.s1jobs.com/jobs/electrician/in-glasgow/). If provided, takes precedence over search filters.
## `keywords` (type: `array`):
Job titles, sectors, or categories (e.g. electrician, nurse, accountant).
## `locations` (type: `array`):
Scottish cities or regions (e.g. glasgow, edinburgh, aberdeen). Leave empty for all Scotland.
## `includeDescription` (type: `boolean`):
If true (default), emit the full HTML job description.
## `dateWithinDays` (type: `integer`):
Only emit jobs whose posting date is within the last N days. 0 = no filter.
## `maxItems` (type: `integer`):
Maximum job rows to emit per search URL. Default 100.
## `maxConcurrency` (type: `integer`):
Parallel HTTP requests for detail-page fetches.
## `maxRequestRetries` (type: `integer`):
Per-URL retry budget on transient errors.
## `proxyConfiguration` (type: `object`):
Connection proxies to prevent website blocks.
## Actor input object example
```json
{
"startUrls": [],
"keywords": [
"electrician"
],
"locations": [
"glasgow"
],
"includeDescription": true,
"dateWithinDays": 0,
"maxItems": 100,
"maxConcurrency": 8,
"maxRequestRetries": 3,
"proxyConfiguration": {
"useApifyProxy": 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 = {
"startUrls": [],
"keywords": [
"electrician"
],
"locations": [
"glasgow"
],
"proxyConfiguration": {
"useApifyProxy": false
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("getascraper/s1jobs-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 = {
"startUrls": [],
"keywords": ["electrician"],
"locations": ["glasgow"],
"proxyConfiguration": { "useApifyProxy": False },
}
# Run the Actor and wait for it to finish
run = client.actor("getascraper/s1jobs-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"startUrls": [],
"keywords": [
"electrician"
],
"locations": [
"glasgow"
],
"proxyConfiguration": {
"useApifyProxy": false
}
}' |
apify call getascraper/s1jobs-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,getascraper/s1jobs-scraper"
}
}
}
```
The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).
## OpenAPI specification
Download the OpenAPI definition: https://api.apify.com/v2/actors/EF26XxJqZsBhZ8PkH/builds/MfdaqbavjbTiDXwyo/openapi.json
S1 Jobs
HIJOBS
CWJobs