> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.airtop.ai/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.airtop.ai/_mcp/server. # Changelog ## September 3, 2025 ## Recording a session Airtop supports recording browser sessions, automatically saving a separate video file for each window you open.\ For step-by-step instructions, see the [Recording a Session guide](/guides/how-to/recording-a-session). ## April 30, 2025 ## File Uploading We added a File Uploading feature which includes filling out file input elements. For more information, check out the [guide](/guides/how-to/downloading-and-uploading-files#uploading-files). ## April 22, 2025 ## Automatic Captcha Solving We added a new feature to automatically solve Captchas when they are encountered. For more information, check out the [guide](/guides/how-to/solving-captchas). ## April 15, 2025 ## n8n Integration We added a new integration with [n8n](https://www.n8n.io). Check out the [guide](/guides/integrations/n8n) to learn more. ## April 9, 2025 ## File Downloading We added a new API to download files from a session. Check out the [guide](/guides/how-to/downloading-and-uploading-files) to learn more. ## March 31, 2025 ## Form Filling We added a new API to fill forms with AI. Check out the [guide](/guides/how-to/ai/form-filling) to learn more. ## March 12, 2025 ## Monitor API Added support for monitoring browser windows for specific conditions. You can monitor browser windows in several ways: ### Natural language conditions Specify conditions in plain English that describe what you're waiting for: * "Determine if the user appears to be signed in to the website" * "Check if the shopping cart contains more than 3 items" * "Wait for the success message to appear" ### Configurable monitoring options Fine-tune the monitoring behavior with: * `intervalSeconds`: How frequently to check the condition (default: 5 seconds) * `timeoutSeconds`: Maximum time to wait for the condition (default: 30 seconds) * `includeVisualAnalysis`: Enable visual analysis for enhanced condition detection ### Resource management Control costs and execution time: * `costThresholdCredits`: Set credit limits for the monitoring operation * `timeThresholdSeconds`: Set maximum execution time limits > **Note** > > When visual analysis is enabled, monitoring operations may use more credits but can detect visual changes more > accurately For more information, see the [API reference](/api-reference/airtop-api/windows/monitor). ## Chrome Extension support Added support for installing and using Chrome extensions in browser sessions. For more information, see the [Chrome Extension support](/guides/how-to/using-chrome-extensions) guide. ## February 26, 2025 ## Scroll interaction Added support for scrolling in browser windows. [Scroll](/api-reference/airtop-api/windows/scroll) You can now programmatically scroll in three ways: ### Scroll by relative amount Use `scrollBy` to scroll a specific amount horizontally or vertically from the current position: * `xAxis`: Scroll horizontally by pixels or percentage (e.g. "100px" or "50%"). Positive values scroll right, negative values scroll left. * `yAxis`: Scroll vertically by pixels or percentage (e.g. "100px" or "50%"). Positive values scroll down, negative values scroll up. ### Scroll to page edges Use `scrollToEdge` to quickly navigate to the edges of the page: * `xAxis`: Scroll to "left" or "right" edge * `yAxis`: Scroll to "top" or "bottom" edge ### Scroll to specific elements Use `scrollToElement` to scroll to elements matching a natural language description (e.g. "the search box", "the submit button at the bottom of the form"). > **Note** > > When `scrollToElement` is provided, it takes precedence over `scrollBy` and `scrollToEdge` configurations, and `scrollBy`/`scrollToEdge` will be ignored For more details, see the [API reference](/api-reference/airtop-api/windows/scroll). ## February 12, 2025 ## Improved Residential Proxies ### Sticky sessions Added support for sticky sessions so you can maintain the same proxy IP address for up to 30 minutes at a time. > **Note** > > Stickiness is on a best-effort basis; we cannot guarantee the availability of specific IP addresses. ### Country support You can now specify a country for your proxy. ### Better defaults If you are already using Airtop's integrated proxy, all future requests will automatically get a proxy in the 🇺🇸 USA with sticky sessions. If you wish for the previous behavior, you can use our new configuration options: change the country to `global` and sticky to `false`. For more information, see our [proxy documentation](/guides/how-to/using-a-proxy). ## February 5, 2025 ## Visual Analysis mode Result Selection Strategy Visual analysis now supports a `resultSelectionStrategy` property that controls how elements are selected when multiple potential matches are found. The available strategies are: * `auto` (default) - Let the Airtop decide the best strategy. * `first` - Select the first matching element found * `bestMatch` - Select the element with the highest confidence score. Additional LLM credits will be used on this strategy. This gives you more control over which element is selected when there are multiple potential matches on the page. Check out the [visual analysis config](/api-reference/airtop-api/windows/click#request.body.configuration.visualAnalysis.resultSelectionStrategy) for more details. ## January 29, 2025 ## Screenshots You can now take screenshots of the browser window! Check out the [screenshot reference](/api-reference/airtop-api/windows/screenshot) for more details. ## Visual Analysis mode Scan Visual analysis now supports a new `scan` scope mode that progressively scrolls through the page while taking screenshots. This mode is useful for sites that have compatibility or accuracy issues with the default `page` mode. You can configure the maximum number of scrolls and delay between scrolls using the `maxScanScrolls` and `scanScrollDelay` parameters in the `visualAnalysis` config. Check out the [visual analysis config](/api-reference/airtop-api/windows/click#request.body.configuration.visualAnalysis.scope) for more details. ## January 22, 2025 ## Enhanced Prompts The Playground in our Studio allows you to automatically enhance your prompts and generate a JSON schema for the output. Detailed prompts and schemas help the model produce much more accurate results and this feature makes it much easier to create them. ## Right Click + Double Click Click interactions now support right click and double click. Simply add the `rightClick` or `doubleClick` parameter to the request. More details in the [interactions guide](/guides/how-to/ai/page-interactions). ## January 15, 2025 ## Name based profiles We've updated our profile management to now use names instead of IDs. We deprecated the `profileID` based API methods and replaced them with `profileName` based methods. This will make it easier to manage profiles by creating and saving profiles under the same name. ## January 10, 2025 ## Code Execution in the Studio Added support for running Typescript code in the Studio, as well as sharing the code snippets with other users. Now you can get started quickly and share a fully functional script without having to open an IDE. Check it out in the [Studio](https://portal.airtop.ai/studio/code). ## December 17, 2024 ## Make Integration We launched a new integration with Make. You can now use Airtop with Make to access content from the web and interact with sites. For more information, see the guide documentation for [Make](/guides/integrations/make). ## December 11, 2024 ## Batch Operations Added support for batch operations to the Node and Python SDKs. You can now use the batch operate helpers to repeatedly run an operation on a list of URLs. Concurrency and cleanup will be handled automatically. For more information, see the guide documentation for [batch operations](/guides/how-to/batch-operations). ## November 20, 2024 ## Integrated Proxy Service Added support for using Airtop's integrated proxy service. Now you can use a proxy to access sites that are restricted from being accessed directly through a residential IP address. For more information see the guide documentation for [using Airtop's integrated proxy service](/guides/how-to/using-a-proxy). ## Browser Natural Language Interactions Added support for natural language interactions with the browser. You can now use natural language to interact with the browser, e.g. to click buttons, fill out forms, hover over elements, etc. For more information see the guide documentation for [page interactions](/guides/how-to/ai/page-interactions). ## November 13, 2024 ## Support for structured output JSON schemas Added support for structured output. You can now use JSON schemas to guide the output of the LLM. For more information see the guide documentation for [using JSON schemas](/guides/how-to/ai/querying-a-page#using-json-schemas). ## November 1, 2024 ## Support for custom residential proxies Added support for custom residential proxies. You can now use your own residential proxies with Airtop and easily configure them to use upon session creation. For more information see the guide documentation for [proxies](/guides/how-to/using-a-proxy). ## October 19, 2024 ## New Native Window Management Added support for creating windows, loading URLs, and closing windows without having to use Puppeteer or Playwright. For more information see the guide documentation for [windows](/guides/how-to/creating-a-session#windows).