docs: prepare docs for gumloop addition

.github/styles/config/vocabularies/Docs/accept.txt

@@ -83,6 +83,7 @@ preconfigured
 [Zz]apier
 [Tt]rello
 [Pp]refill
+[Gg]umloop
 
 [Mm]ultiselect
 

sources/platform/integrations/workflows-and-notifications/gmail.md

@@ -2,7 +2,7 @@
 title: Gmail integration
 description: Learn how to integrate Apify with Gmail
 sidebar_label: Gmail
-sidebar_position: 5
+sidebar_position: 6
 slug: /integrations/gmail
 ---
 

sources/platform/integrations/workflows-and-notifications/gumloop/index.md

@@ -0,0 +1,110 @@
+---
+title: Gumloop integration
+description: Learn how to integrate your Apify Actors with Gumloop.
+sidebar_label: Gumloop
+sidebar_position: 3
+slug: /integrations/gumloop
+---
+
+With the Gumloop Apify integration you can retrieve key data for your AI-powered workflows in a flash.
+
+Gumloop supports two types of integrations with Apify:
+
+- Direct integrations with Apify Actors through MCP nodes, where you can prompt the data you need (Recommended)
+- General Apify integration using the Apify task runner node
+
+## Direct integrations with Apify Actors (recommended)
+
+Gumloop offers native nodes for popular Apify use cases that provide enhanced functionality and easier configuration.
+
+These native nodes eliminate the complexity of managing Apify tasks while providing more powerful features for specific platforms. They are pre-configured with no need to manage Apify tasks or API keys, enhanced features like built-in data validation and formatting, better performance optimized for Gumloop, and full customizability using a prompt.
+
+The following data sources are available natively in Gumloop:
+
+- [Instagram](/platform/integrations/gumloop/instagram)
+- [Google Maps](/platform/integrations/gumloop/maps)
+- [TikTok](/platform/integrations/gumloop/tiktok)
+- [YouTube](/platform/integrations/gumloop/youtube)
+
+### Gumloop credits
+
+Retrieving data from Apify Actors is included in your Gumloop subscription. Apify Actors natively integrated into Gumloop (YouTube, TikTok, Google Maps, Instagram) have a list of tools (data points) you can retrieve.
+
+Each tool has a corresponding Gumloop credit cost. Each Gumloop subscription comes with a set of credits.
+
+| Sample prompt | Tool | Credit cost per use |
+| :--- | :--- | :--- |
+| Retrieve profile details for an Instagram user | Get Profile Details | 5 credits/profile |
+| Get videos for a specific hashtag | Get Hashtag Videos | 3 credits/video |
+| Show 5 most recent reviews for a restaurant | Get Place Reviews | 3 credits/review |
+
+## General integration (Apify Task Runner)
+
+Gumloop's Apify task runner lets you run your Apify tasks directly inside Gumloop workflows. Scrape data with Apify, then process it with AI, send results via email, update spreadsheets, or connect to any of Gumloop's 100+ integrations.
+
+Build workflows that automatically collect data from websites and deliver insights to your team through Slack, Gmail, Google Sheets, or wherever you need them.
+
+### Connect Apify with Gumloop
+
+To use the Apify integration in Gumloop, you need an Apify account, a Gumloop account, and at least one Apify task that has been run previously.
+
+1. _Get your Apify API Key_
+
+    To get started, navigate to [**Settings > Integrations**](https://console.apify.com/settings/integrations) in Apify Console and copy your API token.
+
+    ![Apify Settings > Integrations with API token](images/generate_apify_token.png)
+
+1. _Add Apify credentials to Gumloop_
+
+    Next, go to [**Gumloop Credentials**](https://www.gumloop.com/settings/profile/credentials) and click **Add New Credentials**. Search for Apify in the credentials list, add your Apify API key, and save the credential.
+
+    ![Gumloop Credentials adding Apify API key](images/apify_credential_gumloop.png)
+
+1. _Add Apify Task Runner node to your workflow_
+
+   Open a new Gumloop pipeline page. Search for **Apify Task Runner** in the **Node Library**, and drag and drop the node onto your canvas.
+
+    ![Apify Task Runner in Node Library](images/apify_task_runner_node_library.png)
+
+1. _Create and save tasks in Apify_
+
+   The Apify Task Runner node fetches tasks from your saved tasks in Apify Console. To create a task, navigate to [**Actors**](https://console.apify.com/actors), click on the Actor you want to use, and then click **Create a task** next to the Run button. Configure your task settings and save.
+
+    ![Create a task on an Actor](images/create_apify_task.png)
+
+    :::important
+
+    The Task Runner only displays tasks that have been saved in your Apify Console, not individual Actors.
+
+    :::
+
+1. _Run your tasks_
+
+    Before tasks appear in Gumloop, they must be executed at least once in Apify. Go to your [**Saved tasks**](https://console.apify.com/actors/tasks), click on the task you want to use, and click **Start** to execute it. Wait for the task to complete.
+
+    This step is required because Gumloop needs to understand the output structure of your task to properly configure data fields.
+
+    ![Saved tasks with Start](images/start_apify_task.png)
+
+1. _Configure your Gumloop workflow_
+
+    Configure maximum run time and output limits. Select your task from the dropdown menu. Choose the output fields you want to use. Connect the node to other workflow components.
+
+    ![Apify Task Runner node configuration](images/apify_task_runner_node.png)
+
+## Example workflow
+
+Here's a simple example of how to use Apify with Gumloop:
+
+Web Scraping \+ AI Analysis \+ Email Report
+
+```mermaid
+
+graph LR
+    A[Apify Task Runner] --> B[Ask AI] --> C[Combine text] --> D[Gmail sender]
+
+```
+
+The Apify task runner scrapes product prices from an e-commerce site. Ask AI analyzes price trends and identifies opportunities. Combine text formats the analysis into a readable report. Gmail Sender emails the report to stakeholders.
+
+This workflow runs automatically and delivers actionable insights directly to your inbox.

sources/platform/integrations/workflows-and-notifications/gumloop/instagram.md

@@ -0,0 +1,75 @@
+---
+title: Gumloop - Instagram Actor integration
+description: Learn about Instagram scraper modules. Extract posts, comments, and profile data.
+sidebar_label: Instagram
+sidebar_position: 1
+slug: /integrations/gumloop/instagram
+---
+
+Get Instagram profile posts, details, stories, reels, post comments and hashtags, users, and tagged posts in Gumloop.
+
+---
+
+The Gumloop integration for Instagram provides a direct interface for running Apify’s Instagram scrapers directly in your workflows. No API tokens or manual polling required. All you need is a Gumloop account.
+
+Using the Gumloop Instagram MCP node, you can prompt the Instagram data you need and Gumloop will retrieve it from relevant Apify Actors. From there you can connect this data to other tools and AI models to process the information.
+
+## Available actions
+
+You can pull the following types of data from public Instagram accounts using Gumloop’s Instagram node (via Apify). Each action has a credit cost.
+
+| Tool/Action | Description | Credit Cost |
+| :---- | :---- | :---- |
+| Get profile posts | Fetch posts from a public Instagram profile, including captions, images, like and comment counts, and metadata. | 3 credits per item |
+| Get post comments | Retrieve all comments on a specific post, with author info, timestamps, and like counts. | 3 credits per item |
+| Get hashtag posts | Search by hashtag and return matching posts with full details. | 3 credits per item |
+| Find users | Look up Instagram users by name or handle and return profile metadata like bio, follower/following counts, etc. | 3 credits per item |
+| Get profile details | Extract detailed metadata from a profile, including follower count, bio, and verification status. | 5 credits per item |
+| Get profile stories | Get media URLs, timestamps, and view counts from an Instagram profile’s stories. | 3 credits per item |
+| Get profile reels | Fetch reels with captions, engagement metrics, play counts, and music info. | 3 credits per item |
+| Get tagged posts | Return posts where a specific user is tagged, with full post details. | 3 credits per item |
+
+## Retrieve Instagram data in Gumloop
+
+1. _Add the Gumloop Instagram MCP node_
+
+    First, add the Instagram node from the node library to your workflow canvas.
+
+    ![Instagram MCP node on canvas](images/instagram/mcp-node-image.jpeg)
+
+1. _Prompt the data you need._
+
+    In the node's configuration panel, write a clear, specific prompt that describes the data you want to retrieve.
+
+    ![Instagram node prompt field](images/instagram/prompt.jpeg)
+
+    :::tip Prompting tips
+
+    - MCP nodes only have access to the tools listed so your prompt should be scoped to Instagram.
+    - You can mix and match different tools (get 10 latest videos for a hashtag and retrieve profile data for each post).
+
+    :::
+
+1. _Define the inputs and outputs_
+
+    Once you’ve entered your prompt, you will go through the AI assisted node creation process starting with defining inputs, parameters and outputs of your Instagram node.
+
+    Gummie (Gumloop’s AI assistant) will suggest inputs (information coming from previous steps, ie hashtag to scrape), parameters (user defined choices, ie number of posts to retrieve) and outputs (information used in future steps, ie number of followers of users and list of recent videos).
+
+    ![Suggested inputs, parameters, outputs](images/instagram/input-outputs.jpeg)
+
+1. _Generate and test the node_
+
+    With inputs, parameters and outputs defined, Gummie will generate the code to retrieve the data from the Apify Instagram node. There is no requirement for you to review or understand the code, Gummie takes care of it.
+
+    After the code is written, enter test values to confirm the outputs of the node and save.
+
+    Once saved, you can access this node in any of your flows.
+
+    ![Instagram node with test values and outputs](images/instagram/node.jpeg)
+
+## Other integrations
+
+- [TikTok](/platform/integrations/gumloop/tiktok)
+- [YouTube](/platform/integrations/gumloop/youtube)
+- [Google Maps](/platform/integrations/gumloop/maps)

sources/platform/integrations/workflows-and-notifications/gumloop/maps.md

@@ -0,0 +1,73 @@
+---
+title: Gumloop - Google maps Actor integration
+description: Learn about Google Maps scraper modules. Extract place details, reviews, and search results.
+sidebar_label: Google Maps
+sidebar_position: 2
+slug: /integrations/gumloop/maps
+---
+
+Search, extract, and enrich business data from Google Maps in Gumloop.
+
+---
+
+The Gumloop Google Maps integration provides a native interface for running Apify’s Google Maps scrapers directly in your workflows. No API keys or manual polling required. All you need is a Gumloop account.
+
+Using the Gumloop Google Maps MCP node, you can simply prompt the location data you need and Gumloop will retrieve it from relevant Apify actors. From there, you can connect it to your favorite tools and AI agents to process the information.
+
+## Available actions
+
+You can pull the following types of place data from Google Maps using Gumloop’s Google Maps node (via Apify). Each action has a credit cost.
+
+| Tool/Action | Description | Credit Cost |
+| :---- | :---- | :---- |
+| Search places | Search for places on Google Maps using location and search terms. | 3 credits per item |
+| Get place details | Retrieve detailed information about a specific place using its URL or place ID. | 5 credits per item |
+| Search by category | Search for places by a specific category (e.g. cafes, gyms) on Google Maps. | 3 credits per item |
+| Get place reviews | Fetch reviews for specific locations, including text, rating, and reviewer info. | 3 credits per item |
+| Find places in area | Return all visible places within a defined map area or bounding box. | 3 credits per item |
+
+
+## Retrieve Google Maps data in Gumloop
+
+1. _Add the Gumloop Google Maps MCP node._
+
+    First, add the Google Maps node from the node library to your workflow canvas.
+
+    ![Google Maps MCP node in Node Library](images/maps/mcp-node-image.jpeg)
+
+1. _Prompt the data you need_
+
+    In the node's configuration panel, write a clear, specific prompt that describes the data you want to retrieve.
+
+    ![Google Maps node prompt field](images/maps/prompt.jpeg)
+
+    :::tip Prompting tips
+
+    - MCP nodes only have access to the tools listed so your prompt should be scoped to Google Maps.
+    - You can mix and match different tools (e.g., search for gyms in Vancouver → get place details → pull reviews).
+
+    :::
+
+1. _Define inputs/outputs_
+
+    Once you’ve entered your prompt, you will go through the AI assisted node creation process starting with defining inputs, parameters and outputs of your Google Maps node.
+
+    Gummie (Gumloop’s AI assistant) will suggest inputs (information coming from previous steps, ie location, keyword, category), parameters (user defined choices, ie number of results or radius) and outputs (information used in future steps, ie business name, review count, ratings).
+
+    ![Suggested inputs, parameters, outputs](images/maps/input-outputs.jpeg)
+
+1. _Generate and test the node_
+
+    With inputs, parameters and outputs defined, Gummie will generate the code to retrieve the data from the Apify Google Maps node. There is no requirement for you to review or understand the code, Gummie takes care of it.
+
+    After the code is written, enter test values to confirm the outputs of the node and save.
+
+    Once saved, you can access this node in any of your flows.
+
+    ![Google Maps node with test values and outputs](images/maps/node.jpeg)
+
+## Other integrations
+
+- [TikTok](/platform/integrations/gumloop/tiktok)
+- [Instagram](/platform/integrations/gumloop/instagram)
+- [YouTube](/platform/integrations/gumloop/youtube)

sources/platform/integrations/workflows-and-notifications/gumloop/tiktok.md

@@ -0,0 +1,71 @@
+---
+title: Gumloop - TikTok Actor integration
+description: Learn about TikTok scraper modules. Extract videos, profile data, followers, and hashtag data.
+sidebar_label: TikTok
+sidebar_position: 3
+slug: /integrations/gumloop/tiktok
+---
+
+Get TikTok hashtag videos, profile videos, followers, video details, and search results in Gumloop.
+
+---
+
+The Gumloop TikTok integration provides a native interface for running Apify’s TikTok scrapers directly in your workflows. No API tokens or manual polling required. All you need is a Gumloop account.
+Using the Gumloop TikTok MCP node, you can simply prompt the TikTok data you need and Gumloop will retrieve it from relevant Apify actors. From there, you can connect it to your favorite tools and AI agents to process the information.
+
+## Available actions
+
+You can pull the following types of data from TikTok using Gumloop’s TikTok node (via Apify). Each action has a credits cost.
+
+| Tool/Action | Description | Credit Cost |
+| :---- | :---- | :---- |
+| Get hashtag videos | Fetch videos from TikTok hashtags with captions, engagement metrics, play counts, and author information. | 3 credits per item |
+| Get profile videos | Get videos from TikTok user profiles with video metadata, engagement stats, music info, and timestamps. | 3 credits per item |
+| Get profile followers | Retrieve followers or following lists from TikTok profiles, including usernames, follower counts, and bios. | 3 credits per item |
+| Get video details | Get comprehensive data on a specific TikTok video using its URL—includes engagement and video-level metrics. | 5 credits per item |
+| Search videos | Search TikTok for videos and users using queries. Returns video details and user profile info. | 3 credits per item |
+
+## Retrieve Tiktok Data in Gumloop
+
+1. _Add the Gumloop TikTok MCP node_
+
+    First, add the TikTok node from the node library to your workflow canvas.
+
+    ![TikTok MCP node on canvas](images/tiktok/mcp-node-image.jpeg)
+
+1. _Prompt the data you need_
+
+    In the node's configuration panel, write a clear, specific prompt that describes the data you want to retrieve.
+
+    ![TikTok node prompt field](images/tiktok/prompt.jpeg)
+
+    :::tip Prompting tips
+
+    - MCP nodes only have access to the tools listed so your prompt should be scoped to TikTok.
+    - You can mix and match different tools (e.g., search a hashtag → get profile videos → retrieve engagement data).
+
+    :::
+
+1. _Define inputs/outputs_
+
+    Once you’ve entered your prompt, you will go through the AI assisted node creation process starting with defining inputs, parameters and outputs of your TikTok node.
+
+    Gummie (Gumloop’s AI assistant) will suggest inputs (information coming from previous steps, ie search keyword, video URL), parameters (user defined choices, number of videos to retrieve) and outputs (information used in future steps, ie follower count, video engagement, music info).
+
+    ![Suggested inputs, parameters, outputs](images/tiktok/input-output.jpeg)
+
+1. _Generate and test the node_
+
+    With inputs, parameters and outputs defined, Gummie will generate the code to retrieve the data from the Apify TikTok node. There is no requirement for you to review or understand the code, Gummie takes care of it.
+
+    After the code is written, enter test values to confirm the outputs of the node and save.
+
+    Once saved, you can access this node in any of your flows.
+
+    ![TikTok node with test values and outputs](images/tiktok/node.jpeg)
+
+## Other integrations
+
+- [Instagram](/platform/integrations/gumloop/instagram)
+- [YouTube](/platform/integrations/gumloop/youtube)
+- [Google Maps](/platform/integrations/gumloop/maps)