{ "openapi": "3.0.1", "info": { "title": "Micro-SaaS & Side Project Ideas Finder 🚀", "description": "Find side project ideas and micro-SaaS opportunities from Hacker News Show HN, ranked by momentum - points gained per hour - so you see what is gaining traction now. Includes upvotes, comments, velocity and an engagement tier. No API key needed.", "version": "1.6", "x-build-id": "MfQF2ytlAMvO9CUax" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/joey001~microsaas-sideproject-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-joey001-microsaas-sideproject-finder", "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/joey001~microsaas-sideproject-finder/runs": { "post": { "operationId": "runs-sync-joey001-microsaas-sideproject-finder", "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/joey001~microsaas-sideproject-finder/run-sync": { "post": { "operationId": "run-sync-joey001-microsaas-sideproject-finder", "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": { "timeFilter": { "title": "Time filter", "enum": [ "day", "week", "month", "year", "all" ], "type": "string", "description": "How far back to look, based on submission date. This is a quality dial as much as a recency one: results arrive ranked by points, so drawing from a longer window makes any given number of rows more selective. \"Past month\" is the default because it balances fresh leads against enough volume to filter out low-scoring submissions. \"All time\" returns historically significant posts rather than current leads.", "default": "month" }, "maxPosts": { "title": "Max posts", "minimum": 10, "maximum": 200, "type": "integer", "description": "Maximum number of matching launches to return (10-200). If fewer match, you get all of them. Results are returned highest-scoring first, so this is where you draw the line down that list: at 100 rows on a month window every row has 60+ points, while going deeper pulls in submissions that never got attention. Raise it only if you want breadth and will filter yourself.", "default": 100 }, "sortBy": { "title": "Sort results by", "enum": [ "velocity", "engagement", "comments", "newest" ], "type": "string", "description": "Velocity ranks by points gained per hour, so it surfaces launches that are climbing right now and does not favour older posts that accumulated points slowly. Engagement ranks by lifetime upvotes + (comments x 2), which is close to ranking by raw upvotes. Comments ranks by lifetime comment count, and Newest by submission time.", "default": "velocity" }, "onlyWithExternalUrl": { "title": "Only keep posts with external URLs", "type": "boolean", "description": "Keep only launches that link to an off-Hacker-News destination. Drops text-only threads and self-links back to news.ycombinator.com, so the projectUrl column always points at a real product, demo or repository.", "default": 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 } } } } } } } } } }