Skip to content
Browsa
  1. Guides
  2. Robots

Robots: a browser job you set up once

A robot is a saved, named job. You describe it once in plain words. Browsa records it as a recipe, then runs it on demand, on a schedule or through the API, on Phantom.

Create it in plain words

  1. Describe. One text box: "Every morning, get the price and stock of these products."
  2. Example input. One row, such as a product URL.
  3. Try it. Browsa runs it once as an agent task. Watch it live.
  4. Save as robot. The run becomes a recipe and the robot wraps it.

The same from the API is two calls:

Terminal
curl https://browsa.io/v1/tasks -H "X-API-Key: $BROWSA_API_KEY" \
  -d '{"task": "Open the product page and return title, price and in_stock", "llm": "browsa",
       "initial_url": "https://books.toscrape.com/catalogue/sharp-objects_997/index.html",
       "record_recipe": true}'

# when the job is completed
curl https://browsa.io/v1/robots -H "X-API-Key: $BROWSA_API_KEY" \
  -d '{"name": "Book prices", "from_job_id": "JOB_ID"}'

Inputs

A table of rows, one per thing to check. Paste it, upload a CSV or type it. Up to 500 rows. One run covers every row.

inputs
[
  {"url": "https://books.toscrape.com/catalogue/sharp-objects_997/index.html"},
  {"url": "https://books.toscrape.com/catalogue/soumission_998/index.html"}
]

Run and schedule

Run now
One click on the robot page.
Schedule
Hourly to monthly.
API
POST /v1/robots/{id}/run with optional inputs for this run only.
No-code
n8n, Zapier, Make.

Results

Each run gives a table: one row per input, columns from the recipe's output. Runs are kept as history.

Read a run
GET /v1/robot-runs/{id}
Download
GET /v1/robot-runs/{id}/export?format=csv or json
Webhook
Signed with X-Agents-Signature, like every Browsa webhook.
Email
A short summary after each run.

Monitors

Get told only when something moves. A monitor watches one field on every row.

RuleFires when
changedThe value is not the same as last run
lt / gtThe value goes below or above a number
eqThe value equals what you set
in_stock_changedAn item goes in or out of stock

Alerts go out as the robot.alert webhook and by email, and show in the results table.

Health

  • Pass rate. Over the last 20 runs.
  • Typed failures. blocked, needs_login, site_changed, invalid_output, timeout. Free.
  • Versions. Repairs save a new recipe version. Roll back in one click.
  • Fix with AI. Records the job again when the site changed too much.

Webhooks: robot.run.completed, robot.alert, robot.failed.

Pricing

A robot run costs the recipe's credits per input row; failed rows are free.

Next steps

Make your first robot.

100 free credits. No card, no subscription.