{ "openapi": "3.0.1", "info": { "title": "The Hub Jobs Scraper", "description": "[💰 $3 / 1K] Extract startup job listings from thehub.io, the Nordic startup jobs board. Search by keyword, filter by region or position type, or paste job and search URLs. Returns title, company profile, location, role labels, remote flag, view counts, and the apply link or email per job.", "version": "1.0", "x-build-id": "Wwqc9v2mqfJ6AOTc4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~thehub-io-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-thehub-io-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/solidcode~thehub-io-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-thehub-io-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/solidcode~thehub-io-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-thehub-io-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": { "searchQuery": { "title": "Search Keyword", "type": "string", "description": "Job title, role, or skill to search for (e.g. 'software engineer', 'product manager', 'growth marketing'). The Hub matches your words anywhere in the posting, including the description, so results are a generous superset — filter the output on the Role field for precision. Leave blank to collect all jobs matching the filters below." }, "regions": { "title": "Regions", "uniqueItems": true, "type": "array", "description": "Only include jobs in these regions. Leave empty to include every region. This is the only place-based filter The Hub's job search supports.", "items": { "type": "string", "enum": [ "DK", "SE", "NO", "FI", "IS", "EU", "REMOTE" ], "enumTitles": [ "Denmark", "Sweden", "Norway", "Finland", "Iceland", "Europe (other)", "Remote" ] }, "default": [] }, "jobPositionTypes": { "title": "Position Types", "uniqueItems": true, "type": "array", "description": "Only include jobs of these employment types. Leave empty to include all types.", "items": { "type": "string", "enum": [ "Full-time", "Part-time", "Internship", "Freelance", "Cofounder", "Student", "Advisory board" ], "enumTitles": [ "Full-time", "Part-time", "Internship", "Freelance", "Cofounder", "Student", "Advisory board" ] }, "default": [] }, "remoteOnly": { "title": "Remote jobs only", "type": "boolean", "description": "Turn on to return only jobs that allow remote work.", "default": false }, "searchUrls": { "title": "Search URLs", "type": "array", "description": "Paste thehub.io search or category URLs directly from your browser (e.g. https://thehub.io/jobs?search=engineer&location=DK). Use this when you've already built filters in the site's UI. When provided, the keyword and filters above are ignored. Note on places: a city or country NAME in the link (for example ?location=Copenhagen) is not something The Hub's job search narrows by, so the export covers the regions instead of that one place — use the Regions filter above to target a place. If a URL has no recognizable filters (for example a typo'd link), the run falls back to a broad scan rather than failing.", "items": { "type": "string" } }, "jobUrls": { "title": "Job URLs", "type": "array", "description": "Paste one or more individual job URLs to scrape just those listings (e.g. https://thehub.io/jobs/). If both Job URLs and Search URLs (or the keyword filters above) are set, Job URLs take precedence and only these postings are scraped.", "items": { "type": "string" } }, "maxResults": { "title": "Maximum Results", "minimum": 0, "type": "integer", "description": "Hard cap on total job rows returned across all sources. Default 100 — increase for bigger runs, or set to 0 for no cap (an internal upper bound still applies to prevent runaway pagination). Collection stops requesting new pages once this number is hit but keeps the full last page even if it slightly overshoots. When several regions are selected they are searched in the order listed above, so a cap smaller than their combined pool fills from the earlier regions first — the run says so when that happens.", "default": 100 } } }, "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 } } } } } } } } } }