{ "openapi": "3.0.1", "info": { "title": "Jobware.de Scraper - German Professional Jobs", "description": "Find German job listings from Jobware.de for recruiting, sales leads and labour market research: scrape jobs with salary, contact person and apply email. No login needed, pay per result.", "version": "1.0", "x-build-id": "PDKkRoffLZXqW3Xbq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/santamaria-automations~jobware-de-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-santamaria-automations-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/santamaria-automations~jobware-de-scraper/runs": { "post": { "operationId": "runs-sync-santamaria-automations-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/santamaria-automations~jobware-de-scraper/run-sync": { "post": { "operationId": "run-sync-santamaria-automations-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": "Job titles or keywords", "type": "array", "description": "One or more job titles or keywords, for example \"Softwareentwickler\" or \"Pflegefachkraft\". Each keyword is searched on its own and duplicate jobs are removed. Leave empty to list all jobs.", "items": { "type": "string" } }, "searchQuery": { "title": "Job title or keyword (single)", "type": "string", "description": "One job title or keyword. Older single-keyword field; use the list above to search several keywords at once." }, "city": { "title": "City or region", "type": "string", "description": "City to search in, for example \"Berlin\", \"München\" or \"Hamburg\". Leave empty to search all of Germany." }, "radius": { "title": "Distance from the city (km)", "minimum": 0, "maximum": 200, "type": "integer", "description": "How far around the city to look, in kilometres. Only used when a city is set.", "default": 25 }, "employmentType": { "title": "Type of job", "enum": [ "", "vollzeit", "teilzeit", "werkstudent", "praktikum", "ausbildung" ], "type": "string", "description": "Only return jobs of one type, such as full-time, part-time, working student, internship or apprenticeship. Choose \"All Types\" for no filter.", "default": "" }, "sortBy": { "title": "Sort order", "enum": [ "", "date", "relevance" ], "type": "string", "description": "Order of the results: newest first or most relevant first. Newest first is sorted by the actor after collecting each keyword's results.", "default": "" }, "maxResultsPerQuery": { "title": "Max jobs per keyword", "minimum": 0, "type": "integer", "description": "Largest number of jobs to collect for each keyword. For example 100 with 3 keywords gives up to 300 jobs. Set 0 for no limit per keyword.", "default": 100 }, "maxResults": { "title": "Max jobs in total", "minimum": 0, "type": "integer", "description": "Largest number of jobs for the whole run, across all keywords. Set 0 for no overall limit.", "default": 0 }, "maxAgeHours": { "title": "Only jobs from the last N hours", "minimum": 1, "type": "integer", "description": "Only keep jobs posted within the last N hours. Useful for daily or weekly schedules so you only get new jobs. Older jobs, and jobs without a posting date, are dropped before they are saved and billed. Leave empty to turn off." }, "postedWithinDays": { "title": "Only jobs from the last N days", "minimum": 1, "type": "integer", "description": "Only keep jobs posted within the last N days. Same as the hours filter above, counted in days; if both are set the shorter window applies. Older jobs are dropped before they are saved and billed. Leave empty to turn off." }, "includeDetails": { "title": "Include full job details", "type": "boolean", "description": "On: open each job to get the full description, salary, contact person and apply email (slower). Off: only the basics from the search list (faster).", "default": true }, "directUrls": { "title": "Job page links", "type": "array", "description": "Links to specific Jobware.de job pages to scrape instead of searching, for example https://www.jobware.de/job/pflegefachkraft-m-w-d.1943234145.html", "items": { "type": "string", "pattern": "^https?://" } } } }, "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 } } } } } } } } } }