Structured output

Ask for JSON and validate the V4 result in your application.

V4 returns run.result as a string. Ask for JSON only, then validate it client-side:

Python

from browser_use_sdk.v4 import BrowserUse
from pydantic import BaseModel

client = BrowserUse()

class Story(BaseModel):
    title: str
    points: int

run = client.runs.create(
    'Find the top HN story. Return only {"title":"...","points":0}.'
)
run = client.runs.wait_for_completion(run.id)
story = Story.model_validate_json(run.result or "{}")

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

const client = new BrowserUse();

const Story = z.object({
  title: z.string(),
  points: z.number(),
});

const run = await client.runs.create({
  task: 'Find the top HN story. Return only {"title":"...","points":0}.',
  model: "grok-4.5",
});
const result = await client.runs.waitForCompletion(run.id);
const story = Story.parse(JSON.parse(result.result ?? "{}"));

V4 does not accept output_schema / outputSchema. Handle validation errors and retry with a session follow-up when needed.