Browser Use API

Give your agents access to Browser Use API. Bring your own Browser Use key, or skip the signup and pay per call from your Composio balance with Composio Instant.

Browser Use logoBrowser Use
Instant

Browser Use Cloud provides hosted browser agents, managed browser sessions, workspaces, profiles, and integrations. Use it to run browser-based automations at scale with managed sessions and profiles.

48 Tools
COMPOSIO INSTANT

What is Composio Instant?

Composio Instant lets your agent use paid APIs like Browser Use without a separate account or API key for each one. New accounts start with $2 of free credit.

No Browser Use account or key

Your agent calls Browser Use through Composio, so there is nothing to sign up for, store, or rotate.

Pay per call, at cost

Limited-time offer: Browser Use runs are free. max_cost_usd is required., paid from your Composio balance with zero markup.

Works in any agent

Claude, ChatGPT, Cursor, and other MCP clients, or your own code with the Composio SDK.

Works with your apps

Use Browser Use with Gmail, Slack, Google Sheets, and 1,700+ other apps you connect.

AI ASSISTANTS

Connect the Browser Use API to your AI assistant

Use Browser Use from the AI assistant you already work in. Connect Composio once, then paste the prompt.

  1. 1

    Open the Connectors menu

    Use the button to open Claude's Add connector dialog with Composio filled in. Or click + in the message box, then Connectors, Add connector and Add custom connector.
    Add Composio to Claude
  2. 2

    Add the Composio MCP server

    Name it Composio, paste the MCP server URL and click Add.
    https://connect.composio.dev/mcp
  3. 3

    Authorize in your browser

    A browser window opens. Sign in to Composio to approve the connection.
  4. 4

    Paste the prompt

    Start a new chat and paste the prompt. Claude runs the call on Composio Instant.
  1. 1

    Install the Composio plugin

    Open Composio's plugin page in ChatGPT and click Install. Sign in to ChatGPT first if it asks.
    Install in ChatGPT
  2. 2

    Authorize in your browser

    Connect the plugin, then sign in to Composio to approve the connection.
  3. 3

    Turn on Composio in your chat

    In a new chat, click +, then More, and select Composio.
  4. 4

    Paste the prompt

    Paste the prompt into that chat. ChatGPT runs the call on Composio Instant.
  1. 1

    Install the Composio plugin

    Open Composio in the Cursor marketplace, click Install Composio Plugin for Cursor and approve the connection in your browser.
    Install in Cursor
  2. 2

    Paste the prompt

    Open the Agent chat and paste the prompt. Cursor runs the call on Composio Instant.
  1. 1

    Add the Composio plugin

    Open Composio's listing on x.ai and click Add to Grok Bot. When Grok Bot opens the plugin, click Add.
    Add to Grok Bot
  2. 2

    Authenticate

    Go to Installed, open Composio and click Authenticate. Sign in to Composio and click Authorize.
  3. 3

    Paste the prompt

    Paste the prompt into your bot's chat. Grok Bot runs the call on Composio Instant.
  1. 1

    Paste the setup prompt

    Copy this into your Hermes chat. Hermes adds the Composio MCP server for you.
    Set up Composio from composio.dev/hermes
  2. 2

    Authorize in your browser

    A browser window opens. Sign in to Composio to approve the connection.
  3. 3

    Paste the prompt

    Start a new chat and paste the prompt. Hermes runs the call on Composio Instant.
ClaudeNew chat

Paste this prompt

Use Browser Use through Composio Instant to open https://en.wikipedia.org/wiki/Large_language_model and summarize the article's main idea in three bullet points.

What success looks like

BROWSER_USE_START_RUN

Your assistant runs Browser Use and replies with three bullet points that summarize the article's main idea.

Runs on Composio Instant
SDK

Use the Browser Use API in your code

