{ "openapi": "3.0.1", "info": { "title": "Hacker News Scraper: Stories, Comments, Who Is Hiring", "description": "Scrape Hacker News stories, comments, users, front page, Ask HN, Show HN and monthly Who is hiring threads from the official Algolia and Firebase APIs. Points, comments, domains and dates. No login.", "version": "0.1", "x-build-id": "Aefesft1UphJ8d9iO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/transparent_meteorite~hacker-news-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-transparent_meteorite-hacker-news-search-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/transparent_meteorite~hacker-news-search-scraper/runs": { "post": { "operationId": "runs-sync-transparent_meteorite-hacker-news-search-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/transparent_meteorite~hacker-news-search-scraper/run-sync": { "post": { "operationId": "run-sync-transparent_meteorite-hacker-news-search-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": { "mode": { "title": "What to scrape", "enum": [ "search", "list", "storyComments", "user", "whoIsHiring" ], "type": "string", "description": "Search uses Search terms. List needs a list type. Story comments needs Story IDs. User needs Usernames. Who is hiring needs nothing.", "default": "search" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords or phrases, one search per term. Leave empty to browse everything of the chosen type. Used by Search.", "items": { "type": "string" } }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Total rows to return across all terms, ids or users. You are charged per row returned.", "default": 100 }, "contentType": { "title": "Content type", "enum": [ "story", "comment", "ask_hn", "show_hn", "front_page", "job", "poll" ], "type": "string", "description": "What to search. Used by Search.", "default": "story" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Relevance or newest first. Date order can page past 1,000 hits.", "default": "relevance" }, "minPoints": { "title": "Minimum points", "minimum": 0, "type": "integer", "description": "Skip stories below this score. Skipped rows are never charged." }, "minComments": { "title": "Minimum comments", "minimum": 0, "type": "integer", "description": "Skip stories with fewer comments." }, "since": { "title": "Posted since", "type": "string", "description": "Only items at or after this date, e.g. 2026-01-01 or 2026-01-01T12:00:00Z." }, "until": { "title": "Posted until", "type": "string", "description": "Only items before this date." }, "author": { "title": "Only from this user", "type": "string", "description": "Restrict a search to one Hacker News username, e.g. pg." }, "listType": { "title": "List", "enum": [ "top", "new", "best", "ask", "show", "job", "frontPage" ], "type": "string", "description": "Used by List mode.", "default": "top" }, "storyIds": { "title": "Story IDs or URLs", "type": "array", "description": "Story ids or news.ycombinator.com/item?id=... URLs. Used by Story comments.", "items": { "type": "string" } }, "includeStory": { "title": "Include the story row", "type": "boolean", "description": "Add the story itself as the first row.", "default": true }, "maxDepth": { "title": "Max comment depth", "minimum": 1, "type": "integer", "description": "1 = top-level comments only.", "default": 99 }, "usernames": { "title": "Usernames", "type": "array", "description": "Hacker News usernames, e.g. pg, dang. Used by User.", "items": { "type": "string" } }, "userContent": { "title": "User submissions", "enum": [ "profile", "stories", "comments", "all" ], "type": "string", "description": "What to return besides the profile row.", "default": "stories" }, "hiringKind": { "title": "Thread type", "enum": [ "hiring", "wantsHired", "freelancer" ], "type": "string", "description": "Used by Who is hiring.", "default": "hiring" }, "hiringMonth": { "title": "Month", "type": "string", "description": "latest, or a month such as 2026-10 or October 2026.", "default": "latest" }, "hiringKeywords": { "title": "Keywords", "type": "array", "description": "Keep only posts containing these words, e.g. rust, python.", "items": { "type": "string" } }, "keywordMatch": { "title": "Keyword match", "enum": [ "any", "all" ], "type": "string", "description": "Any keyword or all keywords.", "default": "any" }, "remoteOnly": { "title": "Remote only", "type": "boolean", "description": "Keep only posts that mention remote.", "default": false }, "includeChildIds": { "title": "Include child comment ids", "type": "boolean", "description": "Add the list of direct child ids to each row.", "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 } } } } } } } } } }