- Category: web scraping & browser
- Auth: API_KEY
- Composio-managed OAuth available? N/A
- Tools: 11
- Triggers: 0
- Slug:
BROWSEAI - Version: 20261101_00
Tools
Bulk Run Tasks
Bulk Run Tasks
Slug:
BROWSEAI_BULK_RUN_TASKSThis action allows users to bulk run up to 1,000 tasks per API call using a specified robot. For larger datasets, submit multiple bulk runs sequentially (up to 500,000 tasks total). It provides a POST endpoint at /v2/robots/{robotId}/bulk-runs and supports parameters such as robot_id (required), title (required), and input_parameters (required). This bulk operation is essential for large-scale data extraction.Input Parameters
Array of input parameters for each task to run. Each item is a dictionary of parameters for a single task. Maximum 1,000 tasks per API call (up to 500,000 total via multiple bulk runs).
Output
Create Monitor
Create Monitor
Slug:
BROWSEAI_CREATE_MONITORCreates a new monitor for a Browse AI robot to automatically track website changes over time. A monitor runs a robot on a recurring schedule and can notify you when the captured data (screenshots or text) changes. This is useful for tracking price changes, content updates, availability status, or any other dynamic website information. You must first have a robot created (via the Browse AI dashboard) before you can monitor it. Use the GET_ROBOTS action to find available robot IDs. Key features: - Configure recurring schedules (hourly, daily, weekly) using RRULE format - Get email notifications when screenshots or text content changes - Customize notification sensitivity with threshold settings - Override robot parameters for each monitorInput Parameters
Recurring schedule for when the monitor should run, using RRULE format (RFC 5545). Format: ‘FREQ=<frequency>;INTERVAL=<number>;BYWEEKDAY=<days>’. Frequency options: HOURLY, DAILY, WEEKLY. Days: MO,TU,WE,TH,FR,SA,SU. Example: ‘FREQ=HOURLY;INTERVAL=2’ runs every 2 hours, ‘FREQ=DAILY;INTERVAL=1;BYWEEKDAY=MO,WE,FR’ runs daily on Mon/Wed/Fri. If not provided, monitor must be triggered manually.
Input parameters specific to the robot’s task configuration. These parameters override the robot’s default settings and can include fields like ‘originUrl’ (starting URL), pagination parameters (skip/limit), or any custom parameters your robot expects. Each robot may require different parameters based on its configuration.
Whether to send email notifications when the captured text content changes between monitoring runs
Whether to send email notifications when the captured screenshot changes between monitoring runs
Minimum percentage of screenshot pixels that must change to trigger a notification (0-100). For example, 15 means notify only if at least 15% of the screenshot has changed
Output
Create Webhook
Create Webhook
Slug:
BROWSEAI_CREATE_WEBHOOKCreates a webhook for a Browse AI robot to send callbacks for a selected event, such as task completion or captured data changes. If multiple events are supplied, only the first is used; create separate webhooks to monitor multiple event types.Input Parameters
List of events to trigger the webhook. Note: Browse AI only supports one event type per webhook, so only the first event will be used. Valid event types: taskFinished, taskFinishedSuccessfully, taskFinishedWithError, taskCapturedDataChanged, tableExportFinishedSuccessfully
Output
Delete a specific monitor
Delete a specific monitor
Delete a specific task
Delete a specific task
Get Robots List
Get Robots List
Slug:
BROWSEAI_GET_ROBOTSRetrieves a list of all robots (automated web tasks) under your Browse AI account. A robot is an automated browser task that can be trained to perform web operations such as: - Opening webpages and navigating through sites - Logging into websites - Clicking buttons and filling forms - Extracting structured data from web pages - Monitoring websites for changes This action returns comprehensive information about each robot including: - Robot ID (required for running tasks via other API endpoints) - Robot name and timestamps (creation/update) - Input parameters the robot accepts (parameter names, types, and whether they’re required) Use this to: - Discover available robots and their IDs for task execution - Check robot configuration and required input parameters - Monitor robot creation and update activity - Get an overview of all automated tasks in your account No parameters required - simply call this action to retrieve all robots.Output
Get Robot Tasks
Get Robot Tasks
Slug:
BROWSEAI_GET_ROBOT_TASKSRetrieves a paginated list of all tasks (execution runs) for a specific Browse AI robot. Each task represents one execution of the robot, which includes its current status, execution timestamps, input parameters, captured text data, screenshots, and extracted lists. This tool returns tasks in reverse chronological order (newest first) by default. Use the limit and offset parameters to paginate through large result sets. Use this tool to: - Check the status of recent robot executions (pending, running, successful, failed) - Access data captured by robot tasks (text, screenshots, lists) - Monitor robot performance and execution history - Retrieve task IDs for use with other task-related actions - Debug failed robot executions Note: You must have at least one robot configured in your Browse AI account to use this action. Use the Get Robots List action first to find available robot IDs.Input Parameters
Number of tasks to skip before starting to return results. Use this with limit for pagination (e.g., offset=10, limit=10 returns tasks 11-20).
The unique identifier (UUID format) of the robot whose tasks you want to retrieve. You can get robot IDs from the Get Robots List action.
Output
Get System Status
Get System Status
Get Task Details
Get Task Details
Slug:
BROWSEAI_GET_TASK_DETAILSRetrieves detailed information about a specific Browse AI task by robot ID and task ID. This tool returns comprehensive task details including execution status, captured data, screenshots, input parameters, timestamps (created, started, completed), and error information if the task failed. It provides an in-depth view of individual task execution for monitoring, debugging, and data retrieval purposes. Use this tool when you need to: - Check the current status of a task (running, successful, failed) - Retrieve data captured during task execution - Access screenshots taken during the task - Review input parameters used for the task - Debug task failures by examining error details - Monitor task execution timestampsInput Parameters
Output
List Robot Webhooks
List Robot Webhooks
Slug:
BROWSEAI_LIST_ROBOT_WEBHOOKSTool to retrieve all webhooks configured for a specific Browse AI robot. Use when you need to view, audit, or manage webhook configurations for a robot. Returns webhook details including URL, event type, active status, and creation timestamp.Input Parameters
The unique identifier (UUID format) of the robot whose webhooks you want to retrieve. You can get robot IDs from the Get Robots List action.
Output
Run Robot
Run Robot
Slug:
BROWSEAI_RUN_ROBOTTriggers the execution of a Browse.ai robot to extract data from websites. This action starts a new robot task that will scrape/extract data according to the robot’s pre-configured settings. The robot runs asynchronously and returns a task ID immediately. To retrieve the extracted data, use BROWSEAI_GET_TASK_DETAILS with the returned task ID. Prerequisites: - You must have at least one robot configured in your Browse.ai account - Obtain robot_id using BROWSEAI_GET_ROBOTS action first - Know what input parameters your robot expects (configured during robot creation) Common use cases: - Scraping product data from e-commerce sites - Monitoring website changes for specific content - Extracting structured data from multiple web pages - Automating repetitive web data collection tasks Note: The robot executes asynchronously. Check task status using BROWSEAI_GET_TASK_DETAILS or BROWSEAI_GET_ROBOT_TASKS to retrieve results when the task completes.Input Parameters
The unique identifier of the Browse.ai robot to execute. You can retrieve robot IDs using the BROWSEAI_GET_ROBOTS action.
Optional dictionary of custom input parameters for the robot execution. Common parameters include ‘originUrl’ for the starting URL, or custom parameters defined when the robot was created (e.g., search terms, filters, pagination settings). The required parameters depend on how the specific robot was configured.