{ "openapi": "3.0.1", "info": { "title": "Hacker News Mentions Monitor: Keyword and Domain Alerts", "description": "Hacker News keyword monitor: alert me when my startup is mentioned on Hacker News, track Hacker News mentions of a domain, plus a new Hacker News comments monitor for a keyword. Stories above minimum points, only-new-since-last-run alerts. Keyword alerts to Google Sheets or n8n. No API key.", "version": "1.0", "x-build-id": "V8ndSNI4Ty1bqSGkb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/accountable_eel~hackernews-mentions-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-accountable_eel-hackernews-mentions-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/accountable_eel~hackernews-mentions-monitor/runs": { "post": { "operationId": "runs-sync-accountable_eel-hackernews-mentions-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/accountable_eel~hackernews-mentions-monitor/run-sync": { "post": { "operationId": "run-sync-accountable_eel-hackernews-mentions-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": { "queries": { "title": "Keywords or domains to watch", "type": "array", "description": "One search per line: a keyword, a phrase, or a bare domain such as apify.com. Each line is searched on Hacker News stories and/or comments. Accepted formats: openai, apify.com, \"show hn\". You're only charged for the ones we actually find — a miss costs nothing.", "items": { "type": "string" } }, "tags": { "title": "What to search", "type": "array", "description": "Stories, comments, or both. Default is both. Each choice is a separate Hacker News search for every keyword.", "items": { "type": "string", "enum": [ "story", "comment" ], "enumTitles": [ "Stories", "Comments" ] } }, "testRun": { "title": "Try it first — only process the first 5", "type": "boolean", "description": "Turn this on to test your input on a small sample before running the full list. Turn it off to process everything.", "default": false }, "onlyFound": { "title": "Hide rows with no result", "type": "boolean", "description": "Only keep rows where something was actually found. Misses are always free, whether or not you show them here.", "default": false }, "includeKeywords": { "title": "Only keep rows containing", "type": "array", "description": "Optional. Only keep results that mention at least one of these words (e.g. a job title, a city, a product name). Leave empty to keep everything.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Skip rows containing", "type": "array", "description": "Optional. Drop any result that mentions one of these words. Leave empty to skip nothing.", "items": { "type": "string" } }, "maxResults": { "title": "Max mentions per keyword", "type": "integer", "description": "Caps how many mentions you get (and pay for) from each keyword, across the story and comment searches you picked. Default 100.", "default": 100 }, "sinceDays": { "title": "Only mentions from the last N days", "type": "integer", "description": "How far back to search. Default 7. Applied as a posted-date filter on Hacker News, before you are billed.", "default": 7 }, "minPoints": { "title": "Minimum points (stories only)", "type": "integer", "description": "Optional. Keep a story only when it has at least this many points. Has no effect on comment hits, which carry no points field. Leave empty to keep every story." }, "onlyNewSinceLastRun": { "title": "Only return mentions that are new since the last run", "type": "boolean", "description": "Turns each keyword into an alert. A mention counts as new when its Hacker News item id has not been returned for that keyword by a previous run of the same watchlist. Already-seen mentions are dropped before you are billed, so a run with nothing new costs only the start fee. Item ids not seen for 30 days are forgotten.", "default": false }, "deltaName": { "title": "Watchlist name (optional)", "type": "string", "description": "Leave empty and one is derived from your search settings, with a separate memory per keyword. Type your own name to keep two schedules of the same search apart. Naming a watchlist with the checkbox above off returns every mention but still stamps each one with 'Is this mention new?' so you can filter in Sheets, n8n or Make.", "default": "" }, "columns": { "title": "Which columns do you want?", "type": "array", "description": "Choose which pieces of information to include in each result row. All are included by default.", "items": { "type": "string", "enum": [ "mentionCount", "mentions", "objectID", "type", "title", "url", "author", "points", "numComments", "commentText", "createdAt", "hnUrl", "isNew", "firstSeenAt" ], "enumTitles": [ "Mentions returned", "All mentions (full list)", "Hacker News item id", "Story or comment", "Title", "Link", "Author", "Points", "Comments on the story", "Comment text (first 500 characters)", "Posted", "Hacker News permalink", "Is this mention new?", "First seen on a run" ] }, "default": [ "mentionCount", "mentions", "objectID", "type", "title", "url", "author", "points", "numComments", "commentText", "createdAt", "hnUrl", "isNew", "firstSeenAt" ] }, "expandRows": { "title": "One row per mention (recommended) — turn off for one row per search instead", "type": "boolean", "description": "When on, each mention found gets its own row instead of being grouped under its search. You're still only charged once per search, no matter how many rows it produces.", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "Parallel requests. Keep conservative — this target has no browser fallback, so getting blocked costs more than slow-and-steady.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy config. Residential recommended for anti-bot-sensitive targets.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }