apify · daveomri · Jul 23, 2025 · Jul 23, 2025 · Jul 23, 2025 · Jul 24, 2025
@@ -0,0 +1,120 @@
+---
+title: Bubble integration
+description: Learn how to integrate your Apify Actors with Bubble for automated workflows and notifications.
+sidebar_label: Bubble
+sidebar_position: 7
+slug: /integrations/bubble
+---
+
+**Learn how to integrate your Apify Actors with Bubble for automated workflows and notifications.**
+
+---
+
+[Bubble](https://bubble.io/) is a no-code platform that allows you to build web applications without writing code. With the Apify integration for Bubble, you can easily connect your Apify Actors to your Bubble applications to automate workflows and display scraped data.
+
+## Get started
+
+To use the Apify integration for Bubble, you will need:
+
+- An [Apify account](https://console.apify.com/)
+- A [Bubble account](https://bubble.io/)
+- A Bubble application where you want to use the integration
+
+## Step 1: Install the Apify plugin for Bubble
+
+To integrate Apify with your Bubble application, you first need to install the Apify plugin from the Bubble plugin marketplace.
+
+![Apify Plugin Download](../images/bubble/plugin_install_preview.png)
+
+1. Go to your Bubble application dashboard.
+2. Navigate to the "Plugins" tab.
+3. Click the "Add plugins" button.
+4. Search for "Apify" in the plugin marketplace.
+5. Click on the Apify plugin and then click "Install".
-1. Go to your Bubble application dashboard.
-2. Navigate to the "Plugins" tab.
-3. Click the "Add plugins" button.
-4. Search for "Apify" in the plugin marketplace.
-5. Click on the Apify plugin and then click "Install".
+1. Go to your Bubble application dashboard and navigate to the **Plugins** tab.
+1. Click the **Add plugins** button.
+1. Search for "Apify" in the plugin marketplace.
+1. Click on the Apify plugin and then click **Install**.
-1. Go to your Bubble application dashboard.
-2. Navigate to the "Plugins" tab.
-3. Click the "Add plugins" button.
-4. Search for "Apify" in the plugin marketplace.
-5. Click on the Apify plugin and then click "Install".
+1. Go to your Bubble application dashboard and navigate to the **Plugins** tab.
+1. Click the **Add plugins** button.
+1. Search for "Apify" in the plugin marketplace.
+1. Click on the Apify plugin and then click **Install**.
+
+## Step 2: Configure the Apify plugin
+
+After installing the plugin, you'll need to provide your API token when setting up Apify actions:
+
+1. You can find your API token in the Apify Console under **Settings > API & Integrations**.
+2. For security, store your API token in your User data type with Privacy rules applied rather than entering it directly in each API call.
+
+## Step 3: Set up automated workflows
-## Step 3: Set up automated workflows
+## Using the integration
+
+Once the plugin is configured, you can start building automated workflows.
-## Step 3: Set up automated workflows
+## Using the integration
+
+Once the plugin is configured, you can start building automated workflows.
+
+### Trigger Actor runs from Bubble events
+
+Create workflows that automatically run Apify Actors when certain events occur in your Bubble app:
+
+1. Create a workflow triggered by your preferred event (form submission, button click, page load, etc.)
+2. Add the "Run Actor" or "Run Actor Task" action to your workflow
+3. Configure the Actor parameters and input data
+4. Set up follow-up actions to handle the results
+
+![Using Apify run Actor](../images/bubble/auto_run_preview.png)
-Create workflows that automatically run Apify Actors when certain events occur in your Bubble app:
-
-1. Create a workflow triggered by your preferred event (form submission, button click, page load, etc.)
-2. Add the "Run Actor" or "Run Actor Task" action to your workflow
-3. Configure the Actor parameters and input data
-4. Set up follow-up actions to handle the results
-
-![Using Apify run Actor](../images/bubble/auto_run_preview.png)
+Create workflows that run Apify Actors in response to events in your Bubble app, such as button clicks or form submissions. In the **Workflow** tab, set up a new workflow with your chosen trigger event. Add a new action and select **Run Actor** or **Run Actor Task** from the Apify plugin. Configure the Actor or Task, including any input data, and include follow-up actions to process the returned data.
+
+![Using Apify run Actor](../images/bubble/auto_run_preview.png)
-Create workflows that automatically run Apify Actors when certain events occur in your Bubble app:
-
-1. Create a workflow triggered by your preferred event (form submission, button click, page load, etc.)
-2. Add the "Run Actor" or "Run Actor Task" action to your workflow
-3. Configure the Actor parameters and input data
-4. Set up follow-up actions to handle the results
-
-![Using Apify run Actor](../images/bubble/auto_run_preview.png)
+Create workflows that run Apify Actors in response to events in your Bubble app, such as button clicks or form submissions. In the **Workflow** tab, set up a new workflow with your chosen trigger event. Add a new action and select **Run Actor** or **Run Actor Task** from the Apify plugin. Configure the Actor or Task, including any input data, and include follow-up actions to process the returned data.
+
+![Using Apify run Actor](../images/bubble/auto_run_preview.png)
+
+### Display Apify data in your application
+
+Use Apify data sources to populate your Bubble app with Actor information and results:
+
+1. Use data calls like "List User Tasks", "List Actor Runs", or "List Store Actors" as data sources for repeating groups
+2. Configure the specific Actor or task you want to display
+3. Use "Fetch Data From Dataset Json As Data" to show actual scraped results from your Actor runs
+
+![Using Apify data calls](../images/bubble/data_preview.png)
-Use Apify data sources to populate your Bubble app with Actor information and results:
-
-1. Use data calls like "List User Tasks", "List Actor Runs", or "List Store Actors" as data sources for repeating groups
-2. Configure the specific Actor or task you want to display
-3. Use "Fetch Data From Dataset Json As Data" to show actual scraped results from your Actor runs
-
-![Using Apify data calls](../images/bubble/data_preview.png)
+Populate elements in your Bubble application with information from your Apify account or Actor run data. Apply data sources like **List User Tasks**, **List Actor Runs**, or **List Store Actors** to repeating groups. To show actual scraped data, use **Fetch Data From Dataset Json As Data** to retrieve results from your run's dataset.
+
+![Using Apify data calls](../images/bubble/data_preview.png)
-Use Apify data sources to populate your Bubble app with Actor information and results:
-
-1. Use data calls like "List User Tasks", "List Actor Runs", or "List Store Actors" as data sources for repeating groups
-2. Configure the specific Actor or task you want to display
-3. Use "Fetch Data From Dataset Json As Data" to show actual scraped results from your Actor runs
-
-![Using Apify data calls](../images/bubble/data_preview.png)
+Populate elements in your Bubble application with information from your Apify account or Actor run data. Apply data sources like **List User Tasks**, **List Actor Runs**, or **List Store Actors** to repeating groups. To show actual scraped data, use **Fetch Data From Dataset Json As Data** to retrieve results from your run's dataset.
+
+![Using Apify data calls](../images/bubble/data_preview.png)
+
+### Automate data collection workflows
+
+Set up recurring data collection that updates your Bubble app automatically:
+
+1. Create a scheduled workflow or API workflow
+2. Use the "Run Actor Task" action to collect fresh data
+3. Process and store the results in your Bubble database
+4. Update your app's display elements with new data
-### Automate data collection workflows
-
-Set up recurring data collection that updates your Bubble app automatically:
-
-1. Create a scheduled workflow or API workflow
-2. Use the "Run Actor Task" action to collect fresh data
-3. Process and store the results in your Bubble database
-4. Update your app's display elements with new data
+### Automate data collection workflows
+
+Maintain fresh data in your Bubble app by setting up recurring workflows. Create a backend workflow with a schedule, such as daily runs. Incorporate the **Run Actor Task** action to trigger a pre-configured Actor for data collection. Follow this with steps to process the results, save them to your Bubble database, and update your app's display elements automatically.
-### Automate data collection workflows
-
-Set up recurring data collection that updates your Bubble app automatically:
-
-1. Create a scheduled workflow or API workflow
-2. Use the "Run Actor Task" action to collect fresh data
-3. Process and store the results in your Bubble database
-4. Update your app's display elements with new data
+### Automate data collection workflows
+
+Maintain fresh data in your Bubble app by setting up recurring workflows. Create a backend workflow with a schedule, such as daily runs. Incorporate the **Run Actor Task** action to trigger a pre-configured Actor for data collection. Follow this with steps to process the results, save them to your Bubble database, and update your app's display elements automatically.
+
+![Using Apify Actions calls](../images/bubble/automate_data_workflow.png)
+
+## Step 4: Example use cases
-## Step 4: Example use cases
+## Example use cases
-## Step 4: Example use cases
+## Example use cases
+
+### E-commerce price monitoring
+
+1. Set up a workflow that triggers daily or weekly
+2. Use the "Run Actor" action to scrape competitor prices
+3. Display the results in your Bubble app's dashboard
+4. Set up notifications when prices change significantly
-### E-commerce price monitoring
-
-1. Set up a workflow that triggers daily or weekly
-2. Use the "Run Actor" action to scrape competitor prices
-3. Display the results in your Bubble app's dashboard
-4. Set up notifications when prices change significantly
+### E-commerce price monitoring
+
+Schedule a daily workflow to run a price-scraping Actor on competitor sites. Store the results in your Bubble database, display them in a dashboard, and set up alerts for significant price changes.
-### E-commerce price monitoring
-
-1. Set up a workflow that triggers daily or weekly
-2. Use the "Run Actor" action to scrape competitor prices
-3. Display the results in your Bubble app's dashboard
-4. Set up notifications when prices change significantly
+### E-commerce price monitoring
+
+Schedule a daily workflow to run a price-scraping Actor on competitor sites. Store the results in your Bubble database, display them in a dashboard, and set up alerts for significant price changes.
+
+### Lead generation automation
+
+1. Create a form submission workflow
+2. Use scraped data to enrich lead information automatically
+3. Store enriched data in your Bubble database
+4. Trigger follow-up actions based on the enriched data
-### Lead generation automation
-
-1. Create a form submission workflow
-2. Use scraped data to enrich lead information automatically
-3. Store enriched data in your Bubble database
-4. Trigger follow-up actions based on the enriched data
+### Lead generation automation
+
+Trigger a workflow on form submission to run an Actor that enriches lead data, such as pulling company details from a domain. Save the enriched information to your database and automate follow-up actions like email campaigns.
-### Lead generation automation
-
-1. Create a form submission workflow
-2. Use scraped data to enrich lead information automatically
-3. Store enriched data in your Bubble database
-4. Trigger follow-up actions based on the enriched data
+### Lead generation automation
+
+Trigger a workflow on form submission to run an Actor that enriches lead data, such as pulling company details from a domain. Save the enriched information to your database and automate follow-up actions like email campaigns.
+
+### Content aggregation
+
+1. Schedule regular Actor runs to collect content from multiple sources
+2. Use "Fetch Data From Dataset Json As Data" to display aggregated content
+3. Create filtered views based on content categories or dates
-### Content aggregation
-
-1. Schedule regular Actor runs to collect content from multiple sources
-2. Use "Fetch Data From Dataset Json As Data" to display aggregated content
-3. Create filtered views based on content categories or dates
+### Content aggregation
+
+Configure regular Actor runs to gather articles or posts from multiple sources. Use the **Get Dataset Items** data call to display the content in your app, and enable user filters by category, date, or source.
-### Content aggregation
-
-1. Schedule regular Actor runs to collect content from multiple sources
-2. Use "Fetch Data From Dataset Json As Data" to display aggregated content
-3. Create filtered views based on content categories or dates
+### Content aggregation
+
+Configure regular Actor runs to gather articles or posts from multiple sources. Use the **Get Dataset Items** data call to display the content in your app, and enable user filters by category, date, or source.
+
+## Available Apify actions and data sources
+
+The Apify plugin provides two main types of operations:
+
+**Actions** (for workflows):
+- Run Actor
+- Run Actor Task
+- Scrape Single URL
+- Manage webhooks and data stores
+
+**Data Sources** (for displaying information):
+- Fetch data from datasets in various formats
+- List Actors, tasks, and runs
+- Access key-value store records
+
+## Troubleshooting
+
-## Troubleshooting
+## Troubleshooting
+<!-- markdownlint-disable MD001 -->
-## Troubleshooting
+## Troubleshooting
+<!-- markdownlint-disable MD001 -->
+- **Authentication errors**: Ensure your API token is in the format "Bearer <api_token>" and has necessary permissions
+- **Missing Actors or tasks**: Run your Actor at least once in the Apify Console to make it appear in Bubble dropdowns
+- **Timeout errors**: For long-running Actors, consider using asynchronous runs
+- **Data format issues**: Ensure JSON data is properly formatted when working with datasets
- **Authentication errors**: Ensure your API token is in the format "Bearer <api_token>" and has necessary permissions
- **Missing Actors or tasks**: Run your Actor at least once in the Apify Console to make it appear in Bubble dropdowns
- **Timeout errors**: For long-running Actors, consider using asynchronous runs
- **Data format issues**: Ensure JSON data is properly formatted when working with datasets
+#### Authentication errors
+
+Ensure your API token is correctly formatted as `Bearer <your_api_token>` in the Authorization header and has the necessary permissions.
+
+####Missing Actors or tasks 
+
+If an Actor or task doesn't appear in a dropdown, make sure you have run it at least once from the Apify Console.
+
+####Timeout errors
+
+Bubble workflows have a timeout limit. For long-running Actors, use the **Run Actor** action and a separate backend workflow triggered by a webhook to process the results asynchronously when the Actor finishes.
+
+####Data format issues
+
+Check that your JSON input is correctly formatted when providing input to an Actor. Verify the structure of the dataset output when displaying it in your app.
+
- **Authentication errors**: Ensure your API token is in the format "Bearer <api_token>" and has necessary permissions
- **Missing Actors or tasks**: Run your Actor at least once in the Apify Console to make it appear in Bubble dropdowns
- **Timeout errors**: For long-running Actors, consider using asynchronous runs
- **Data format issues**: Ensure JSON data is properly formatted when working with datasets
+#### Authentication errors
+
+Ensure your API token is correctly formatted as `Bearer <your_api_token>` in the Authorization header and has the necessary permissions.
+
+####Missing Actors or tasks 
+
+If an Actor or task doesn't appear in a dropdown, make sure you have run it at least once from the Apify Console.
+
+####Timeout errors
+
+Bubble workflows have a timeout limit. For long-running Actors, use the **Run Actor** action and a separate backend workflow triggered by a webhook to process the results asynchronously when the Actor finishes.
+
+####Data format issues
+
+Check that your JSON input is correctly formatted when providing input to an Actor. Verify the structure of the dataset output when displaying it in your app.
+
+
+If you have any questions or need help, feel free to reach out to us on our [Discord channel](https://discord.com/invite/jyEM2PRvMU).