{ "openapi": "3.0.1", "info": { "title": "Hacker News Scraper - Posts, Points, Comment Count", "description": "Hacker News scraper: search stories and comments by keyword, or read the front page, newest, Ask, Show, jobs and best. Filters by date, points and comments, up to 10,000 per search. Official HN APIs, so it never breaks. $1 per 1,000 stories and comments.", "version": "0.1", "x-build-id": "6LcHfHTpjvUBGeFzs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/om_kh~hacker-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-om_kh-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/om_kh~hacker-news-scraper/runs": { "post": { "operationId": "runs-sync-om_kh-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/om_kh~hacker-news-scraper/run-sync": { "post": { "operationId": "run-sync-om_kh-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": { "keywords": { "title": "Search keywords", "type": "array", "description": "Brand, product, or tech keywords to monitor across Hacker News stories and comments.", "items": { "type": "string" } }, "sections": { "title": "Sections (optional)", "type": "array", "description": "Read whole Hacker News sections, with or without keywords.", "items": { "type": "string", "enum": [ "front", "newest", "ask", "show", "jobs", "best" ], "enumTitles": [ "Front page", "Newest", "Ask HN", "Show HN", "Jobs", "Best" ] } }, "maxStories": { "title": "Max results per keyword or section", "minimum": 1, "maximum": 10000, "type": "integer", "description": "1 to 10,000. Default 100.", "default": 100 }, "contentType": { "title": "What to search", "enum": [ "all", "stories", "comments" ], "type": "string", "description": "For keyword searches.", "default": "all" }, "sortBy": { "title": "Sort by", "enum": [ "date", "popularity" ], "type": "string", "description": "For keyword searches. Popularity returns at most 1,000 results.", "default": "date" }, "dateFrom": { "title": "From date (optional)", "type": "string", "description": "YYYY-MM-DD, inclusive." }, "dateTo": { "title": "To date (optional)", "type": "string", "description": "YYYY-MM-DD, inclusive." }, "minPoints": { "title": "Minimum points (optional)", "minimum": 0, "type": "integer", "description": "Keep only stories with at least this score." }, "minComments": { "title": "Minimum comments (optional)", "minimum": 0, "type": "integer", "description": "Keep only stories with at least this many comments." }, "currentItems": { "title": "Bring your own items (optional)", "type": "array", "description": "Skip the chained fetch and pass records directly (no upstream call, no fetch fee).", "default": [] }, "maxTotalChargeUsd": { "title": "Maximum Vigia charge (USD)", "minimum": 0, "type": "number", "description": "Hard maximum amount that this run may charge." }, "sources": { "title": "Data source (informational)", "type": "array", "description": "Declare every upstream source before this run. Each item needs name, authorization, and estimated_cost_usd.", "default": [ { "name": "Hacker News official Algolia API (first-party)", "authorization": "public_official", "estimated_cost_usd": 0 } ] }, "monitorEnabled": { "title": "Monitor only new results", "type": "boolean", "description": "The first monitored run stores a free baseline. Later runs deliver and charge only new results.", "default": false }, "monitorId": { "title": "Monitor ID (optional)", "type": "string", "description": "Pins the persistent baseline to a name of your choice, so separate targets never share state. Leave empty to derive it automatically.", "default": "" } } }, "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 } } } } } } } } } }