AIRTOP n8n INTEGRATION: AUTOMATE AIRTOP WITH N8N

This action initiates a new browser window within an existing Airtop session, allowing you to open specific URLs and begin automated browsing tasks. It's the foundational action for any workflow that needs to interact with web content.

Key parameters: Session ID (required expression field referencing the session ID from a previous "Create Session" action), URL (required text field specifying the webpage to load), Get Live View (optional toggle to enable real-time visual monitoring), and Additional Fields for extra configuration options.

Use cases: Open a target website at the start of a scraping workflow, launch multiple browser windows in parallel for comparison tasks, navigate to login pages before filling authentication forms.

This action terminates a specific browser window within your Airtop session, freeing up resources and cleanly closing tabs you no longer need. Proper window management prevents resource leaks in long-running automation workflows.

Key parameters: Session ID (required JSON expression identifying the parent session containing the window), Window ID (required JSON expression specifying exactly which window to close).

Use cases: Close windows after completing data extraction from each page, clean up temporary windows opened during multi-step processes, terminate windows that encounter errors to prevent workflow hangs.

This action retrieves a live visual feed of the specified browser window, enabling real-time monitoring of automated browser activities. It's particularly valuable for debugging and verifying that automations interact with pages correctly.

Key parameters: Session ID (required expression field for the active session identifier), Window ID (required expression field specifying which window to observe), Additional Fields (optional section for extra configuration parameters).

Use cases: Debug complex form-filling workflows by watching the browser in real-time, monitor long-running scraping jobs to ensure pages load correctly, create visual documentation of automated processes for stakeholders.

This action navigates an existing browser window to a new URL, enabling multi-page workflows without creating additional windows. Use this when you need to visit multiple pages sequentially within the same browser context.

Key parameters: Session ID (required JSON expression referencing the current session), Window ID (required JSON expression identifying the target window), URL (required text field with the destination URL, can be a fixed value or dynamic expression).

Use cases: Navigate through pagination by loading sequential page URLs, follow links discovered during scraping to gather deeper data, move between dashboard sections in authenticated web applications.

This action captures a visual snapshot of the current browser window state, saving it as an image for documentation, testing, or visual verification purposes. Screenshots can be output as binary data for further processing or storage.

Key parameters: Session ID (required JSON path input referencing the active session), Window ID (required JSON path input specifying which window to capture), Output Binary Image (optional toggle determining whether the screenshot returns as binary data).

Use cases: Capture visual evidence of completed form submissions, create before/after screenshots for website change monitoring, document error states when workflows encounter unexpected pages.

This action retrieves all open browser windows within a specified session, returning their IDs and metadata. Use this to dynamically manage multiple windows or verify which windows are currently active.

Key parameters: Session ID (required expression input identifying which session to query for open windows).

Use cases: Inventory all open windows before performing cleanup operations, dynamically route workflow logic based on how many windows exist, verify window creation was successful before proceeding with interactions.

This action completely ends an Airtop browser session, closing all associated windows and releasing all resources. Always terminate sessions when your workflow completes to avoid unnecessary resource consumption.

Key parameters: Session ID (required JSON expression input specifying which session to terminate, accepts dynamic values from previous workflow steps).

Use cases: Clean up resources at the end of every scraping workflow, force-terminate sessions that have exceeded time limits, end sessions after errors to ensure clean state for retry attempts.

This action preserves browser profile data (cookies, localStorage, cache) when a session ends, allowing subsequent sessions to restore this state. Essential for maintaining logged-in states across automation runs.

Key parameters: Session ID (required expression field for the session whose profile to save), Profile Name (required text field specifying a name for the saved profile, e.g., "logged-in-linkedin").

Use cases: Preserve authentication cookies after logging into protected sites, maintain shopping cart state across multiple automation sessions, save browser preferences and settings for consistent automation environments.

This action initiates a new Airtop browser session with configurable settings for profile management, recording, timeouts, and proxy configuration. It's the essential first step for any workflow that needs to interact with web content.

