{ "openapi": "3.0.1", "info": { "title": "North America Jobs Scraper ยท USA & Canada, 6 Boards, One Schema", "description": "Extract job postings from 6 major US and Canadian job boards in one run: Job Bank (Canada), The Muse, Built In, Dice, Wellfound and Hacker News Who is Hiring. One unified schema, deduplicated across sources, no login.", "version": "0.1", "x-build-id": "i9x52Q75hv3DNXZ3Y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bibian~north-america-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bibian-north-america-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~north-america-jobs-scraper/runs": { "post": { "operationId": "runs-sync-bibian-north-america-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~north-america-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-bibian-north-america-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, skill or trade, for example \"backend engineer\" or \"warehouse associate\". Leave empty to get every posting." }, "location": { "title": "Location", "type": "string", "description": "City, province or state, used only by the sources that support it; ignored by the others." }, "remote": { "title": "Remote", "enum": [ "any", "remote", "hybrid", "onsite" ], "type": "string", "description": "Keep only postings matching this work mode (best effort, based on whatever the source itself publishes). \"Any\" keeps every posting.", "default": "any" }, "countries": { "title": "Countries", "type": "array", "description": "Keep only postings in these countries (best effort, based on whatever location the source itself publishes).", "items": { "type": "string", "enum": [ "US", "CA" ], "enumTitles": [ "United States", "Canada" ] }, "default": [ "US", "CA" ] }, "sources": { "title": "Sources", "type": "array", "description": "Job boards to query in this run.", "items": { "type": "string", "enum": [ "jobbank", "themuse", "builtin", "dice", "wellfound", "hackernews" ], "enumTitles": [ "Job Bank (Canada)", "The Muse", "Built In", "Dice", "Wellfound", "Hacker News (Who is Hiring)" ] }, "default": [ "jobbank", "themuse", "builtin", "dice", "wellfound", "hackernews" ] }, "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." }, "maxItems": { "title": "Maximum number of postings", "minimum": 1, "maximum": 20000, "type": "integer", "description": "The run stops once this many postings are saved, across all sources combined.", "default": 50 }, "includeDescriptions": { "title": "Include full descriptions", "type": "boolean", "description": "Add the job description as plain text. Off by default to keep the default run fast.", "default": false }, "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 } } } } } } } } } }