# Salarship Jobs Scraper (`crawlerbros/salarship-scraper`) Actor Scrape Salarship.com - a global job board with salary estimates for 100,000+ positions. Search by keyword and location. Returns job title, company, location, estimated salary, job type, and a direct apply URL. - **URL**: https://apify.com/crawlerbros/salarship-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Jobs, Automation, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## Salarship Jobs Scraper Scrape [Salarship.com](https://www.salarship.com) — a global job board that aggregates job listings with salary estimates. Search by keyword and location, or browse by city. Returns job title, company, location, estimated salary, job type, and a direct apply URL. ### What this actor does - **Two modes:** `searchJobs` (keyword + location search) and `searchByLocation` (browse a city/country) - **Filters:** job type filter - **Salary estimates:** Salarship provides estimated salary data with every listing - **Pagination:** automatically paginates through multiple pages - **Empty fields are omitted** — every record field contains real data ### Output per job | Field | Description | |---|---| | `jobId` | Unique Salarship job ID | | `jobTitle` | Job title | | `companyName` | Hiring company name | | `location` | Job location (city, country) | | `estimatedSalary` | Estimated salary or salary range | | `jobType` | Employment type when available | | `jobUrl` | Direct link to the job apply page on Salarship | | `recordType` | Always `"job"` | | `scrapedAt` | UTC timestamp of when the record was scraped | ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | select | `searchJobs` | `searchJobs` — search by keyword; `searchByLocation` — browse by city/country | | `query` | string | `developer` | Job title or keyword (required for `searchJobs`) | | `location` | string | `London` | City or country to search in, e.g. `London`, `New York`, `Germany` | | `jobType` | select | Any | Filter by employment type | | `maxItems` | integer | `50` | Hard cap on emitted records (1–500) | #### Example: developer jobs in London ```json { "mode": "searchJobs", "query": "developer", "location": "London", "maxItems": 50 } ```` #### Example: data analyst jobs worldwide ```json { "mode": "searchJobs", "query": "data analyst", "maxItems": 100 } ``` #### Example: browse jobs in Berlin ```json { "mode": "searchByLocation", "location": "Berlin", "maxItems": 50 } ``` ### Use cases - **Salary benchmarking** — compare estimated salaries for the same role across different locations - **Job aggregators** — pull international job listings with salary data into your platform - **Compensation analysis** — analyse what companies pay for specific roles in specific markets - **Remote job search** — find jobs globally without geographic restrictions - **Career research** — understand market rates before negotiating your next offer ### FAQ **What is Salarship?** Salarship aggregates job listings from multiple sources and appends salary estimates to every posting. It covers roles across technology, healthcare, finance, and many other sectors globally. **Does every listing have a salary estimate?** Most listings include an estimated salary. When the salary data is not available, the `estimatedSalary` field is omitted. **What locations are supported?** Salarship covers jobs in major cities worldwide — London, New York, Berlin, Paris, Toronto, Sydney, Dubai, and many others. Leave `location` blank to search globally. **How fresh is the data?** The actor adds a `scrapedAt` timestamp for each run. Salarship updates its listings from upstream job sources regularly. **Are job type filters always accurate?** Job type is extracted from listing metadata when available. It may not be present for all listings. # Actor input Schema ## `mode` (type: `string`): What to fetch. ## `query` (type: `string`): Job title or keyword to search. E.g. 'developer', 'data analyst', 'nurse'. ## `location` (type: `string`): City or country to search in. E.g. 'London', 'New York', 'Germany'. Leave blank for worldwide. ## `jobType` (type: `string`): Filter by employment type. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## Actor input object example ```json { "mode": "searchJobs", "query": "developer", "location": "London", "jobType": "", "maxItems": 50 } ``` # Actor output Schema ## `jobs` (type: `string`): Dataset containing all scraped Salarship job listings. # 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 = { "mode": "searchJobs", "query": "developer", "location": "London", "maxItems": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/salarship-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 = { "mode": "searchJobs", "query": "developer", "location": "London", "maxItems": 50, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/salarship-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 '{ "mode": "searchJobs", "query": "developer", "location": "London", "maxItems": 50 }' | apify call crawlerbros/salarship-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/salarship-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Salarship Jobs Scraper", "description": "Scrape Salarship.com - a global job board with salary estimates for 100,000+ positions. Search by keyword and location. Returns job title, company, location, estimated salary, job type, and a direct apply URL.", "version": "1.0", "x-build-id": "uhmAxxCZ67wbSsc25" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~salarship-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-salarship-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/crawlerbros~salarship-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-salarship-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/crawlerbros~salarship-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-salarship-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "searchJobs", "searchByLocation" ], "type": "string", "description": "What to fetch.", "default": "searchJobs" }, "query": { "title": "Search query / keyword", "type": "string", "description": "Job title or keyword to search. E.g. 'developer', 'data analyst', 'nurse'.", "default": "developer" }, "location": { "title": "Location", "type": "string", "description": "City or country to search in. E.g. 'London', 'New York', 'Germany'. Leave blank for worldwide.", "default": "London" }, "jobType": { "title": "Job type filter", "enum": [ "", "full-time", "part-time", "contract", "internship", "temporary" ], "type": "string", "description": "Filter by employment type.", "default": "" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on emitted records.", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```