{ "openapi": "3.0.1", "info": { "title": "ConstructionJobs.com Scraper — Full Board", "description": "Scrape all 2,800+ jobs on ConstructionJobs.com, not the 714 the paged listing exposes. Salary, benefits, trade category and employer profile links. HTTP-only, no browser.", "version": "1.0", "x-build-id": "Rfi1agZzwe0Mrlisp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piquno~constructionjobs-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piquno-constructionjobs-com-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/piquno~constructionjobs-com-scraper/runs": { "post": { "operationId": "runs-sync-piquno-constructionjobs-com-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/piquno~constructionjobs-com-scraper/run-sync": { "post": { "operationId": "run-sync-piquno-constructionjobs-com-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": { "seedMode": { "title": "What to crawl", "enum": [ "sitemap", "recent" ], "type": "string", "description": "Full board reads the sitemap and reaches all 2,800+ live jobs. Recent only walks the paged listing, which the site caps at 34 pages (~714 jobs) — faster, but it cannot see the rest of the board.", "default": "sitemap" }, "maxJobs": { "title": "Max jobs", "minimum": 1, "type": "integer", "description": "Hard limit. Each job is one request, so this is also your request count — roughly one and a half jobs per second. The default of 50 is a quick sample; raise it for a full extract of the 2,800+ board.", "default": 50 }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional. Specific ConstructionJobs.com job URLs to scrape. Overrides the crawl mode.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "incremental": { "title": "Incremental mode (only new jobs)", "type": "boolean", "description": "Remember job URLs between runs and emit only postings not seen before. Pair with Recent only for a cheap daily watch.", "default": false }, "stateKey": { "title": "State key", "type": "string", "description": "Namespace for incremental state. Use a different key per schedule.", "default": "default" }, "titleContains": { "title": "Title contains", "type": "string", "description": "Keep only jobs whose title contains this text, e.g. \"superintendent\" or \"electrician\"." }, "locationState": { "title": "State", "type": "string", "description": "Keep only jobs in this US state, spelled as the site does, e.g. \"California\", \"Texas\"." }, "employmentType": { "title": "Employment type", "type": "string", "description": "Keep only jobs of this type, e.g. FULL_TIME, PART_TIME, CONTRACTOR." }, "withSalaryOnly": { "title": "Only jobs with a disclosed salary", "type": "boolean", "description": "Most construction postings withhold pay, so expect this to reduce the count substantially.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is enabled by default. The site serves plain HTTP fine, but the datacenter pool is more reliable than the bare container egress and is included on every plan.", "default": { "useApifyProxy": 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 } } } } } } } } } }