{ "openapi": "3.0.1", "info": { "title": "Niche & Product Idea Demand Validator (Score 0-100)", "description": "Validate product and niche ideas in one run: Google, YouTube and Amazon autocomplete, Google Trends 5-year growth and seasonality, and App Store / Google Play review pain, combined into a transparent 0-100 Demand Score with a plain-English verdict.", "version": "0.1", "x-build-id": "XHL39x9fFtTDekAgZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/happysproutstore~niche-demand-validator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-happysproutstore-niche-demand-validator", "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/happysproutstore~niche-demand-validator/runs": { "post": { "operationId": "runs-sync-happysproutstore-niche-demand-validator", "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/happysproutstore~niche-demand-validator/run-sync": { "post": { "operationId": "run-sync-happysproutstore-niche-demand-validator", "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": [ "ideas" ], "properties": { "ideas": { "title": "Ideas to validate", "type": "array", "description": "One niche, product or app idea per line, written the way a buyer would search for it, e.g. \"habit tracker app\", \"cooling towel\", \"dog birthday cake\". Each idea gets its own row and score.", "default": [ "habit tracker app" ], "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Two-letter country codes such as us, gb, de, tr. Every idea is checked in every country (one row and one charge per idea and country). Autocomplete, Google Trends, the Amazon marketplace and the app stores all follow this country.", "default": [ "us" ], "items": { "type": "string" } }, "language": { "title": "Language", "type": "string", "description": "Two-letter language code for Google / YouTube autocomplete and Google Play reviews, e.g. en, de, tr. Write the ideas in this language.", "default": "en" }, "autocompleteSources": { "title": "Autocomplete sources", "type": "array", "description": "Where search suggestions are collected. Leave all three for the most reliable score.", "items": { "type": "string", "enum": [ "google", "youtube", "amazon" ], "enumTitles": [ "Google Search", "YouTube", "Amazon" ] }, "default": [ "google", "youtube", "amazon" ] }, "autocompleteDepth": { "title": "Autocomplete depth", "enum": [ "standard", "basic" ], "type": "string", "description": "How many variations of each idea are sent to autocomplete. Standard gives a more reliable breadth signal.", "default": "standard" }, "includeTrends": { "title": "Include Google Trends", "type": "boolean", "description": "Adds 5-year trend direction, year-over-year growth, seasonality and peak months. Turn off for the fastest run; the score is then based on the other components.", "default": true }, "appReviews": { "title": "App Store / Google Play review analysis", "enum": [ "auto", "always", "never" ], "type": "string", "description": "Reads recent reviews of the top apps for the idea and measures how unhappy users are (1-2 star share, complaint categories, feature wishes).", "default": "auto" }, "appStores": { "title": "App stores", "type": "array", "description": "Stores searched when app review analysis runs.", "items": { "type": "string", "enum": [ "appstore", "googleplay" ], "enumTitles": [ "Apple App Store", "Google Play" ] }, "default": [ "appstore", "googleplay" ] }, "appsPerStore": { "title": "Top apps per store", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many of the top search results are analyzed in each store.", "default": 3 }, "reviewPagesPerApp": { "title": "Review pages per app (50 reviews each)", "minimum": 1, "maximum": 5, "type": "integer", "description": "Most recent reviews read per app. 1 page = 50 reviews.", "default": 1 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Used for Google Trends only, which limits requests per IP. The default Apify proxy is fine for small batches; use the Residential group for large ones.", "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 } } } } } } } } } }