{ "openapi": "3.0.1", "info": { "title": "Ai Synthetic Data Generator", "description": "Generate unlimited, high-quality synthetic data for training AI models, testing systems, and building robust agentic applications", "version": "3.0", "x-build-id": "NhFpT4KL2tq3gbN4g" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ruv~ai-synthetic-data-generator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ruv-ai-synthetic-data-generator", "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/ruv~ai-synthetic-data-generator/runs": { "post": { "operationId": "runs-sync-ruv-ai-synthetic-data-generator", "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/ruv~ai-synthetic-data-generator/run-sync": { "post": { "operationId": "run-sync-ruv-ai-synthetic-data-generator", "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": [ "count" ], "properties": { "mode": { "title": "Mode", "enum": [ "generate", "integrate", "template" ], "type": "string", "description": "Operation mode: generate synthetic data or integrate with other Apify actors", "default": "generate" }, "dataType": { "title": "Website/API Type", "enum": [ "ecommerce", "social", "api_response", "search_results", "real_estate", "jobs", "news", "stock_trading", "medical", "company", "supply_chain", "financial", "bloomberg", "zoominfo", "factset", "lseg", "crunchbase", "eeg", "cgm", "siem", "threat_intel", "netflow", "scada", "lidar", "canbus", "genomic_vcf", "satellite", "fmri", "protein_pdb", "power_grid", "ais", "radar", "structured", "timeseries", "events", "embeddings", "demo" ], "type": "string", "description": "What type of website or API do you want to simulate?", "default": "ecommerce" }, "count": { "title": "Number of Records", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many records to generate (1-10,000). Start small to test, then scale up.", "default": 100 }, "schema": { "title": "Custom Data Schema", "type": "object", "description": "Define your own data structure for 'structured' type. Example: {\"url\": \"string (url)\", \"title\": \"string\", \"price\": \"number (10-500)\"}" }, "apiEndpoint": { "title": "API Endpoint (for API Response)", "type": "string", "description": "Base endpoint path for API simulation. Example: /api/products", "default": "/api/products" }, "eventTypes": { "title": "Event Types (for Web Events)", "type": "array", "description": "Types of web events to generate", "items": { "type": "string" } }, "timeSeriesConfig": { "title": "Time-Series Configuration", "type": "object", "description": "Settings for time-series data (prices, metrics, etc.)" }, "integrateActorId": { "title": "Apify Actor to Integrate", "enum": [ "apify/google-maps-scraper", "apify/google-search-scraper", "apify/instagram-scraper", "apify/tiktok-scraper", "apify/youtube-scraper", "apify/twitter-scraper", "apify/amazon-scraper", "apify/shopify-scraper", "apify/web-scraper", "apify/website-content-crawler", "apify/cheerio-scraper", "apify/news-scraper", "apify/linkedin-scraper", "trudax/tripadvisor-scraper", "maxcopell/yelp-scraper", "trudax/booking-scraper", "petr_cermak/zillow-scraper", "epctex/craigslist-scraper", "apify/reddit-scraper", "apify/facebook-posts-scraper", "compass/google-places-api" ], "type": "string", "description": "Actor ID to pull data from. 21 actors supported. Used in 'integrate' mode." }, "integrateRunId": { "title": "Run ID", "type": "string", "description": "Specific run ID to pull data from, or 'latest' for most recent run", "default": "latest" }, "integrateDatasetId": { "title": "Dataset ID (Alternative)", "type": "string", "description": "Direct dataset ID to pull data from (alternative to Run ID)" }, "memorizeFields": { "title": "Fields to Memorize", "type": "array", "description": "Which fields to extract for RAG/memory. Leave empty for defaults.", "items": { "type": "string" } }, "useTemplate": { "title": "Use Case Template", "enum": [ "lead-intelligence", "competitor-monitor", "support-knowledge", "research-assistant", "content-library", "product-catalog", "review-aggregator", "price-tracker", "social-listening", "talent-sourcing", "real-estate-intel", "travel-planner" ], "type": "string", "description": "Pre-built template for common use cases. 12 templates available. Used in 'template' mode." }, "generateEmbeddings": { "title": "Generate Embeddings", "type": "boolean", "description": "Generate vector embeddings for all output records (useful for RAG systems)", "default": false }, "useOnnxEmbeddings": { "title": "Use ONNX Semantic Embeddings", "type": "boolean", "description": "Use real semantic embeddings via ONNX (slower but more accurate) vs random vectors (fast for testing)", "default": true }, "embeddingModel": { "title": "ONNX Embedding Model", "enum": [ "all-MiniLM-L6-v2", "bge-small-en-v1.5", "all-mpnet-base-v2", "e5-small-v2", "gte-small" ], "type": "string", "description": "Choose embedding model. Smaller models are faster, larger models are more accurate.", "default": "all-MiniLM-L6-v2" }, "embeddingDimensions": { "title": "Embedding Dimensions", "minimum": 32, "maximum": 4096, "type": "integer", "description": "Vector size for embeddings. 384 (fast), 768 (accurate), 1536 (OpenAI compatible)", "default": 384 }, "provider": { "title": "AI Provider", "enum": [ "none", "openrouter", "gemini", "anthropic" ], "type": "string", "description": "AI provider for enhanced generation. DeepSeek via OpenRouter is default (low cost). Works great without AI too!", "default": "none" }, "model": { "title": "Model", "enum": [ "deepseek/deepseek-chat", "deepseek/deepseek-reasoner", "meta-llama/llama-3.3-70b-instruct", "mistralai/mistral-large-2411", "openai/gpt-4o-mini", "openai/gpt-4o", "anthropic/claude-sonnet-4", "anthropic/claude-opus-4", "anthropic/claude-3.5-sonnet-20241022", "anthropic/claude-3.5-haiku-20241022", "gemini-2.0-flash", "gemini-2.0-flash-exp", "gemini-1.5-pro", "gemini-1.5-flash" ], "type": "string", "description": "AI model to use. DeepSeek is extremely low cost ($0.14/1M input, $0.28/1M output).", "default": "deepseek/deepseek-chat" }, "openrouterApiKey": { "title": "OpenRouter API Key", "type": "string", "description": "Get your key at https://openrouter.ai/keys - Access DeepSeek, GPT-4, Claude, Llama via single API" }, "geminiApiKey": { "title": "Gemini API Key", "type": "string", "description": "Get your key at https://aistudio.google.com/apikey - Free tier available" }, "anthropicApiKey": { "title": "Anthropic API Key", "type": "string", "description": "Get your key at https://console.anthropic.com - Direct Claude API access" }, "quality": { "title": "Data Quality", "minimum": 0.1, "maximum": 1, "type": "number", "description": "Quality level (0.1-1.0). Higher = more realistic but uses more AI tokens.", "default": 0.8 }, "sonaEnabled": { "title": "Enable SONA Learning", "type": "boolean", "description": "Enable TRM/SONA self-learning for intelligent pattern recognition in data generation. Learns from generation patterns to improve data quality.", "default": true }, "ewcLambda": { "title": "EWC Lambda", "minimum": 100, "maximum": 10000, "type": "number", "description": "Elastic Weight Consolidation strength for pattern preservation. Higher values maintain more learned patterns across generations.", "default": 2000 }, "patternThreshold": { "title": "Pattern Threshold", "minimum": 0.1, "maximum": 1, "type": "number", "description": "Minimum confidence threshold for pattern recognition in data generation (0-1)", "default": 0.7 }, "sonaLearningTiers": { "title": "Learning Tiers", "type": "array", "description": "SONA learning tiers: instant (real-time), background (async optimization), deep (comprehensive analysis)", "default": [ "instant", "background" ] }, "simulationMode": { "title": "Long-Running Simulation", "type": "boolean", "description": "Enable simulation mode for testing scrapers that poll for updates. Data is pushed in batches with delays.", "default": false }, "batchSize": { "title": "Batch Size (Simulation)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Number of records per batch in simulation mode", "default": 100 }, "delayBetweenBatches": { "title": "Delay Between Batches (ms)", "minimum": 0, "maximum": 60000, "type": "integer", "description": "Milliseconds to wait between batches in simulation mode. Use 1000 for 1 second delays.", "default": 0 }, "seed": { "title": "Random Seed", "type": "string", "description": "Set a seed for reproducible results. Same seed = same data every time." }, "outputFormat": { "title": "Output Format", "enum": [ "json", "jsonl", "csv" ], "type": "string", "description": "Format for output data", "default": "json" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "URL to POST results to when generation completes (for async workflows)" }, "crunchbaseCompanies": { "title": "Company Names (Crunchbase)", "type": "array", "description": "Specific company names to research. Leave empty to auto-generate based on industry.", "items": { "type": "string" } }, "crunchbaseIndustry": { "title": "Industry Filter (Crunchbase)", "type": "string", "description": "Filter companies by industry (e.g., 'fintech', 'healthcare', 'AI/ML'). Leave empty for all industries." }, "memorySessionEnabled": { "title": "Enable Memory Session", "type": "boolean", "description": "Save generated data to a persistent memory session. Data persists across runs and can be shared with AI Memory Engine.", "default": false }, "memorySessionId": { "title": "Memory Session ID", "type": "string", "description": "Unique session identifier. Use the same ID across runs to accumulate data. Can be accessed by AI Memory Engine." }, "appendToSession": { "title": "Append to Existing Session", "type": "boolean", "description": "If enabled, new data is added to existing session. If disabled, session is replaced.", "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 } } }, "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 } } } } } } } } } }