{ "openapi": "3.0.1", "info": { "title": "Hacker News Intel: Jobs, Show HN Launches & Keyword Monitor", "description": "Turn Hacker News into structured B2B data. Parse Who is hiring threads into clean job records (company, role, location, remote, salary, tech stack), track Show HN launches, or monitor any keyword. Official HN API, no proxy, no auth. Delta mode for recurring alerts.", "version": "1.0", "x-build-id": "g68hBnX1zSuvcizuP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/obsidian937~hacker-news-intel/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-obsidian937-hacker-news-intel", "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/obsidian937~hacker-news-intel/runs": { "post": { "operationId": "runs-sync-obsidian937-hacker-news-intel", "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/obsidian937~hacker-news-intel/run-sync": { "post": { "operationId": "run-sync-obsidian937-hacker-news-intel", "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": { "mode": { "title": "Mode", "enum": [ "whoishiring", "showhn", "keyword" ], "type": "string", "description": "What to extract: who-is-hiring jobs, Show HN launches, or a keyword monitor.", "default": "whoishiring" }, "postType": { "title": "Hiring thread type", "enum": [ "hiring", "wantToBeHired", "freelancer" ], "type": "string", "description": "Which recurring monthly thread to parse (whoishiring mode only).", "default": "hiring" }, "month": { "title": "Month", "type": "string", "description": "Target a specific monthly thread, e.g. \"June 2026\". Empty = latest (whoishiring mode).", "default": "" }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Keep only posts that mention remote work (whoishiring mode).", "default": false }, "keywordFilter": { "title": "Keyword filter", "type": "array", "description": "Keep only hiring posts mentioning at least one of these terms, e.g. [\"Rust\", \"Go\"] (whoishiring mode).", "default": [], "items": { "type": "string" } }, "searchQuery": { "title": "Search query", "type": "string", "description": "Text to match. Required for keyword mode; optional filter for Show HN.", "default": "" }, "includeComments": { "title": "Include comments", "type": "boolean", "description": "In keyword mode, also match comments (not just stories).", "default": false }, "minPoints": { "title": "Minimum points", "type": "integer", "description": "Only return items with at least this many points (showhn / keyword modes).", "default": 0 }, "deltaMode": { "title": "Delta / monitor mode", "type": "boolean", "description": "Only emit items new since the previous run (per-account state). Pair with a schedule + webhook for recurring alerts.", "default": false }, "maxItems": { "title": "Max items", "type": "integer", "description": "Cap on records to return. 0 = no cap (whoishiring is bounded by thread size).", "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 } } }, "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 } } } } } } } } } }