Call Browser Use from your own agent with the Composio SDK. Four steps and one tool call.

  1. 1

    Set up Composio

    Turn on Instant Toolkits in your project settings and check your prepaid balance in Billing. Then set your API key.
    export COMPOSIO_API_KEY="your_composio_api_key"
  2. 2

    Install the SDK

    The Python SDK needs Python 3.11 through 3.15.
    pip install composio
  3. 3

    Run the call

    Create a session that keeps Instant to this toolkit and reports the charge, then run the tool on the Instant account.
    BROWSER_USE_START_RUN
  4. 4

    Read the response

    When the call runs on Instant, the response includes its charge: the amount as an exact USD decimal string, the currency and charged_by.
agent.py
from composio import Composio

composio = Composio()

session = composio.sessions.create(
    user_id="user_123",
    toolkits=["browser_use"],
    instant={
        "toolkits": {"enable": ["browser_use"]},
        "return_instant_charge": True,
    },
)

result = session.execute(
    "BROWSER_USE_START_RUN",
    arguments={
        "task": "Open https://en.wikipedia.org/wiki/Large_language_model and summarize the article's main idea in three bullet points.",
        "max_cost_usd": 1,
    },
    account="instant_account",
)
print(result)
print("Instant charge:", result.instant_charge)
TOOLS

Available Browser Use API tools

4 Browser Use tools run on Instant, priced per call with no Browser Use key. Tools marked Your key need your own Browser Use account.

ActionTool slugWhat it doesAvailability
Start RunBROWSER_USE_START_RUNStart an asynchronous hosted browser-agent task.
InstantLimited-time offer: Browser Use runs are free. max_cost_usd is required.
Get RunBROWSER_USE_GET_RUNRetrieve a run's result, usage, and input-file attachments.
Instant$0 per request
Get Run StatusBROWSER_USE_GET_RUN_STATUSCheck a run's indexed status for polling.
Instant$0 per request
List Run EventsBROWSER_USE_LIST_RUN_EVENTSRead a page of a run's execution events.
Instant$0 per request
Create Browser SessionBROWSER_USE_CREATE_BROWSER_SESSIONLaunch a managed browser for direct CDP control.Your key
Create Browser ProfileBROWSER_USE_CREATE_PROFILECreate a persistent profile for reusable cookies and browser state.Your key
Create WorkspaceBROWSER_USE_CREATE_WORKSPACECreate a workspace for browser-run input files and outputs.Your key

Instant prices are Browser Use's list prices with 0% markup, paid from your Composio balance and updated every hour. Instant calls also count toward your plan's tool calls. See all plans on the pricing page.

USE CASES

Browser Use API use cases and example prompts

Copy a prompt into your agent. Each one uses Browser Use with apps you connect through Composio.

  • Log competitor launch changes

    Use Browser Use to visit the official product and newsroom pages for the companies in my Launch Watchlist in Google Sheets. Add newly announced product changes and their source URLs to the sheet, then post a summary in Slack's #competitive-intel channel.

    Apps used: Browser Use, Google Sheets, Slack

  • Turn setup docs into a guide

    Use Browser Use to read the public setup and troubleshooting pages linked in my Integration Notes in Notion. Write a setup checklist with source URLs and save it as a separate page in my Team Playbook in Notion.

    Apps used: Browser Use, Notion

  • Review Acme before a sales call

    Use Browser Use to review Acme's public website and product pages. Add a note with its product lines, recent announcements, and source URLs to the Acme company record in HubSpot, then draft a Gmail message for my sales team to review before the call.

    Apps used: Browser Use, HubSpot, Gmail

  • Compare listed prices for renewal

    Use Browser Use to visit the pricing pages for the vendors in my Renewal Tracker in Google Sheets. Add listed plan names, prices, and source URLs to the sheet, then write a renewal comparison in Google Docs that links to the tracker.

    Apps used: Browser Use, Google Sheets, Google Docs

TROUBLESHOOTING

Browser Use API troubleshooting

Still stuck? The Instant tools docs cover limits, charges and session settings.

Start with Browser Use.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Browser Use tool your agent needs.Free to start.

Start building