Key parameters: Profile Name (optional text field to load a previously saved browser profile), Save Profile (optional toggle to automatically save the profile when the session terminates), Record Session (optional toggle enabling session recording), Idle Timeout (required numeric field, default: 10 seconds), Proxy (optional dropdown to select proxy configuration), Additional Fields (expandable section for advanced configuration).

Use cases: Start fresh browser sessions for each scraping job, create sessions with saved profiles to bypass login flows, configure proxy-enabled sessions for geo-specific data collection.

This action pauses workflow execution until a file download completes within the session, ensuring downstream actions can process the downloaded file. Critical for workflows that download documents, reports, or data exports.

Key parameters: Session ID (required expression input referencing the session where the download is occurring), Additional Fields (optional section for timeout configuration and other settings).

Use cases: Wait for PDF report generation before processing the file, pause until CSV exports complete before sending to data pipelines, ensure downloaded files are fully written before moving to storage.

This action enters text into focused input fields within the browser window, simulating keyboard input. Use this for filling form fields, search boxes, and any text entry interactions.

Key parameters: Session ID (required expression input for the active session), Window ID (required expression input identifying the target window), Text (text input field containing the content to type), Element Description (optional field to describe which element should receive the text), Additional Fields (section for additional configuration like typing speed).

Use cases: Enter search queries into website search boxes, fill username and password fields during authentication, input data into multi-field forms across web applications.

This action populates multiple form fields simultaneously using structured data, streamlining complex form submissions. More efficient than individual type actions when dealing with multi-field forms.

Key parameters: Session ID (required expression field referencing the current session), Window ID (required expression field for the target window), Form Data (required flexible input field accepting structured data that maps field identifiers to values, can use expressions for dynamic data).

Use cases: Complete contact forms with lead information from your CRM, fill application forms with candidate data from your ATS, submit order forms with product and customer details automatically.

This action simulates mouse clicks on specified page elements, enabling navigation, button presses, and interactive element triggering. The AI interprets element descriptions to identify click targets.

Key parameters: Session ID (required expression input for session identification), Window ID (required expression input specifying the browser window), Element Description (optional text field describing the element to click, e.g., "the blue Submit button"), Additional Fields (section for click modifiers and additional options).

Use cases: Click "Next" buttons to navigate through multi-page forms, press login buttons after filling authentication credentials, trigger dropdown menus and interactive UI components.

This action scrolls the browser window viewport, enabling access to content below the fold or navigating infinite-scroll pages. Supports automatic and manual scroll modes for different use cases.

Key parameters: Session ID (required expression field for the active session), Window ID (required expression field identifying which window to scroll), Scroll Mode (required dropdown with options like "Automatic"), Element Description (optional expression field to describe a target element to scroll toward), Additional Fields (expandable section for scroll distance and timing configuration).

Use cases: Scroll to load all items on infinite-scroll product listings, navigate to specific page sections before capturing screenshots, ensure dynamically-loaded content appears before extraction.

This action moves the mouse cursor over a specified element, triggering hover states, tooltips, and dropdown menus that require mouse-over interactions. Essential for scraping data hidden behind hover interactions.

Key parameters: Session ID (required expression input identifying the browser session), Window ID (required expression input for the target window), Element Description (optional expression input describing which element to hover over, enabling AI-powered element identification).

Use cases: Trigger hover-revealed content before data extraction, expand navigation menus that appear on mouse-over, activate tooltip information for comprehensive data capture.

This action removes files from your Airtop account storage, cleaning up temporary files or removing outdated downloads. Proper file management prevents storage bloat in automated systems.

Key parameters: File ID (required text input accepting the unique identifier of the file to delete, can be a fixed value or expression referencing file IDs from previous actions).

Use cases: Clean up temporary screenshots after processing completes, remove downloaded files after they've been transferred to final storage, delete sensitive documents after extraction and secure transmission.

This action retrieves and loads a file into the browser context for processing or interaction. Use this when your automation needs to work with files stored in your Airtop account.

