{ "openapi": "3.0.1", "info": { "title": "StepStone Group Jobs Scraper — Totaljobs, IrishJobs & more", "description": "Scrape jobs across the whole StepStone Group in one run — Totaljobs, CWJobs, Jobsite, Caterer, IrishJobs, StepStone and sister brands — via the two shared StepStone Group backends. Unified JobPosting output with a per-brand column.", "version": "0.0", "x-build-id": "xZIQwaomJoQpBiIrC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~stepstone-group-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-stepstone-group-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/memo23~stepstone-group-scraper/runs": { "post": { "operationId": "runs-sync-memo23-stepstone-group-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/memo23~stepstone-group-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-stepstone-group-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": { "brands": { "title": "StepStone Group portals to scrape", "type": "array", "description": "Which Group portals to include. Each selected brand is searched with the keyword & location below. Leave empty if you're only pasting Start URLs.", "items": { "type": "string", "enum": [ "totaljobs", "cwjobs", "jobsite", "caterer", "irishjobs", "stepstone-de", "stepstone-at", "stepstone-be", "stepstone-nl", "pnet", "milkround", "retailchoice", "catererglobal", "careerstructure", "cityjobs" ], "enumTitles": [ "Totaljobs (UK)", "CWJobs (UK, tech)", "Jobsite (UK)", "Caterer.com (UK hospitality)", "IrishJobs (IE)", "StepStone (DE)", "StepStone (AT)", "StepStone (BE)", "StepStone (NL)", "PNet (South Africa)", "Milkround (UK graduate)", "RetailChoice (UK retail)", "CatererGlobal (hospitality, intl)", "CareerStructure (UK construction/eng)", "CityJobs (UK, professional)" ] } }, "searchKeyword": { "title": "Search keyword", "type": "string", "description": "Job title / keyword to search across every selected brand, e.g. `software engineer`, `nurse`, `chef`. Leave blank to browse everything in the location." }, "searchLocation": { "title": "Location", "type": "string", "description": "Town / city / region to search across every selected brand, e.g. `London`, `Dublin`, `Berlin`. Leave blank to search the whole country for each brand." }, "startUrls": { "title": "Start URLs (optional)", "type": "array", "description": "Raw listing URLs (e.g. `https://www.totaljobs.com/jobs/in-london`) or direct job-detail URLs from any supported brand. Auto-routed to the right backend by host; mixed brands in one run are fine. Overrides the keyword/location search for brands they belong to.", "items": { "type": "string" } }, "maxItems": { "title": "Max jobs per brand listing", "minimum": 1, "type": "integer", "description": "Maximum job rows per (brand × listing URL). 3 brands × maxItems 100 → up to 300 rows. Direct detail URLs always emit 1 row each. Free-tier users are capped at 100 rows total across the run.", "default": 100 }, "maxConcurrency": { "title": "Max parallel requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel HTTP requests for detail-page fetches. 3-5 is the sweet spot.", "default": 4 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "type": "integer", "description": "Per-URL retry budget on network errors, proxy failures, and transient blocks. Each retry rotates the proxy session. Default 6.", "default": 6 }, "proxy": { "title": "Proxy configuration (advanced override)", "type": "object", "description": "Optional override. By default each brand uses its proven proxy: Apify Residential GB for the Totaljobs-Group brands (their detail pages are Akamai-locked) and residential rotation for the StepStone unified-platform brands. Only set this if you know what you're doing." } } }, "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 } } } } } } } } } }