{ "openapi": "3.0.1", "info": { "title": "Hacker News Scraper — Stories & Comments by Keyword", "description": "Search Hacker News stories and comments by keyword: Show HN, Ask HN, polls and job posts too, with points, comment count, author, link and date. Filter by minimum points and time window, newest first or by relevance. No login. $0.10 per 1,000 items.", "version": "0.1", "x-build-id": "9OnPmuvG8Tb4upTct" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/actor-forge~hacker-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-actor-forge-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/actor-forge~hacker-news-scraper/runs": { "post": { "operationId": "runs-sync-actor-forge-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/actor-forge~hacker-news-scraper/run-sync": { "post": { "operationId": "run-sync-actor-forge-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", "required": [ "keywords" ], "properties": { "keywords": { "title": "Search queries", "type": "array", "description": "Words or phrases to search Hacker News for: a product, library, company, domain or topic, e.g. \"supabase\", \"rust async\" or \"stripe.com\". Titles, story text, URLs and comments are searched (Algolia HN Search).", "items": { "type": "string" } }, "hnTypes": { "title": "Item types", "type": "array", "description": "Which Hacker News items to return: stories, comments, Show HN, Ask HN, polls or job posts (any of them). Empty = stories, plus comments when \"Include comments\" is on.", "items": { "type": "string", "enum": [ "story", "comment", "show_hn", "ask_hn", "poll", "job" ], "enumTitles": [ "Stories", "Comments", "Show HN", "Ask HN", "Polls", "Job posts" ] }, "default": [] }, "includeComments": { "title": "Include comments", "type": "boolean", "description": "When no item types are picked: also return comments, not only stories.", "default": true }, "hnMinPoints": { "title": "Minimum points", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only items with at least this many points (upvotes). Comments have no public points, so setting this returns stories only." }, "hnSort": { "title": "Sort", "enum": [ "date", "relevance" ], "type": "string", "description": "Newest first, or Hacker News search relevance (best text matches and popular items first).", "default": "date" }, "sinceHours": { "title": "Look back (hours)", "minimum": 1, "maximum": 8760, "type": "integer", "description": "Only items created in the last N hours: 24 = one day, 168 = one week, 720 = 30 days, up to 8,760 (one year).", "default": 720 }, "maxPosts": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many items in total (shared fairly between queries). Each item is one charged row.", "default": 100 }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Drop items whose title or text contains any of these words or phrases (whole words, case-insensitive), e.g. \"hiring\".", "items": { "type": "string" } }, "newSinceLastRun": { "title": "Only new since last run (monitor mode)", "type": "boolean", "description": "For scheduled runs: skip items already delivered by an earlier run with the same queries and filters, so you only get (and pay for) new ones. Only hashed item IDs are kept.", "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 } } } } } } } } } }