{ "openapi": "3.0.1", "info": { "title": "Hacker News Scraper", "description": "Extract stories, comments, and user data from Hacker News. Browse 6 feed types (Top, New, Best, Ask HN, Show HN, Jobs) or search with filters for points, comments, and date ranges. Get nested comment threads with depth control and author karma scores. Perfect for tech trends monitoring and analysis.", "version": "1.0", "x-build-id": "kmoqmYzJ0nnhbJC7a" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~hacker-news-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-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/parseforge~hacker-news-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-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/parseforge~hacker-news-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-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": [ "mode" ], "properties": { "mode": { "title": "🎯 Scraping Mode", "enum": [ "feed", "search" ], "type": "string", "description": "Choose how to get stories:\n\n- feed: Browse curated feeds (Top, New, Best, Ask HN, Show HN, Jobs)\n- search: Full-text search with advanced filtering", "default": "feed" }, "maxItems": { "title": "📊 Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of items to collect. Free users: Limited to 100. Paid users: Optional, max 1,000,000." }, "feedType": { "title": "📰 Feed Type", "enum": [ "top", "new", "best", "ask", "show", "job" ], "type": "string", "description": "Which feed to scrape. Only used when mode is 'feed'.", "default": "top" }, "searchQuery": { "title": "🔍 Search Query", "type": "string", "description": "Search term for full-text search. Only used when mode is 'search'.\n\nExamples: AI, web scraping, startup funding" }, "contentType": { "title": "📝 Content Type", "enum": [ "story", "comment", "all" ], "type": "string", "description": "Type of content to search for.", "default": "story" }, "sortBy": { "title": "🔄 Sort By", "enum": [ "relevance", "date" ], "type": "string", "description": "Sort search results by relevance or date.", "default": "relevance" }, "minPoints": { "title": "⬆️ Minimum Points", "minimum": 0, "type": "integer", "description": "Only return stories with at least this many points. Leave empty for no minimum." }, "minComments": { "title": "💬 Minimum Comments", "minimum": 0, "type": "integer", "description": "Only return stories with at least this many comments. Leave empty for no minimum." }, "dateFrom": { "title": "📅 Date From", "type": "string", "description": "Only return content created after this date (YYYY-MM-DD)." }, "dateTo": { "title": "📅 Date To", "type": "string", "description": "Only return content created before this date (YYYY-MM-DD)." }, "includeComments": { "title": "💬 Include Comments", "type": "boolean", "description": "Fetch comment threads for each story. Each story requires separate API requests, which increases run time.", "default": false }, "maxCommentDepth": { "title": "🔢 Max Comment Depth", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum depth of nested comment replies to fetch.", "default": 2 }, "maxCommentsPerStory": { "title": "🔢 Max Comments Per Story", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of top-level comments to fetch per story.", "default": 10 }, "includeAuthorInfo": { "title": "👤 Include Author Info", "type": "boolean", "description": "Fetch karma and account age for each author. Each author requires a separate API request.", "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 } } }, "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 } } } } } } } } } }