Form Filling

Automate form filling and submission

Basic Example

Fill and submit a contact form:

Python

from tinyfish import TinyFish, EventType, RunStatus

client = TinyFish()

with client.agent.stream(
    url="https://example.com/contact",
    goal="""Fill in the contact form:
        - Name field: "John Doe"
        - Email field: "[e-mail]"
        - Message field: "I am interested in your services."
        Then click the Submit button and extract the success message.
    """,
) as stream:
    for event in stream:
        if event.type == EventType.COMPLETE and event.status == RunStatus.COMPLETED:
            print("Result:", event.result_json)

Output:

{
  "success": true,
  "message": "Thank you for contacting us!"
}

Multi-Step Form

Handle multi-step forms in a single goal:

Python

from tinyfish import TinyFish

client = TinyFish()

with client.agent.stream(
    url="https://example.com/signup",
    goal="""Complete the multi-step signup form:

        Step 1 (Personal Info):
        - First name: "John"
        - Last name: "Doe"
        - Email: "[e-mail]"
        - Click "Next"

        Step 2 (Address):
        - Street: "123 Main St"
        - City: "San Francisco"
        - State: "CA"
        - ZIP: "94102"
        - Click "Next"

        Step 3 (Preferences):
        - Select "Email notifications" checkbox
        - Click "Submit"

        Extract the confirmation number from the success page.
    """,
) as stream:
    for event in stream:
        print(event)

Tips

• Use stealth mode for login/signup forms
• Be explicit about field values in your goal
• Describe buttons by their text (“click ‘Submit’”)
• Handle multi-step forms in one goal

Try It

1. Save the code

   Save any example above as form.ts
2. Set your API key

   export TINYFISH_API_KEY="your_api_key"
3. Run it

   npx tsx form.ts

Related

Web Scraping

Extract data from pages

Run SSE API

Complete API docs