{ "openapi": "3.0.1", "info": { "title": "Show HN Founder Lead Extractor", "description": "Turn Hacker News Show HN launches into founder leads: discover via HN's keyless Algolia API, then enrich the founder's own project site with MX/DNS-verified emails, phones, socials, tech stack, A-D lead score, fresh-founder-readiness signal.", "version": "1.0", "x-build-id": "p7mNwhP6Yv0sP9p8x" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ayeeyee~hackernews-showhn-founder-lead-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ayeeyee-hackernews-showhn-founder-lead-extractor", "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/ayeeyee~hackernews-showhn-founder-lead-extractor/runs": { "post": { "operationId": "runs-sync-ayeeyee-hackernews-showhn-founder-lead-extractor", "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/ayeeyee~hackernews-showhn-founder-lead-extractor/run-sync": { "post": { "operationId": "run-sync-ayeeyee-hackernews-showhn-founder-lead-extractor", "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": "Keywords / queries", "maxItems": 50, "type": "array", "description": "Keywords to discover Show HN launches via HN's keyless Algolia API (e.g. 'AI agent', 'developer tool'). Use the literal 'Show HN' (the default) to sweep all Show HN launches. Only stories whose title starts with 'Show HN:' are kept.", "items": { "type": "string" } }, "maxPerQuery": { "title": "Max results per query", "minimum": 1, "maximum": 50, "type": "integer", "description": "Cap on Show HN launches returned per query (1-50).", "default": 10 }, "sinceDays": { "title": "Only launched in last N days (monitoring)", "minimum": 0, "maximum": 365, "type": "integer", "description": "Keep only Show HN stories created within the trailing N days. 0 = no recency filter (sweep all time). Use this for the 'newly launched since last run' monitoring mode.", "default": 0 }, "minPoints": { "title": "Minimum HN points", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Keep only Show HN stories with at least this many HN points (community traction). 0 = no minimum.", "default": 0 }, "verifyEmails": { "title": "Verify emails (MX/DNS)", "type": "boolean", "description": "Validate the best contact email's domain against live MX/DNS records.", "default": true }, "enrichWebsite": { "title": "Enrich project website", "type": "boolean", "description": "Fetch the founder's own project website (the Show HN story url) and extract emails/phones/socials/tech stack. Disable for faster, metadata-only runs (no contact data, nothing billed).", "default": true }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Show HN launches enriched in parallel (1-10).", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Only needed if you hit rate limits; the Actor works without a proxy (HN's keyless Algolia API + the founders' own public websites)." } } }, "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 } } } } } } } } } }