{
  "openapi": "3.0.1",
  "info": {
    "title": "StepStone Group Jobs API [$1.5💰] — Totaljobs, CWJobs +12",
    "description": "One run, the whole StepStone Group: Totaljobs, CWJobs, Jobsite, Caterer, IrishJobs, Milkround, PNet + StepStone DE/AT/BE/NL. Unified JSON with a per-brand column — title, salary, employer, location, apply URL. Pure HTTP API, no browser. From $1.50/1,000 jobs.",
    "version": "0.0",
    "x-build-id": "ej84gamOHG6wNmEzv"
  },
  "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"
            }
          },
          "includeKeywords": {
            "title": "✅ Include keywords",
            "type": "array",
            "description": "Only keep jobs whose title, company or description contains at least one of these (case-insensitive). Filtered rows are never charged.",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "🚫 Exclude keywords",
            "type": "array",
            "description": "Drop jobs whose title, company or description contains any of these (case-insensitive).",
            "items": {
              "type": "string"
            }
          },
          "fromDate": {
            "title": "📅 Posted from",
            "type": "string",
            "description": "Only keep jobs posted on or after this date (ISO 8601, e.g. 2026-08-01)."
          },
          "toDate": {
            "title": "📅 Posted to",
            "type": "string",
            "description": "Only keep jobs posted on or before this date (ISO 8601). A date-only value means through the end of that day."
          },
          "maxAgeMinutes": {
            "title": "⏱️ Max age (minutes)",
            "minimum": 0,
            "type": "integer",
            "description": "Only keep jobs posted within the last N minutes. Empty or 0 = no age limit. Ideal for tight scheduled runs."
          },
          "incrementalMode": {
            "title": "♻️ Incremental mode",
            "type": "boolean",
            "description": "Compare against the previous run and only emit jobs that are NEW, UPDATED, or REAPPEARED — you are only charged for what changed. The first run seeds the baseline. Each emitted row carries `changeType` and `firstSeenAt`.",
            "default": false
          },
          "stateKey": {
            "title": "🔑 State key",
            "type": "string",
            "description": "Optional stable name for this tracked search (e.g. \"nurse-toronto\"). Leave empty to auto-derive one from the search inputs — same inputs, same baseline."
          },
          "emitUnchanged": {
            "title": "♻️ Emit unchanged records",
            "type": "boolean",
            "description": "When incremental, also emit rows whose content did not change (charged as normal results).",
            "default": false
          },
          "emitExpired": {
            "title": "⚰️ Emit expired records",
            "type": "boolean",
            "description": "When incremental, emit a small `changeType: EXPIRED` row for every previously-tracked job that vanished from the source.",
            "default": false
          },
          "skipReposts": {
            "title": "🚫 Skip reposts",
            "type": "boolean",
            "description": "When incremental, skip jobs whose content matches a previously-expired posting (employer re-listed the same ad under a new id).",
            "default": false
          },
          "resetIncrementalState": {
            "title": "🧨 Reset incremental state",
            "type": "boolean",
            "description": "One-shot: drop the stored baseline for this state key at the start of the run.",
            "default": false
          },
          "compact": {
            "title": "📦 Compact output",
            "type": "boolean",
            "description": "Emit only the core fields — small payloads for AI-agent / MCP / LLM pipelines.",
            "default": false
          },
          "excludeEmptyFields": {
            "title": "🧹 Exclude empty fields",
            "type": "boolean",
            "description": "Drop null / empty-string / empty-array fields from each record.",
            "default": false
          },
          "descriptionMaxLength": {
            "title": "✂️ Description max length",
            "minimum": 0,
            "type": "integer",
            "description": "Truncate description fields to this many characters (0 = full text). Controls LLM prompt cost and dataset size."
          },
          "telegramBotToken": {
            "title": "🔔 Telegram bot token",
            "type": "string",
            "description": "Your bot's token from @BotFather. With Chat ID set, a summary of new jobs is sent after each run."
          },
          "telegramChatId": {
            "title": "🔔 Telegram chat ID",
            "type": "string",
            "description": "Chat or channel id the bot posts to (e.g. \"-1001234567890\")."
          },
          "slackWebhookUrl": {
            "title": "💼 Slack webhook URL",
            "type": "string",
            "description": "Slack incoming-webhook URL (api.slack.com/messaging/webhooks)."
          },
          "discordWebhookUrl": {
            "title": "🎮 Discord webhook URL",
            "type": "string",
            "description": "Discord incoming-webhook URL (Server Settings → Integrations → Webhooks)."
          },
          "whatsappAccessToken": {
            "title": "📱 WhatsApp access token",
            "type": "string",
            "description": "WhatsApp Cloud API token (Meta Business system user). The recipient must have messaged your business number within the last 24h — Cloud API rule."
          },
          "whatsappPhoneNumberId": {
            "title": "📱 WhatsApp phone-number ID",
            "type": "string",
            "description": "Your WhatsApp Business phone-number id (numeric, from the Meta dashboard)."
          },
          "whatsappTo": {
            "title": "📱 WhatsApp recipient",
            "type": "string",
            "description": "Recipient phone in E.164 without + (e.g. \"14165551234\")."
          },
          "webhookUrl": {
            "title": "🪝 Generic webhook URL",
            "type": "string",
            "description": "Receives one JSON POST with { metadata, items } after the run — the universal escape hatch for n8n / Make / Zapier / custom backends."
          },
          "webhookHeaders": {
            "title": "🪝 Webhook headers",
            "type": "object",
            "description": "Optional custom headers for the generic webhook (e.g. {\"Authorization\": \"Bearer …\"})."
          },
          "notificationLimit": {
            "title": "🔔 Max jobs per notification",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many job lines each chat notification includes (1–20). The rest are summarised as a count.",
            "default": 5
          },
          "notifyOnlyChanges": {
            "title": "🔔 Notify only new/updated",
            "type": "boolean",
            "description": "With Incremental mode on, notify only about NEW / UPDATED / REAPPEARED jobs.",
            "default": false
          },
          "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}