Structured output

from browser_use_sdk.v4 import AsyncBrowserUse
from pydantic import BaseModel

class Post(BaseModel):
    name: str
    points: int
    comments: int

class HNPosts(BaseModel):
    posts: list[Post]

client = AsyncBrowserUse()
created = await client.runs.create(
    """
    List the top 20 Hacker News posts.
    Return JSON only in this shape:
    {"posts": [{"name": "string", "points": 0, "comments": 0}]}
    """
)
run = await client.runs.wait_for_completion(created.id)
posts = HNPosts.model_validate_json(run.result or "{}")

for post in posts.posts:
    print(f"{post.name} ({post.points} pts)")

import { BrowserUse } from "browser-use-sdk/v4";
import { z } from "zod";

const HNPosts = z.object({
  posts: z.array(z.object({
    name: z.string(),
    points: z.number(),
    comments: z.number(),
  })),
});

const client = new BrowserUse();
const created = await client.runs.create({
  task: `
    List the top 20 Hacker News posts.
    Return JSON only in this shape:
    {"posts": [{"name": "string", "points": 0, "comments": 0}]}
  `,
});
const run = await client.runs.waitForCompletion(created.id);
const posts = HNPosts.parse(JSON.parse(run.result ?? "{}"));

for (const post of posts.posts) {
  console.log(`${post.name} (${post.points} pts)`);
}