{ "openapi": "3.0.1", "info": { "title": "Energy & Construction Jobs Scraper ยท 3 Boards", "description": "Energy jobs and construction jobs: postings from Energy Jobline (global), Energy Job Shop (US and Canada oil and gas) and ConstructionJobs (US) in one run, one schema, deduplicated across sources, no login.", "version": "0.1", "x-build-id": "eRFlyH9eEmM2u17ed" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bibian~energy-construction-finance-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bibian-energy-construction-finance-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/bibian~energy-construction-finance-jobs-scraper/runs": { "post": { "operationId": "runs-sync-bibian-energy-construction-finance-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/bibian~energy-construction-finance-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-bibian-energy-construction-finance-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": { "keywords": { "title": "Keywords", "type": "string", "description": "Job title or trade, for example \"project manager\" or \"instrumentation engineer\". Leave empty to get every posting." }, "location": { "title": "Location", "type": "string", "description": "City, region or country, for example \"Texas\" or \"Dubai\". Leave empty for all locations." }, "countries": { "title": "Countries", "type": "array", "description": "Keep only the sources covering these countries. \"Worldwide\" keeps Energy Jobline and Energy Job Shop regardless of the other countries chosen, since neither is tied to a single one.", "items": { "type": "string", "enum": [ "US", "GLOBAL" ], "enumTitles": [ "United States", "Worldwide (Energy Jobline, Energy Job Shop)" ] }, "default": [ "US", "GLOBAL" ] }, "sources": { "title": "Sources", "type": "array", "description": "Job boards to query in this run.", "items": { "type": "string", "enum": [ "energyjobline", "energyjobshop", "constructionjobs" ], "enumTitles": [ "Energy Jobline", "Energy Job Shop", "ConstructionJobs" ] }, "default": [ "energyjobline", "energyjobshop", "constructionjobs" ] }, "publishedWithinDays": { "title": "Published within (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Keep only postings published in the last N days. Use 1 for a daily monitoring run. Leave empty for no limit." }, "remote": { "title": "Remote work", "enum": [ "any", "remote", "hybrid", "onsite" ], "type": "string", "description": "Keep only postings with this remote policy.", "default": "any" }, "maxItems": { "title": "Maximum number of postings", "minimum": 1, "maximum": 5000, "type": "integer", "description": "The run stops once this many postings are saved, across all sources combined. Kept low by default: Energy Jobline's robots.txt imposes a 10-second delay between requests (politeness rule), which caps how many of its postings fit in one run.", "default": 20 }, "includeDescriptions": { "title": "Include full descriptions", "type": "boolean", "description": "Add the job description as plain text.", "default": true }, "onlyNew": { "title": "Only new results", "type": "boolean", "description": "For scheduled runs. Skip the results that an earlier run of this same search already delivered, so each run returns, and charges, only what is new. The memory is kept in a key-value store of your account named \"only-new-memory-bibian-\" followed by the ID of this Actor.", "default": false } } }, "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 } } } } } } } } } }