{ "openapi": "3.0.1", "info": { "title": "Monster Job Scraper | US Salary & Remote", "description": "Scrape monster.com - one of the largest U.S. job boards with 1M+ listings. Structured salary data, remote work detection, and job change monitoring. Incremental mode detects new and changed listings.", "version": "0.1", "x-build-id": "DWKH3zbVXDRXrBTu1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/blackfalcondata~monster-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-blackfalcondata-monster-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/blackfalcondata~monster-scraper/runs": { "post": { "operationId": "runs-sync-blackfalcondata-monster-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/blackfalcondata~monster-scraper/run-sync": { "post": { "operationId": "run-sync-blackfalcondata-monster-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": { "query": { "title": "๐Ÿ” Search Term(s)", "type": "string", "description": "Job search keywords. Leave blank if using Start URLs instead." }, "startUrls": { "title": "๐Ÿ”— Start URLs", "type": "array", "description": "Paste Monster.com search or job-detail URLs directly. Works alongside or instead of Search Term(s). Compatible with Incremental Mode โ€” stateKey tracks the combined universe regardless of input type.", "items": { "type": "string" } }, "country": { "title": "๐ŸŒ Country", "enum": [ "US", "GB", "DE", "CA", "FR", "AT", "NL", "BE", "IE", "SE", "ES", "IT", "CH", "LU" ], "type": "string", "description": "Which market to search.", "default": "US" }, "location": { "title": "๐Ÿ“ Location", "type": "string", "description": "City, state, or region." }, "radius": { "title": "๐Ÿ“ก Search Radius (miles)", "minimum": 1, "maximum": 100, "type": "integer", "description": "Search radius around location in miles.", "default": 30 }, "companyName": { "title": "๐Ÿข Company Name", "type": "string", "description": "Filter to jobs at a specific employer. Matches against the company name in the Monster URL slug." }, "employmentType": { "title": "๐Ÿ’ผ Employment Type", "enum": [ "FULL_TIME", "PART_TIME", "CONTRACT", "INTERN", "TEMP", "REMOTE" ], "type": "string", "description": "Filter by employment type." }, "datePosted": { "title": "Date Posted", "enum": [ "TODAY", "LAST_2_DAYS", "LAST_WEEK", "LAST_2_WEEKS", "LAST_MONTH" ], "type": "string", "description": "Filter by how recently jobs were posted." }, "maxResults": { "title": "๐Ÿ’ฏ Max Results", "minimum": 0, "maximum": 1500, "type": "integer", "description": "Maximum total results. Up to 1,500 per run. 0 = unlimited.", "default": 25 }, "maxConcurrency": { "title": "โš™๏ธ Max Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Parallel detail fetches through scrape.do. Higher = faster but burns credits in parallel. Default tuned from benchmark.", "default": 5 }, "maxRequestRetries": { "title": "๐Ÿ” Max Request Retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "Retries per detail request on transient errors (5xx, network).", "default": 2 }, "includeDetails": { "title": "๐Ÿ“‹ Include Full Details", "type": "boolean", "description": "Fetch full job details.", "default": true }, "descriptionMaxLength": { "title": "โœ‚๏ธ Description Max Length", "minimum": 0, "type": "integer", "description": "Truncate description to N chars. 0 = no truncation.", "default": 0 }, "compact": { "title": "๐Ÿ“ฆ Compact Output", "type": "boolean", "description": "Core fields only (for AI-agent/MCP workflows).", "default": false }, "incrementalMode": { "title": "โ™ป๏ธ Incremental Mode", "type": "boolean", "description": "Compare against previous run state.", "default": false }, "stateKey": { "title": "๐Ÿ”‘ State Key", "type": "string", "description": "Stable identifier for tracked universe." }, "skipReposts": { "title": "๐Ÿšซ Skip Reposts", "type": "boolean", "description": "Exclude listings detected as reposts of previously seen jobs.", "default": false }, "purgeCacheOnStart": { "title": "๐Ÿงน Purge Stale Cache", "type": "boolean", "description": "Sweep the cross-run detail cache and delete entries older than the TTL (180 days since last sitemap touch). Run periodically (e.g. monthly via Apify Schedule) to keep cache storage bounded.", "default": false }, "proxyConfiguration": { "title": "๐Ÿ›ก๏ธ Proxy Configuration", "type": "object", "description": "Optional proxy configuration." }, "telegramToken": { "title": "๐Ÿ“ฑ Telegram Bot Token", "type": "string", "description": "Telegram bot token from @BotFather. Pairs with Telegram Chat ID. Pair with Incremental Mode for real-time alerts on new/updated jobs only." }, "telegramChatId": { "title": "๐Ÿ’ฌ Telegram Chat / Channel ID", "type": "string", "description": "Chat ID (from @userinfobot) or channel ID (starts with -100 for channels). Required when Telegram Bot Token is set." }, "slackWebhookUrl": { "title": "๐Ÿ’ผ Slack Incoming Webhook URL", "type": "string", "description": "Slack incoming webhook URL (Slack App โ†’ Incoming Webhooks โ†’ Add New Webhook). Formats jobs as Slack blocks." }, "discordWebhookUrl": { "title": "๐ŸŽฎ Discord Webhook URL", "type": "string", "description": "Discord channel webhook URL (Server Settings โ†’ Integrations โ†’ Webhooks โ†’ New Webhook). Sends rich embeds colour-coded by change type (green=NEW, amber=UPDATED)." }, "whatsappAccessToken": { "title": "๐Ÿ“ฒ WhatsApp Access Token", "type": "string", "description": "WhatsApp Cloud API permanent System User token from Meta Business. Pairs with WhatsApp Phone Number ID and recipient phone." }, "whatsappPhoneNumberId": { "title": "๐Ÿ“ž WhatsApp Phone Number ID", "type": "string", "description": "Numeric WhatsApp Business phone-number ID from Meta dashboard." }, "whatsappTo": { "title": "๐Ÿ“จ WhatsApp Recipient (E.164)", "type": "string", "description": "Recipient phone in E.164 format (e.g. \"15551234567\"). Recipient must have messaged the business number within the last 24h, otherwise Meta rejects free-form text." }, "webhookUrl": { "title": "๐Ÿ”— Generic Webhook URL", "type": "string", "description": "POSTs a JSON payload `{metadata, items}` to your endpoint. Universal hook for n8n / Make / Zapier / custom backends." }, "webhookHeaders": { "title": "๐Ÿ“‘ Webhook Headers (JSON)", "type": "object", "description": "Optional headers (e.g. `{\"Authorization\": \"Bearer ...\"}`) sent with the webhook POST." }, "notificationLimit": { "title": "๐Ÿ”ข Notification Limit", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of jobs included per notification batch (1โ€“20). Prevents spam on large result sets.", "default": 5 }, "notifyOnlyChanges": { "title": "๐Ÿ†• Notify Only on Changes", "type": "boolean", "description": "When ON together with Incremental Mode, send notifications only for NEW and UPDATED jobs. Has no effect outside incremental mode.", "default": false }, "includeRunMetadata": { "title": "๐Ÿ“ฃ Include Run Summary in Notifications", "type": "boolean", "description": "Prepend a one-line summary (search label + total count) to each notification batch.", "default": true } } }, "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 } } } } } } } } } }