{ "openapi": "3.0.1", "info": { "title": "VAS Sheffield Jobs Scraper: Charity Vacancies & Monitor", "description": "Scrape voluntary-sector job vacancies from jobs.vas.org.uk with structured salary, location, employer, and closing-date fields pulled out of the listing text. Filter by sector or keyword and sort by date. Monitor mode flags new or changed listings for Apify schedules and integrations.", "version": "0.2", "x-build-id": "7k0sm9nN4nLgwRXRD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~vas-sheffield-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-vas-sheffield-jobs-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/getascraper~vas-sheffield-jobs-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-vas-sheffield-jobs-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/getascraper~vas-sheffield-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-vas-sheffield-jobs-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": { "baseUrl": { "title": "Job board URL", "type": "string", "description": "The WordPress job board to scrape. Leave as the default to scrape jobs.vas.org.uk, or point this at another WordPress site that uses the same vacancies post type.", "default": "https://jobs.vas.org.uk" }, "sectors": { "title": "Sectors", "type": "array", "description": "Only return vacancies in these sectors. Leave empty to return vacancies from every sector.", "items": { "type": "string", "enum": [ "Administration", "Animal", "Arts, Culture and Heritage", "Charity Support", "Community Development", "Disability", "Diversity and Inclusion", "Education", "Elderly", "Environment", "Faith-based", "Fundraising", "Health", "Housing and Homelessness", "HR", "Human Rights", "International Development", "Justice", "Managerial", "Membership Organisations", "Mental Health", "Other", "Research", "Social Care", "Social Welfare", "Sport", "Tech", "Transport", "Youth and Children", "Youth Work" ] }, "default": [] }, "searchQuery": { "title": "Search keyword", "type": "string", "description": "Only return vacancies whose title or description matches this keyword, for example a job title or skill.", "default": "" }, "postedWithinHours": { "title": "Posted within (hours)", "minimum": 1, "maximum": 8760, "type": "integer", "description": "Only return vacancies posted within this many hours. Leave blank to return all currently listed vacancies." }, "sortBy": { "title": "Sort by", "enum": [ "newest", "oldest" ], "type": "string", "description": "Order results by posting date.", "default": "newest" }, "enrichTaxonomies": { "title": "Include sector name, employer, and logo", "type": "boolean", "description": "Resolve the sector taxonomy name and employer logo via the site's own API instead of just a numeric sector ID. Adds two extra fields per request.", "default": false }, "maxItems": { "title": "Max vacancies", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of vacancies to return in this run.", "default": 20 }, "onlyNewOrChanged": { "title": "Incremental monitor mode", "type": "boolean", "description": "Only return vacancies that are new or have changed since your last run with the same monitor state name. Pair with an Apify schedule to get alerted on new listings.", "default": false }, "stateName": { "title": "Monitor state name", "type": "string", "description": "Name for this run's incremental state, used only when incremental monitor mode is on. Use different names to track separate configurations independently.", "default": "default" } } }, "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 } } } } } } } } } }