# JustJoin.it Scraper - Polish Tech Jobs (`studio-amba/justjoin-it-scraper`) Actor Scrape tech job offers from JustJoin.it, Poland's largest IT job board. Search by technology, city, remote and experience level. Extract titles, companies, salary ranges, tech stacks and full descriptions. No login or cookies required. - **URL**: https://apify.com/studio-amba/justjoin-it-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 result scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## JustJoin.it Scraper - Polish Tech Jobs Scrape tech job offers from [JustJoin.it](https://justjoin.it), Poland's largest IT job board, straight into JSON, CSV or Excel. Search by technology, keyword, city, remote policy and experience level. No login, no cookies, no browser needed. ### What does this actor do? JustJoin.it lists over 10,000 live tech job offers across Poland and remote-friendly positions across Europe. This actor collects those offers and returns clean, structured data: - Job title, company name and company details (size, website, logo) - Location (city, country) plus every office the offer is published for - Salary ranges as published (PLN, EUR, USD and more) with contract type, unit and gross/net flag - Full tech stack: required skills with proficiency levels, plus nice-to-have skills - Experience level, working time and remote/hybrid/office policy - Full job description as HTML - Published and expiry dates, direct offer URL ### Why use it? - **Salary transparency research** — JustJoin.it is known for publishing salary ranges on most offers. Track compensation by technology, seniority or city. - **Recruitment and sourcing** — monitor which companies are hiring for which stacks, at what levels, in which cities. - **Job market analytics** — build dashboards on demand for JavaScript vs Python vs DevOps roles in Poland. - **Lead generation** — companies actively hiring are companies actively spending. Company name, size and website are included. - **Job aggregation** — feed fresh Polish tech vacancies into your own job board or newsletter. ### How to scrape JustJoin.it data 1. Open the actor and set **Technology or Keyword**. Use one of JustJoin.it's own category slugs for exact filtering (`javascript`, `python`, `java`, `data`, `devops`, `testing`, `mobile`, `security`, `ai`, `net`, `php`, `ruby`, `scala`, `go`, `c`, `admin`, `ux`, `pm`, `game`, `analytics`, `support`, `erp`, `architecture`, `html`, `other`) or any free-text keyword like `react`, `kubernetes` or `golang`. 2. Optionally set a **City** (e.g. `Warszawa`, `Krakow`, `Wroclaw`, `Gdansk`), toggle **Remote only**, or pick an **Experience Level** (junior, mid, senior, C-level). 3. Set **Max Results** and run. Results land in the dataset, ready to export as JSON, CSV, Excel or via API. 4. Leave every field empty and the actor still works: it defaults to the `javascript` category and returns the newest offers. That's it. A run of 50 offers typically finishes in well under a minute. ### Input | Field | Type | Description | |-------|------|-------------| | `searchQuery` | string | Technology category slug or free-text keyword. Default: `javascript` | | `city` | string | Filter by city (e.g. `Warszawa`, `Krakow`). Optional. | | `remote` | boolean | Only fully remote offers. Default: `false` | | `experienceLevel` | string | `all`, `junior`, `mid`, `senior` or `c_level`. Default: `all` | | `maxResults` | integer | Maximum offers to scrape. Default: `50` | | `fetchDetails` | boolean | Fetch each offer's page for tech stack, description, company size and website. Default: `true` | | `proxyConfiguration` | object | Apify Proxy settings. Default: automatic proxy. | #### Example input ```json { "searchQuery": "python", "city": "Warszawa", "remote": false, "experienceLevel": "senior", "maxResults": 100 } ```` ### Output Each dataset item is one job offer: | Field | Type | Example | |-------|------|---------| | `jobTitle` | string | `Senior Frontend Developer` | | `company` | string | `Altarise sp. z o.o.` | | `location` | string | `Gliwice, Zygmunta Starego 1` | | `city` | string | `Gliwice` | | `countryCode` | string | `PL` | | `workplaceType` | string | `remote`, `hybrid` or `office` | | `remote` | boolean | `true` | | `experienceLevel` | string | `senior` | | `workingTime` | string | `full_time` | | `employmentType` | string | `b2b` | | `salaryMin` / `salaryMax` | number | `18000` / `24000` | | `salaryCurrency` | string | `pln` | | `salaryUnit` | string | `month` | | `salaryGross` | boolean | `false` | | `techStack` | array | `[{"name": "React", "level": 4}, {"name": "TypeScript", "level": 4}]` | | `niceToHaveSkills` | array | `[{"name": "Next.js", "level": 3}]` | | `categorySlug` | string | `javascript` | | `descriptionHtml` | string | Full job description as HTML | | `companySize` | string | `50-100` | | `companyUrl` | string | `https://example.com` | | `companyLogoUrl` | string | Logo thumbnail URL | | `languages` | array | `[{"code": "en", "level": "b2"}]` | | `multilocation` | array | `["Warszawa", "Krakow"]` | | `publishedDate` | string | `2026-07-09T20:00:08.111Z` | | `expiresAt` | string | `2026-09-30T21:59:59.999Z` | | `slug` | string | Offer identifier used in the URL | | `url` | string | `https://justjoin.it/job-offer/...` | | `scrapedAt` | string | ISO timestamp of the scrape | #### Example output ```json { "jobTitle": "Remote WordPress Developer", "company": "Coalition Technologies", "location": "Los Angeles, California", "city": "Los Angeles", "countryCode": "US", "workplaceType": "remote", "remote": true, "experienceLevel": "mid", "workingTime": "full_time", "employmentType": "permanent", "salaryMin": 17, "salaryMax": 35, "salaryCurrency": "usd", "salaryUnit": "hour", "salaryGross": true, "techStack": [ { "name": "SCSS", "level": 3 }, { "name": "PHP", "level": 3 }, { "name": "WordPress", "level": 3 }, { "name": "JavaScript", "level": 3 } ], "categorySlug": "javascript", "publishedDate": "2026-07-09T20:00:08.111Z", "url": "https://justjoin.it/job-offer/coalition-technologies-remote-wordpress-developer-los-angeles-javascript-29bcb61e", "scrapedAt": "2026-07-10T09:00:00.000Z" } ``` ### Cost estimate Pay-per-event pricing: a small fee per run start plus a fee per result. A typical 100-offer run costs a few cents. Compute usage is minimal since the actor talks to a JSON API instead of rendering pages in a browser. ### Tips - Category slugs (like `javascript` or `devops`) use JustJoin.it's native filter and are the most reliable way to segment the market. - Free-text keywords (like `react` or `aws`) match against titles and skills — great for niche stacks. - Set `fetchDetails` to `false` when you only need titles, companies, locations and salaries: the run gets faster and cheaper because the actor skips the per-offer detail fetch. - Combine `remote: true` with a keyword to track the remote-only market. - Offers are returned newest first, so a small daily run with your filter is enough to track new postings. ### Limitations - The tech stack and full description come from each offer's detail page; with `fetchDetails` disabled those fields are `null`. - Salary is only returned when the employer publishes it (most, but not all, offers include a range). - City filtering matches JustJoin.it's own location data; use the Polish city spelling shown on the site (e.g. `Warszawa`, not `Warsaw`). ### Legal This actor scrapes only publicly available job listings. It does not collect personal data and does not require login. Always review the target site's terms of service and applicable law before using scraped data commercially. # Actor input Schema ## `searchQuery` (type: `string`): Technology category (e.g. 'javascript', 'python', 'devops', 'testing', 'data', 'ai') or a free-text keyword (e.g. 'react', 'kubernetes'). Category slugs use JustJoin.it's own filter; anything else runs a keyword search. ## `city` (type: `string`): Filter by city (e.g. 'Warszawa', 'Krakow', 'Wroclaw', 'Gdansk'). Leave empty for all locations. ## `remote` (type: `boolean`): Only return offers marked as remote-friendly. ## `experienceLevel` (type: `string`): Filter by seniority. ## `maxResults` (type: `integer`): Maximum number of job offers to scrape. ## `fetchDetails` (type: `boolean`): Fetch each offer's page for tech stack (skill names + levels), full HTML description, company size and website. Disable for a faster, listing-only run. ## `proxyConfiguration` (type: `object`): Proxy settings. Apify Proxy (auto) works well; the site has no aggressive anti-bot. ## Actor input object example ```json { "searchQuery": "javascript", "remote": false, "experienceLevel": "all", "maxResults": 20, "fetchDetails": true, "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 = { "searchQuery": "javascript", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/justjoin-it-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 = { "searchQuery": "javascript", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/justjoin-it-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 '{ "searchQuery": "javascript", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call studio-amba/justjoin-it-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/justjoin-it-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "JustJoin.it Scraper - Polish Tech Jobs", "description": "Scrape tech job offers from JustJoin.it, Poland's largest IT job board. Search by technology, city, remote and experience level. Extract titles, companies, salary ranges, tech stacks and full descriptions. No login or cookies required.", "version": "0.1", "x-build-id": "B2WHgBeZCe2qghziT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~justjoin-it-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-justjoin-it-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/studio-amba~justjoin-it-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-justjoin-it-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/studio-amba~justjoin-it-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-justjoin-it-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": { "searchQuery": { "title": "Technology or Keyword", "type": "string", "description": "Technology category (e.g. 'javascript', 'python', 'devops', 'testing', 'data', 'ai') or a free-text keyword (e.g. 'react', 'kubernetes'). Category slugs use JustJoin.it's own filter; anything else runs a keyword search.", "default": "javascript" }, "city": { "title": "City", "type": "string", "description": "Filter by city (e.g. 'Warszawa', 'Krakow', 'Wroclaw', 'Gdansk'). Leave empty for all locations." }, "remote": { "title": "Remote only", "type": "boolean", "description": "Only return offers marked as remote-friendly.", "default": false }, "experienceLevel": { "title": "Experience Level", "enum": [ "all", "junior", "mid", "senior", "c_level" ], "type": "string", "description": "Filter by seniority.", "default": "all" }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of job offers to scrape.", "default": 50 }, "fetchDetails": { "title": "Fetch full details", "type": "boolean", "description": "Fetch each offer's page for tech stack (skill names + levels), full HTML description, company size and website. Disable for a faster, listing-only run.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Apify Proxy (auto) works well; the site has no aggressive anti-bot." } } }, "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 } } } } } } } } } } ```