# Voiceflow Discovery Scraper (`getdataforme/voiceflow-discovery-scraper`) Actor The Voiceflow Discovery Scraper is an Apify tool for extracting data from Voiceflow's AI chatbot templates, aiding in market research and competitive analysis. It offers customizable searches, flexible item limits, and outputs structured JSON for easy integration.... - **URL**: https://apify.com/getdataforme/voiceflow-discovery-scraper.md - **Developed by:** [GetDataForMe](https://apify.com/getdataforme) (community) - **Categories:** AI, Automation, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $9.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README --- ## Voiceflow Discovery Scraper ### Introduction The Voiceflow Discovery Scraper is a powerful tool designed to extract valuable data from Voiceflow's extensive library of templates. This Apify Actor enables users to efficiently gather information on various AI-powered chatbot templates, facilitating market research and competitive analysis. ### Features - **Comprehensive Data Extraction**: Scrape detailed information about Voiceflow templates. - **Customizable Search**: Tailor searches with specific search keys for targeted results. - **Flexible Item Limits**: Set item limits per run to control data volume. - **High-Quality Output**: Receive structured JSON output for easy integration and analysis. - **User-Friendly Configuration**: Simple setup with intuitive input parameters. ### Input Parameters | Parameter | Type | Required | Description | Example | |-------------|---------|----------|-----------------------------------------------------------------------------------------------|------------------| | SearchKey | string | No | The search key for the spider. Defaults to "ai". | `"SearchKey": "support"` | | item_limit | integer | No | Maximum items to scrape per actor run. Set to 0 for no limit. | `"item_limit": 20` | ### Example Usage #### Input JSON ```json { "SearchKey": "ai", "item_limit": 10 } ```` #### Output JSON ```json [ { "id": "67ab6e77aaa3d2d3677f742e", "url": "https://www.voiceflow.com/templates/complete-support-chatbot", "title": "Complete support chatbot template", "description": "Download this template to build a complete support chatbot that answers FAQs, recommends products, captures user information, and more.", "author": "Daniel D'Souza", "type": "Template", "downloads": 4927, "image_url": "https://cdn.prod.website-files.com/6995bfb8e3e1359ecf9c33a8/6995bfb8e3e1359ecf9c50f1_CS%20Complete%20(1).webp", "actor_id": "BHcFwA5bAFaeFEAOL", "run_id": "bhS4vP0yZDgl4On5P" }, { "id": "67ab6e708ee9227d75688495", "url": "https://www.voiceflow.com/templates/ai-agent-with-knowledge-base-memory", "title": "AI Agent with Knowledge Base Memory", "description": "Use this template to create an AI agent that handles follow ups with contextual memory", "author": "W. Williams", "type": "Template", "downloads": 2176, "image_url": "https://cdn.prod.website-files.com/6995bfb8e3e1359ecf9c33a8/6995bfb8e3e1359ecf9c4da2_KB%20Memory.webp", "actor_id": "BHcFwA5bAFaeFEAOL", "run_id": "bhS4vP0yZDgl4On5P" }, { "id": "67ab6e757407d311ea52c28e", "url": "https://www.voiceflow.com/templates/building-an-ai-powered-hotel-booking-assistant", "title": "Building an AI-Powered Hotel Booking Assistant", "description": "Pete walks through how to build a personalized hotel booking assistant for Hotels.com by leveraging CRM data, large language models (LLMs), and Airtable integration.", "author": "Peter Isaacs", "type": "Template", "downloads": 1473, "image_url": "https://cdn.prod.website-files.com/6995bfb8e3e1359ecf9c33a8/6995bfb8e3e1359ecf9c4e96_Hotels.avif", "actor_id": "BHcFwA5bAFaeFEAOL", "run_id": "bhS4vP0yZDgl4On5P" } ] ``` ### Use Cases - **Market Research and Analysis**: Gain insights into the latest trends in AI chatbot templates. - **Competitive Intelligence**: Monitor competitors' use of Voiceflow templates. - **Price Monitoring**: Track pricing changes for various templates over time. - **Content Aggregation**: Compile a comprehensive list of available templates for analysis or reporting. - **Academic Research**: Use data for studies on AI template adoption and innovation. - **Business Automation**: Automate the collection of template data to inform business strategies. ### Installation and Usage 1. Search for "Voiceflow Discovery Scraper" in the Apify Store. 2. Click "Try for free" or "Run". 3. Configure input parameters as needed. 4. Click "Start" to begin extraction. 5. Monitor progress in the log. 6. Export results in your preferred format (JSON, CSV, Excel). ### Output Format The output is a JSON array of objects, each representing a Voiceflow template with fields such as `id`, `url`, `title`, `description`, `author`, `type`, `downloads`, `image_url`, `actor_id`, and `run_id`. This structured format allows for easy parsing and integration into other systems. ### Error Handling The Actor is designed to handle common errors gracefully, including network issues or changes in the target website's structure. If an error occurs, it will be logged with details to assist in troubleshooting. Users are encouraged to check logs for any issues during execution. ### Rate Limiting and Best Practices To ensure optimal performance and avoid being blocked by the target site, adhere to the following best practices: - Respect rate limits by configuring appropriate delays between requests. - Use the `item_limit` parameter to manage data volume efficiently. - Regularly update the Actor if changes in the target website's structure are detected. ### Limitations - The Actor may not capture all templates if they are dynamically loaded or require authentication. - Changes in Voiceflow's website structure could affect data extraction accuracy. - Ensure compliance with Voiceflow's terms of service when using this tool for scraping. ### Support For custom/simplified outputs or bug reports, please contact: - Email: support@getdataforme.com - Subject line: "custom support" - Contact form: [Contact Us](https://getdataforme.com/contact/) We're here to help you get the most out of this Actor! # Actor input Schema ## `SearchKey` (type: `string`): The search key for the spider. ## `item_limit` (type: `integer`): Maximum items to scrape per actor run. Set to 0 for no limit. ## Actor input object example ```json { "SearchKey": "ai", "item_limit": 10 } ``` # Actor output Schema ## `results` (type: `string`): Scraped data items from dataset # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("getdataforme/voiceflow-discovery-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("getdataforme/voiceflow-discovery-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call getdataforme/voiceflow-discovery-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getdataforme/voiceflow-discovery-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Voiceflow Discovery Scraper", "description": "The Voiceflow Discovery Scraper is an Apify tool for extracting data from Voiceflow's AI chatbot templates, aiding in market research and competitive analysis. It offers customizable searches, flexible item limits, and outputs structured JSON for easy integration....", "version": "0.0", "x-build-id": "RJuoxgHzuUgARH3mI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getdataforme~voiceflow-discovery-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getdataforme-voiceflow-discovery-scraper", "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/getdataforme~voiceflow-discovery-scraper/runs": { "post": { "operationId": "runs-sync-getdataforme-voiceflow-discovery-scraper", "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/getdataforme~voiceflow-discovery-scraper/run-sync": { "post": { "operationId": "run-sync-getdataforme-voiceflow-discovery-scraper", "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": { "SearchKey": { "title": "Search Key", "type": "string", "description": "The search key for the spider.", "default": "ai" }, "item_limit": { "title": "Item limit", "minimum": 0, "type": "integer", "description": "Maximum items to scrape per actor run. Set to 0 for no limit.", "default": 10 } } }, "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 } } } } } } } } } } ```