TinyFish Web Agent icon

TinyFish Web Agent

Extract data, fill forms, and automate multi-step browser workflows using natural language

Run (Async)

AI-generated

Summary

Starts an asynchronous TinyFish web automation run, returning a run ID immediately for later polling via Get Run.

Inputs

  • url (required) — The website URL to navigate to. Must include https://. The AI browser will load this page and execute the goal.
  • goal (required) — Natural language instruction for what to accomplish on the website. For best results: specify the exact JSON schema you want returned, include termination conditions, and handle edge cases explicitly.
  • options — Execution options for the automation.

Output shape

The API response wrapped in n8n execution metadata, typically containing a run ID and status, enabling subsequent retrieval of the full result via the Get Run operation.

The operation builds a payload from the provided parameters and sends it via POST to /v1/automation/run-async. It does not wait for automation completion.

Links

Discussion