Skip to main content
A goal is the goal parameter you pass to the API: a plain English description of what you want TinyFish Web Agent to accomplish. Instead of writing code to click buttons or parse HTML, you describe the task and TinyFish Web Agent figures out how to do it.

​
The Mental Model

Think of TinyFish Web Agent as a capable assistant sitting in front of a browser. It can see what’s on the screen, click, type, scroll, and navigate, but it needs clear instructions. What it can do:
  • See exactly what you would see on the screen
  • Click, type, scroll, and navigate
  • Wait for dynamic content to load
  • Follow instructions precisely
  • Return structured data
  • Navigate multi-page PDFs and extract content
  • Remember information across workflow steps
  • Parse natural language into form fields
What it cannot do:
  • Read your mind about what you meant
  • Guess what to do when something unexpected happens
  • Know your business context unless you tell it
  • Decide on output format without explicit instructions
Your job is to remove ambiguity. The more explicit your goal, the higher your success rate.

​
Quick Examples

Data extraction: 
Extract product name, price, and stock status. Return as JSON.
Form filling: 
Fill the contact form with name "John Doe" and email "john@example.com", then click Submit.
Multi-step workflow: 
1. Login with email "user@example.com" and password "pass123"
2. Navigate to the dashboard
3. Extract account balance

​
Learn More

Learn how to write goals that succeed on the first try with our Goal Prompting Guide.

Goal Prompting Guide

The anatomy of a great goal, task-specific patterns, and production-ready examples.

Runs

What happens after you send a goal

Endpoints

Choose how to call the API