{ "openapi": "3.0.1", "info": { "title": "Hacker News Scraper and Keyword Alert Monitor", "description": "Watches Hacker News new, top, Ask HN, Show HN, and jobs feeds plus Algolia search for stories and comments matching your keywords, score floor, and age window. Dedupes across runs. For founders, devtool marketers, and recruiters tracking mentions, launches, and hiring signals on HN.", "version": "0.1", "x-build-id": "axEC1h7O4tHdkhFPE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapemint~hn-lead-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapemint-hn-lead-monitor", "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/scrapemint~hn-lead-monitor/runs": { "post": { "operationId": "runs-sync-scrapemint-hn-lead-monitor", "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/scrapemint~hn-lead-monitor/run-sync": { "post": { "operationId": "run-sync-scrapemint-hn-lead-monitor", "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 (Algolia)", "type": "array", "description": "Free text queries against Hacker News via Algolia. Example: vector database, open source crm, alternative to notion. Case insensitive. Leave empty if only using firehose feeds below.", "items": { "type": "string" } }, "feeds": { "title": "Firehose feeds (optional)", "type": "array", "description": "HN lists to pull alongside search queries. Valid values: new, top, best, ask, show, jobs. new returns the latest submissions. top/best rank by score. ask/show/jobs are the category pages.", "default": [], "items": { "type": "string" } }, "keywords": { "title": "Keywords (client side filter)", "type": "array", "description": "Only items whose title or text contains any of these keywords are kept. Case insensitive. Leave empty to keep everything the search or feed returned.", "items": { "type": "string" } }, "searchType": { "title": "Search type", "enum": [ "stories", "comments", "both" ], "type": "string", "description": "What Algolia search returns. Stories is submissions only. Comments is only comment bodies. Both pulls from both endpoints.", "default": "stories" }, "sortBy": { "title": "Sort", "enum": [ "newest", "popularity" ], "type": "string", "description": "Newest returns the latest matches first. Popularity ranks by HN points and Algolia relevance.", "default": "newest" }, "maxAgeHours": { "title": "Max age in hours", "minimum": 0, "maximum": 17520, "type": "integer", "description": "Skip items older than this many hours. 0 keeps everything regardless of age.", "default": 168 }, "minScore": { "title": "Minimum points", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Skip stories with fewer than this many HN points. Comments have no score, so this is ignored for comments.", "default": 0 }, "minComments": { "title": "Minimum comments", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Skip stories with fewer than this many comments. Ignored for comment results.", "default": 0 }, "maxItemsPerSource": { "title": "Max items per query or feed", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Per source cap. Algolia pages contain up to 1000 results total via pagination.", "default": 100 }, "maxItemsTotal": { "title": "Maximum items per run", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on items pushed to the dataset per run. Controls cost.", "default": 200 }, "dedupe": { "title": "Deduplicate across runs", "type": "boolean", "description": "Skip HN item IDs pushed on previous runs. Stored in the key value store under SEEN_IDS. Turn off to return every match on every run.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy settings. HN and Algolia endpoints are fully public and do not require a proxy, but add one if your schedule triggers rate limiting." } } }, "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 } } } } } } } } } }