Run your first task
Extract a page heading with curl, Python, or TypeScript.
Use an MCP tool
Give your assistant browser automation and structured results.
Use your own Chrome
Let a local coding agent work in your profiles, logins, and tabs.
Choose how the task runs
Provide an explicit
output when downstream code expects a particular structure. If it is omitted, the service may infer an output schema; do not assume a specific data shape or that every task returns text.
Request lifecycle
- Submit tasks. Send URLs, instructions, and the output shape you need.
- Save the run ID. After credit and queue checks, tasks can start or wait.
- Follow the run. Poll the saved ID or stream available progress events.
- Read each outcome. Check every task’s status before consuming its data.
id to retrieve progress and results; each task has its own status and credit usage.
The status guide shows each task state and what it costs.
Choose how to receive results
Task counts, account in-flight limits, and per-run concurrency are different controls. Check queue status when submitting larger workloads.
Credits
Every browser task is charged a 0.1-credit floor when you submit it, so you need available credits to start. When the task finishes, it is charged any usage above the floor, whether it succeeded or not. Only anERROR or EXHAUSTED task keeps the floor and nothing more.
Read billing and limits for details.
Benchmarks
Our runs on two public benchmarks of tasks on live websites, next to the numbers TinyFish publishes for its own runs:
The Browser Agents figures are the mean of two full runs of each benchmark: 93.1% and 94.7% on WebVoyager, 80.3% and 76.3% on Online-Mind2Web. Under a stricter WebVoyager rule that needs a screenshot showing each claim, the mean is 91.4%. TinyFish’s numbers come from its own runs, with a different harness, patch set, and grader, and we did not re-run them. On Online-Mind2Web, Browser Agents trails TinyFish’s published number.
The benchmark report covers the protocol, results by site and level, the patched tasks and why, and a CSV of every task result from both runs.
Cloud browser tasks do not expose persistent login profiles, reusable cookie sessions, or a recurring-schedule API. Schedule submissions in your own application and provide the inputs each task needs. For work behind a login, use Browser Agents Local: your coding agent works in the Chrome you are already signed in to.

