{ "openapi": "3.0.1", "info": { "title": "Jobware Scraper", "description": "[💰 $3.00 / 1K] Extract job listings from Jobware.de, a leading German job board for specialist roles. Search by keyword, location, and employment type to get titles, companies, salaries, descriptions, recruiter contacts, and apply links.", "version": "1.0", "x-build-id": "zVdS6tj0gLON48ELJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~jobware-de-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-jobware-de-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/solidcode~jobware-de-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-jobware-de-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/solidcode~jobware-de-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-jobware-de-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": { "searchQueries": { "title": "Search Keywords", "maxItems": 50, "type": "array", "description": "Job titles or keywords to search for on Jobware, such as 'Softwareentwickler', 'Projektmanager', or 'Pflegefachkraft'. Each keyword runs a separate search and the results are merged and de-duplicated. Up to 50 keywords per run. Leave empty if you only want to use direct URLs below.", "items": { "type": "string" } }, "startUrls": { "title": "Direct Jobware URLs", "maxItems": 100, "type": "array", "description": "Paste links straight from Jobware.de. A job link (for example https://www.jobware.de/job/sales-manager-m-w-d-064064750) returns that one job, so you can copy any Job URL from your results back in here to re-fetch it. A search link (for example https://www.jobware.de/jobs--fuer-softwareentwickler--in-berlin) is scraped with its filters exactly as-is, and every matching listing is resolved in one pass. Links that are neither are skipped and named in the run status rather than turned into an unrelated search. Up to 100 URLs per run.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "location": { "title": "Location", "type": "string", "description": "A German city or region, such as 'Berlin', 'München', 'Hamburg', or 'Nordrhein-Westfalen'. Matched to the nearest Jobware area. Leave empty to search all of Germany." }, "employmentType": { "title": "Employment Type", "enum": [ "", "vollzeit", "teilzeit", "werkstudent", "praktikum", "freelance", "homeoffice" ], "type": "string", "description": "Filter by the type of employment. Leave on 'Any' for all types.", "default": "" }, "datePosted": { "title": "Posted Within", "enum": [ "", "1", "3", "7", "14", "30" ], "type": "string", "description": "Only show jobs published within this time period. Leave on 'Any time' for all listings.", "default": "" }, "sortBy": { "title": "Sort Results By", "enum": [ "relevance", "date" ], "type": "string", "description": "Order the results by relevance to your keyword or by how recently the job was posted.", "default": "relevance" }, "maxResults": { "title": "Max Results per Search", "minimum": 1, "maximum": 2248, "type": "integer", "description": "Maximum number of jobs to collect per search keyword. Use 50 for a quick scan or a higher number for deep research. Note: Jobware returns at most about 2,200 jobs for any single keyword search, so values above that will simply return everything available for that keyword.", "default": 50 }, "includeJobDetails": { "title": "Fetch Full Job Details", "type": "boolean", "description": "Fetch the full description, salary, deadline, and recruiter contact details from each job's detail page. Leave on for the richest data. Turn off for faster, lighter scans — the description, salary, and contact fields will then be empty.", "default": true }, "descriptionFormat": { "title": "Description Format", "enum": [ "text", "html", "both" ], "type": "string", "description": "How to return the job description. 'Text' gives clean plain text, 'HTML' preserves formatting, 'Both' includes each in its own field.", "default": "text" } } }, "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 } } } } } } } } } }