Key parameters: Session ID (required JSON expression input for session context), Window ID (required JSON expression input for window targeting), File ID (optional JSON expression input specifying which file to load), Include Hidden Elements (optional toggle to include hidden page elements in the loaded context).

Use cases: Load previously downloaded documents for further processing, retrieve stored configuration files for automation setup, access saved templates for form-filling operations.

This action uploads files to your Airtop session or storage, supporting both URL-based and local file sources. Essential for workflows that need to submit documents through web forms.

Key parameters: Session ID (required expression input for session identification), Window ID (required expression input for window targeting), File Name (optional text field to specify the uploaded file's name), File Type (required dropdown selection, e.g., "Customer Upload"), Source (required dropdown defining the file source type, e.g., "URL"), URL (required text field specifying the source URL when uploading from a web location).

Use cases: Upload documents to web forms requiring file attachments, transfer screenshots or exports to file sharing platforms, submit generated reports to client portals automatically.

This action retrieves a specific file from your Airtop storage by its ID, with options to return the file as binary data for further workflow processing.

Key parameters: File ID (required text input specifying the unique identifier of the file to retrieve, accepts both fixed values and expressions), Output Binary File (optional toggle to return the file as binary data, enabling direct use in email attachments or file storage actions).

Use cases: Retrieve captured screenshots for inclusion in notification emails, download extracted documents for processing in other applications, access stored files for comparison or verification operations.

This action retrieves multiple files from your Airtop storage in a single operation, supporting batch processing workflows with optional filtering by session.

Key parameters: Return All (optional toggle to retrieve all available files without pagination limits), Limit (optional numeric field setting the maximum number of files to return in one operation), Session IDs (optional text field accepting comma-separated session IDs to filter files by source session), Output Files in Single Item (optional toggle to consolidate all retrieved files into a single workflow item).

Use cases: Batch download all screenshots from a testing session, retrieve all documents extracted during a scraping job, gather files from multiple sessions for consolidated processing.

This action extracts structured data from web pages using AI-powered queries with support for paginated content. It's designed for intelligent data extraction that can handle multi-page result sets automatically.

Key parameters: Session Mode (required dropdown to use existing session or create new one), Session ID (required text input for session identification), Window ID (required text input specifying the target window), Prompt (optional text field providing extraction instructions for the AI), Additional Fields (expandable section for pagination settings and extraction configuration).

Use cases: Extract product listings that span multiple pages automatically, scrape search results with intelligent pagination handling, gather structured data from tables with varying page counts.

This action performs intelligent, AI-powered web scraping that automatically identifies and extracts relevant content from pages without requiring explicit selectors or schemas.

Key parameters: Session Mode (required dropdown selecting session handling approach), Session ID (required JSON expression input for session context), Window ID (required JSON expression input for window targeting).

Use cases: Extract article content from news websites without predefined selectors, scrape product details from e-commerce sites with varying layouts, gather profile information from professional networking platforms.

This action performs targeted data extraction from a page using AI-powered prompts, enabling natural language instructions for what data to extract.

Key parameters: Session Mode (required dropdown for session handling configuration), Session ID (required JSON reference input for active session), Window ID (required JSON reference input for target window), Prompt (optional text input providing extraction instructions to guide the AI), Additional Fields (section for schema definitions and output formatting options).

Use cases: Extract specific data points using natural language descriptions, pull structured information from complex page layouts, gather targeted content without writing CSS selectors or XPath.

This action executes an AI agent within your Airtop session, enabling complex, multi-step automated interactions that adapt to page content dynamically.

Key parameters: Webhook URL (optional text field for receiving completion notifications via callback), Parameters (flexible text field for passing configuration and instructions to the agent), Await Agent (optional toggle to wait for agent completion before proceeding, defaults to off for async execution), Timeout (required numeric field, default: 600 seconds, setting maximum agent execution duration).

Use cases: Deploy AI agents to navigate complex multi-step workflows autonomously, run agents that adapt to dynamic page content and changing layouts, execute sophisticated automation tasks requiring decision-making capabilities.