{ "openapi": "3.0.1", "info": { "title": "Hacker News Scraper: Search, Comments & Who Is Hiring Jobs", "description": "Search Hacker News stories and comments (any date range, points filter), get the front page, export full comment threads, or parse the monthly 'Who is hiring?' thread into structured job posts with company, role, location, remote, salary and emails. $1 per 1,000 items.", "version": "1.0", "x-build-id": "3Vbf6IajDaGZ5S5Kc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tali-works~hacker-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tali-works-hacker-news-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/tali-works~hacker-news-scraper/runs": { "post": { "operationId": "runs-sync-tali-works-hacker-news-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/tali-works~hacker-news-scraper/run-sync": { "post": { "operationId": "run-sync-tali-works-hacker-news-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords to search (Algolia HN search). Use an empty string to list everything in the date range.", "items": { "type": "string" } }, "itemTypes": { "title": "Item types", "type": "array", "description": "What to search. Default: stories.", "items": { "type": "string", "enum": [ "story", "comment", "ask_hn", "show_hn", "job", "poll" ], "enumTitles": [ "Stories", "Comments", "Ask HN", "Show HN", "Jobs", "Polls" ] } }, "sort": { "title": "Sort", "enum": [ "relevance", "date" ], "type": "string", "description": "Relevance search is capped at 1,000 results per query by HN's search; date sort can page through everything.", "default": "relevance" }, "from": { "title": "From", "type": "string", "description": "Only items created on or after this date." }, "to": { "title": "To", "type": "string", "description": "Only items created on or before this date." }, "minPoints": { "title": "Min points", "minimum": 0, "type": "integer", "description": "Search only: skip stories with fewer points (not billed). Not applied to comment threads, because HN doesn't expose comment points." }, "fuzzyMatch": { "title": "Fuzzy match (allow typos)", "type": "boolean", "description": "Off (default): keywords must match exactly, so 'shopify' won't also return 'Spotify'. Turn on for typo-tolerant search like hn.algolia.com.", "default": false }, "frontPage": { "title": "Front page", "type": "boolean", "description": "Also export the current HN front page.", "default": false }, "commentThreads": { "title": "Comment threads", "type": "array", "description": "HN item URLs or IDs; exports every comment (with depth and parent) of each thread.", "items": { "type": "string" } }, "whoIsHiring": { "title": "Monthly hiring thread", "enum": [ "off", "whoishiring", "whowantstobehired", "freelancer" ], "type": "string", "description": "Export the latest monthly thread. 'Who is hiring?' posts are parsed into company, roles, location, remote, salary, URLs and emails.", "default": "off" }, "hiringKeywords": { "title": "Hiring keywords", "type": "array", "description": "Hiring thread: keep posts mentioning any of these (e.g. python, rust, data).", "items": { "type": "string" } }, "hiringRemoteOnly": { "title": "Hiring: remote only", "type": "boolean", "description": "Hiring thread: keep only posts marked remote.", "default": false }, "maxItemsPerQuery": { "title": "Max items per query/thread", "minimum": 1, "type": "integer", "description": "Default 1,000." }, "maxTotalItems": { "title": "Max items in total", "minimum": 1, "type": "integer", "description": "Hard cap for the whole run, to control cost." } } }, "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 } } } } } } } } } }