> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Airtop

> Airtop provides cloud browsers and AI-powered web automation for navigating sites, interacting with pages, extracting data, and running reusable browser workflows.

![Airtop logo](https://mintcdn.com/composio-preview/qzegrvAapILigeDI/images/toolkits/airtop.svg?fit=max\&auto=format\&n=qzegrvAapILigeDI\&q=85\&s=6c86243498c7049c6d3055a0b1c043d3)

* **Category:** web scraping & browser
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 10
* **Triggers:** 0
* **Slug:** `AIRTOP`
* **Version:** 20261101\_00

## Tools

> [accordion] Click Element
>
> **Slug:** `AIRTOP_CLICK_ELEMENT`
>
> Use Airtop AI to locate and click an element from a natural-language description, consuming credits and potentially triggering irreversible external effects such as submitting a form or placing an order. Successful and partial responses include status, credit usage, warnings, and errors; failures raise an error.
>
> #### Input Parameters
>
> **window\_id** `string` *required*
>
> Window containing the target element.
>
> **click\_type** `string ("click" | "doubleClick" | "rightClick")`
>
> Mouse click behavior: a left click, double click, or right click.
>
> **session\_id** `string` *required*
>
> Running session that owns the window.
>
> **client\_request\_id** `string`
>
> Optional caller correlation ID returned in Airtop response metadata.
>
> **element\_description** `string` *required*
>
> Specific natural-language description of the element to click.
>
> **wait\_for\_navigation** `boolean`
>
> Wait for navigation after clicking. Enable this for links and submit controls that change pages.
>
> **cost\_threshold\_credits** `integer`
>
> Credit threshold checked periodically by Airtop. This is not a hard cap; omit it to use Airtop's default. Setting 0 disables this protection and is not recommended.
>
> **time\_threshold\_seconds** `integer`
>
> Runtime threshold checked periodically by Airtop. This is not a hard deadline; omit it to use Airtop's default. Setting 0 disables this protection and is not recommended.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Close Window
>
> **Slug:** `AIRTOP_CLOSE_WINDOW`
>
> Close one browser window without terminating its Airtop session.
>
> #### Input Parameters
>
> **window\_id** `string` *required*
>
> Airtop window ID to close.
>
> **session\_id** `string` *required*
>
> Running session that owns the window.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Session
>
> **Slug:** `AIRTOP_CREATE_SESSION`
>
> Create an Airtop browser session and wait until it is running. Sessions are billed in 30-second increments, so terminate them promptly when work is complete.
>
> #### Input Parameters
>
> **proxy** `string`
>
> Optional Airtop integrated or custom proxy configuration. Use true for Airtop's default integrated proxy, a proxy string/object for one relay, or domain-specific proxy rules. Availability depends on the account plan.
>
> **record** `boolean`
>
> Whether to record the session; recording can be unavailable on free plans.
>
> **profile\_name** `string`
>
> Saved Airtop profile to load into the session.
>
> **extension\_ids** `array`
>
> Google Web Store extension IDs to load.
>
> **solve\_captcha** `boolean`
>
> Whether Airtop should automatically solve CAPTCHA challenges.
>
> **timeout\_minutes** `integer`
>
> Idle timeout in minutes before Airtop terminates the session.
>
> **readiness\_timeout\_seconds** `integer`
>
> Maximum wall-clock time to poll for running status before failing.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Window
>
> **Slug:** `AIRTOP_CREATE_WINDOW`
>
> Create a browser window in a running Airtop session and load an initial URL. If no URL is supplied, Airtop loads [https://www.google.com](https://www.google.com).
>
> #### Input Parameters
>
> **url** `string`
>
> Initial absolute URL to load. If omitted, Airtop loads [https://www.google.com](https://www.google.com).
>
> **session\_id** `string` *required*
>
> Running session that will own the window.
>
> **wait\_until** `string ("load" | "domContentLoaded" | "complete" | "noWait")`
>
> Page loading event to wait for before returning.
>
> **screen\_resolution** `string`
>
> Fixed live-view resolution in WIDTHxHEIGHT format.
>
> **wait\_until\_timeout\_seconds** `integer`
>
> Maximum wait for the selected loading event, in seconds. Reaching the timeout produces a warning rather than failing window creation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Sessions
>
> **Slug:** `AIRTOP_LIST_SESSIONS`
>
> List Airtop browser sessions, optionally filtering by IDs or status. Use this to discover sessions or check the current state of a known session.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of sessions to return in this page.
>
> **status** `string ("awaitingCapacity" | "initializing" | "running" | "ended" | "completed" | "cancelled" | "all")`
>
> Return only sessions with this status.
>
> **next\_cursor** `string`
>
> Continuation cursor from a previous response. Omit for the first page and pass it back unchanged to fetch the next page.
>
> **session\_ids** `string`
>
> Comma-separated session IDs to return. Omit to list sessions without an ID filter.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Windows
>
> **Slug:** `AIRTOP_LIST_WINDOWS`
>
> List all browser windows in a running Airtop session, including their IDs, current URLs, and titles when available.
>
> #### Input Parameters
>
> **session\_id** `string` *required*
>
> Running Airtop session whose browser windows to list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Navigate Window
>
> **Slug:** `AIRTOP_NAVIGATE_WINDOW`
>
> Navigate an existing Airtop browser window to a new URL and optionally wait for page loading.
>
> #### Input Parameters
>
> **url** `string` *required*
>
> Absolute URL to load.
>
> **window\_id** `string` *required*
>
> Airtop browser window to navigate.
>
> **session\_id** `string` *required*
>
> Running session that owns the window.
>
> **wait\_until** `string ("load" | "domContentLoaded" | "complete" | "noWait")`
>
> Page loading event to wait for before returning.
>
> **wait\_until\_timeout\_seconds** `integer`
>
> Maximum wait for the selected loading event, in seconds. Reaching the timeout can produce a warning rather than fail navigation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query Page
>
> **Slug:** `AIRTOP_QUERY_PAGE`
>
> Ask Airtop AI a question about a page or extract structured page content. This operation consumes Airtop credits; the response reports credits\_used, and cost/time thresholds cancel work after periodically checked thresholds are exceeded.
>
> #### Input Parameters
>
> **prompt** `string` *required*
>
> Question or extraction instruction for the current page. Include desired bounds and output details.
>
> **window\_id** `string` *required*
>
> Window whose current page to query.
>
> **session\_id** `string` *required*
>
> Running session that owns the window.
>
> **output\_schema** `object`
>
> Optional JSON Schema for structured model output. It is serialized into Airtop's configuration.outputSchema string.
>
> **client\_request\_id** `string`
>
> Optional caller correlation ID returned in response metadata.
>
> **cost\_threshold\_credits** `integer`
>
> Credit threshold checked periodically by Airtop. It is not a hard cap; omit it for Airtop's default. Setting 0 disables this protection and is not recommended.
>
> **time\_threshold\_seconds** `integer`
>
> Runtime threshold in seconds checked periodically by Airtop. It is not a hard deadline; omit it for Airtop's default. Setting 0 disables this protection and is not recommended.
>
> **follow\_pagination\_links** `boolean`
>
> Attempt pagination, load-more controls, or infinite scrolling. This can substantially increase cost and execution time; bound the work in the prompt and thresholds.
>
> **include\_visual\_analysis** `string ("auto" | "disabled" | "enabled")`
>
> Whether Airtop should add screenshot-based analysis. Enabling it can increase credit use and execution time.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Terminate Session
>
> **Slug:** `AIRTOP_TERMINATE_SESSION`
>
> Terminate an Airtop session and all of its windows. Use promptly after browser work to stop time-based session billing.
>
> #### Input Parameters
>
> **session\_id** `string` *required*
>
> Session ID to terminate.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Type Text
>
> **Slug:** `AIRTOP_TYPE_TEXT`
>
> Use Airtop AI to type text into an input, consuming credits; enabling Enter can submit forms or trigger external effects. Successful and partial responses include status, usage, warnings, and errors; failures raise an error.
>
> #### Input Parameters
>
> **text** `string` *required*
>
> Text to type into the target input.
>
> **window\_id** `string` *required*
>
> Window containing the target input.
>
> **session\_id** `string` *required*
>
> Running session that owns the window.
>
> **press\_tab\_key** `boolean`
>
> Press Tab after typing to move focus. If Enter is also enabled, Airtop presses Tab after Enter.
>
> **press\_enter\_key** `boolean`
>
> Press Enter after typing. This can submit a form or trigger another irreversible external action.
>
> **clear\_input\_field** `boolean`
>
> Clear an active HTML input before typing.
>
> **client\_request\_id** `string`
>
> Optional caller correlation ID returned in Airtop response metadata.
>
> **element\_description** `string`
>
> Natural-language description of the target input. Omit only when the intended field is already active and unambiguous.
>
> **wait\_for\_navigation** `boolean`
>
> Wait for navigation after typing or a configured key press.
>
> **cost\_threshold\_credits** `integer`
>
> Credit threshold checked periodically by Airtop. It is not a hard cap; omit it to use Airtop's default. Setting 0 disables this safeguard and is not recommended.
>
> **time\_threshold\_seconds** `integer`
>
> Runtime threshold in seconds checked periodically by Airtop. It is not a hard deadline; omit it to use Airtop's default. Setting 0 disables this safeguard and is not recommended.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
