BrowserAI icon

BrowserAI

Interact with the BrowserAI API

Overview

The node "BrowserAI" integrates with the BrowserAI API to manage and interact with automated browser tasks. Specifically, the Create Saved Task operation allows users to define and save a reusable task configuration that can later be executed or managed. This is useful for automating repetitive web interactions such as data scraping, form submissions, or scripted browsing actions.

Typical use cases include:

  • Creating scheduled automation tasks that run periodically (using cron settings).
  • Defining geographic targeting for tasks by specifying country, city, and zipcode.
  • Automating complex workflows by providing detailed instructions for the browser to execute.
  • Saving task templates for reuse without redefining them each time.

For example, a user might create a saved task to crawl a website daily at a specific time, targeting users in a particular city, and performing a series of scripted actions.

Properties

Name Meaning
Project The project name or identifier under which the task is grouped or categorized.
Task Name The unique name of the saved task being created.
Country The country part of the geographic location where the task should operate.
City The city part of the geographic location for the task.
Zipcode The postal code part of the geographic location for the task.
Task Type The type of task to create. Options: Crawler Automation (automated browsing/crawling), Script Automation (custom script execution).
Instructions A collection of instructions defining the actions the task should perform. Each instruction includes an Action string describing what to do.
Cron Settings A string representing scheduling information in cron format to automate when the saved task runs.

Output

The node outputs an array of JSON objects, each representing the response from the BrowserAI API after creating the saved task. The JSON structure corresponds directly to the API's response and typically contains details about the saved task such as its ID, status, and metadata.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the BrowserAI API.
  • The node sends HTTP requests to https://browser.ai/api/v1/.
  • Proper network access to the BrowserAI service endpoint is necessary.
  • No additional environment variables are required beyond the API key credential.

Troubleshooting

  • Missing Country Field: The node requires the Country property to build the geoLocation object. If omitted, it will throw an error indicating that the country is required.
  • Invalid API Key or Authentication Errors: Ensure the provided API key credential is valid and has sufficient permissions.
  • Incorrect Task Name or Duplicate Names: When creating a saved task, ensure the task name is unique to avoid conflicts.
  • Malformed Instructions: The instructions must be provided as an array of objects each containing an action string. Incorrect formatting may cause API errors.
  • Cron Settings Format: If using cron scheduling, verify the cron expression is valid; otherwise, the task scheduling may fail silently or produce errors.

Links and References

Discussion