{ "openapi": "3.0.1", "info": { "title": "Platsbanken Scraper: Sweden Jobs & Hiring Companies", "description": "Swedish job ads from Platsbanken (Arbetsförmedlingen), via the open JobTech API, CC0: about 40,000 live ads. Filter by keyword, occupation, county, employer, remote. No 2,000 limit. Hiring-companies mode: one row per employer. No repeats between runs. Contact persons, emails and phones removed.", "version": "0.1", "x-build-id": "8HVMVwaM6lv2Gw9eL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/responsible_front_evw~sweden-jobs-platsbanken/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-responsible_front_evw-sweden-jobs-platsbanken", "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/responsible_front_evw~sweden-jobs-platsbanken/runs": { "post": { "operationId": "runs-sync-responsible_front_evw-sweden-jobs-platsbanken", "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/responsible_front_evw~sweden-jobs-platsbanken/run-sync": { "post": { "operationId": "run-sync-responsible_front_evw-sweden-jobs-platsbanken", "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": { "query": { "title": "Search text", "type": "string", "description": "Optional words in the ad title, text or employer name, in Swedish or English, for example: utvecklare, sjuksköterska, lager, python. Supports \"phrases\" and wildcards (muse*)." }, "occupationFields": { "title": "Occupation fields", "type": "array", "description": "Codes: 1 Administration, finance, law · 2 Construction · 3 IT · 4 Personal and beauty care · 5 Sales, purchasing, marketing · 6 Crafts · 7 Hotel, restaurant, catering · 8 Health and medical care · 9 Manufacturing · 10 Installation, operation, maintenance · 11 Culture, media, design · 12 Cleaning · 13 Agriculture, forestry, animals · 14 Natural sciences · 15 Managers · 16 Social work · 17 Security · 18 Technical occupations · 19 Transport, warehouse · 22 Military. Taxonomy concept IDs also work.", "items": { "type": "string" } }, "regions": { "title": "Counties (län)", "type": "array", "description": "Two-digit county codes: 01 Stockholm, 03 Uppsala, 04 Södermanland, 05 Östergötland, 06 Jönköping, 07 Kronoberg, 08 Kalmar, 09 Gotland, 10 Blekinge, 12 Skåne, 13 Halland, 14 Västra Götaland, 17 Värmland, 18 Örebro, 19 Västmanland, 20 Dalarna, 21 Gävleborg, 22 Västernorrland, 23 Jämtland, 24 Västerbotten, 25 Norrbotten.", "items": { "type": "string" } }, "municipalities": { "title": "Municipalities (kommun)", "type": "array", "description": "Four-digit municipality codes, for example 0180 (Stockholm), 1480 (Göteborg), 1280 (Malmö), 0380 (Uppsala), 0580 (Linköping), 1281 (Lund), 2480 (Umeå).", "items": { "type": "string" } }, "occupationGroups": { "title": "Occupation groups (taxonomy IDs)", "type": "array", "description": "Optional, advanced: JobTech taxonomy concept IDs of occupation groups, for example DJh5_yyF_hEM (software and system developers). Find them at atlas.jobtechdev.se.", "items": { "type": "string" } }, "occupations": { "title": "Occupations (taxonomy IDs)", "type": "array", "description": "Optional, advanced: JobTech taxonomy concept IDs of occupation names, for example fg7B_yov_smw (software developer / programmer). Every result includes its occupationConceptId, so you can reuse them.", "items": { "type": "string" } }, "employerOrgNumbers": { "title": "Employer organisation numbers", "type": "array", "description": "Optional: only ads from these employers (10 digits, dashes allowed), for example 202100-5448.", "items": { "type": "string" } }, "remoteOnly": { "title": "Only remote-friendly jobs", "type": "boolean", "description": "Ads that are likely to allow remote work (detected by the official API from the ad text).", "default": false }, "noExperienceRequired": { "title": "Only jobs that require no experience", "type": "boolean", "description": "Only jobs that require no experience.", "default": false }, "publishedWithinDays": { "title": "Published in the last N days", "minimum": 1, "maximum": 365, "type": "integer", "description": "Optional. For example 1 for a daily feed, 7 for a weekly one." }, "outputMode": { "title": "Output", "enum": [ "ads", "employers" ], "type": "string", "description": "'Job ads': one row per ad. 'Hiring companies': one row per employer with open ads matching your filters (number of ads and vacancies, occupations, places, latest ad) for B2B prospecting. Sole traders are never listed as companies.", "default": "ads" }, "includeDescription": { "title": "Include the ad text", "type": "boolean", "description": "Full ad text, with emails, phone numbers, personal ID numbers and contact names removed. Turn off for smaller, faster exports.", "default": true }, "onlyNewSinceLastRun": { "title": "Only new since the last run (alerts)", "type": "boolean", "description": "Remembers the ads (or companies) already delivered for this same search and skips them, so you never pay twice. Use it with a schedule.", "default": false }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many ads (or companies). The official API stops at 2,000 per search; this Actor goes past it automatically by splitting by publication date.", "default": 100 }, "maxScannedAds": { "title": "Maximum ads scanned", "minimum": 100, "maximum": 100000, "type": "integer", "description": "Only used for 'Hiring companies' and alerts: how many ads to read to build the list. You only pay for the rows delivered.", "default": 2000 }, "requestDelaySecs": { "title": "Pause between requests (seconds)", "minimum": 1, "type": "integer", "description": "Minimum 1, to be gentle with the public API. Each request returns up to 100 ads.", "default": 2 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }