{ "openapi": "3.0.1", "info": { "title": "Apify Ideas Radar", "description": "Scans Apify Ideas and Store actors to surface build opportunities. Discover mode maps each idea to top actor matches; Search mode validates a keyword with semantic/exact matching, challenge eligibility, and competition/demand summary.", "version": "0.1", "x-build-id": "9JiEkMQGNedNxtGqg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yummy_gelato~apify-ideas-radar/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yummy_gelato-apify-ideas-radar", "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/yummy_gelato~apify-ideas-radar/runs": { "post": { "operationId": "runs-sync-yummy_gelato-apify-ideas-radar", "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/yummy_gelato~apify-ideas-radar/run-sync": { "post": { "operationId": "run-sync-yummy_gelato-apify-ideas-radar", "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": { "mode": { "title": "Mode", "enum": [ "discover", "search" ], "type": "string", "description": "Discover finds opportunities across all ideas. Search validates a specific keyword.", "default": "discover" }, "keyword": { "title": "Keyword", "type": "string", "description": "Keyword or phrase to search for (e.g., 'shopify', 'pricing page monitoring'). Required for search mode." }, "searchMethod": { "title": "Search Method", "enum": [ "semantic", "exact" ], "type": "string", "description": "Semantic finds related concepts using TF-IDF. Exact finds literal keyword matches.", "default": "semantic" }, "ideas_status": { "title": "Ideas Status Filter", "enum": [ "toDevelop", "all" ], "type": "string", "description": "Filter ideas by development status. 'To Develop' shows ideas awaiting development, 'All' shows all ideas.", "default": "toDevelop" }, "max_ideas": { "title": "Maximum Ideas", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Limit the number of ideas to process (1-10000). Leave empty for no limit." }, "idea_categories": { "title": "Idea Categories", "uniqueItems": true, "type": "array", "description": "Filter ideas to only these categories. Empty = all categories. Ideas without categories are always included.", "items": { "type": "string", "enum": [ "Agents", "AI", "Automation", "Business", "Developer tools", "E-commerce", "Education", "For creators", "Integrations", "Jobs", "Lead generation", "Marketing", "MCP servers", "Real estate", "SEO tools", "Social media", "Sports", "Travel", "Videos", "Other" ], "enumTitles": [ "Agents", "AI", "Automation", "Business", "Developer tools", "E-commerce", "Education", "For creators", "Integrations", "Jobs", "Lead generation", "Marketing", "MCP servers", "Real estate", "SEO tools", "Social media", "Sports", "Travel", "Videos", "Other" ] }, "default": [] }, "max_actors": { "title": "Maximum Actors", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Limit the number of actors to fetch from Store API (1-10000). Leave empty for no limit." }, "exclude_actor_keywords": { "title": "Exclude Actor Keywords", "type": "array", "description": "Case-insensitive substring filters for actors. Any actor whose name/title/description contains any keyword is removed from the evidence pool. Leave empty to disable. This does not affect idea risk detection.", "items": { "type": "string" } }, "pricing_model": { "title": "Pricing Model", "enum": [ "", "FREE", "PAY_PER_EVENT", "PRICE_PER_DATASET_ITEM", "FLAT_PRICE_PER_MONTH" ], "type": "string", "description": "Filter store actors by pricing model before matching to ideas. Leave empty to include all pricing models. Challenge-eligible options are FREE and PAY_PER_EVENT; PRICE_PER_DATASET_ITEM (PPR) and FLAT_PRICE_PER_MONTH (Rental) are not Challenge-eligible." }, "challenge_eligible_only": { "title": "Challenge Eligible Only", "type": "boolean", "description": "Filter out ideas that are ineligible for the Apify $1M Challenge. Ineligible ideas mention a restricted platform (YouTube, LinkedIn, etc.) AND a scraping-related keyword. Custom exclusions via 'Idea Keyword Excludes' also mark ideas as ineligible.", "default": true }, "idea_keyword_excludes": { "title": "Idea Keyword Excludes", "type": "array", "description": "Additional keywords that mark ideas as ineligible (case-insensitive substring matching). Ideas matching any keyword will have eligible_for_challenge=false.", "items": { "type": "string" }, "default": [] }, "fit_types": { "title": "Fit Types", "type": "array", "description": "Market signal types to detect. Select which fit-types to include in output.", "items": { "type": "string", "enum": [ "painful_demand", "high_intent_low_usage", "rising", "proven_demand" ] }, "default": [ "painful_demand", "high_intent_low_usage", "rising", "proven_demand" ] }, "fit_threshold_overrides": { "title": "Fit Threshold Overrides", "type": "object", "description": "Optional: Override default thresholds per fit-type. Provide an object keyed by fit type (painful_demand, high_intent_low_usage, rising, proven_demand) with only the numeric thresholds you want to change. Supported keys: minUsers30, maxRating, minReviews, minBookmarks, maxUsers30, minUsers7Ratio, minUsers90, minRating. Example: {\"painful_demand\": {\"minUsers30\": 500, \"maxRating\": 3.5}, \"rising\": {\"minUsers7Ratio\": 0.6}}. Leave empty to keep defaults: painful_demand (minUsers30=100, maxRating=4.0, minReviews=5); high_intent_low_usage (minBookmarks=50, maxUsers30=100); rising (minUsers30=20, minUsers7Ratio=0.35); proven_demand (minUsers90=200, minRating=4.0, minReviews=10)." }, "num_top_similar": { "title": "Top N Similar Actors", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of most similar actors to include as evidence for each idea (1-10).", "default": 3 }, "min_similarity": { "title": "Minimum Similarity", "pattern": "^(0(\\.\\d+)?|1(\\.0+)?)$", "type": "string", "description": "Minimum cosine similarity threshold for including actor matches (0.0-1.0). Lower values include more matches.", "default": "0.18" } } }, "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 } } } } } } } } } }