Browser Use runs browser tasks from natural-language instructions. Use it to navigate websites, interact with page controls, and extract information as a workflow step. The result includes the task status, output, and a screenshot URL when available.
Run a browser task from natural-language instructions to navigate pages, interact with controls, and extract information.
Runs a browser automation task using BrowserUse
Inputs and outputsParameter Type Required Description taskstring Yes What should the browser agent do startUrlstring No Initial page URL to start the agent on (reduces navigation steps) variablesjson No Optional secrets injected into the task (format: {key: value}) allowedDomainsstring No Comma-separated list of domains the agent is allowed to visit maxStepsnumber No Maximum number of steps the agent may take (default 100, max 10000) flashModeboolean No Enable flash mode (faster, less careful navigation) thinkingboolean No Enable extended reasoning mode visionstring No Vision capability: "true", "false", or "auto" systemPromptExtensionstring No Optional text appended to the agent system prompt (max 2000 chars) structuredOutputstring No Stringified JSON schema for the structured output highlightElementsboolean No Highlight interactive elements on the page (default true) metadatajson No Custom key-value metadata (up to 10 pairs) for tracking modelstring No LLM model identifier (e.g. browser-use-2.0) apiKeystring Yes API key for BrowserUse API profile_idstring No Browser profile ID for persistent sessions (cookies, login state)
Parameter Type Description idstring Task execution identifier successboolean Task completion status outputjson Final task output (string or structured) stepsarray Steps the agent executed (number, memory, nextGoal, url, actions, duration) ↳ number number Sequential step number ↳ memory string Agent memory at this step ↳ evaluationPreviousGoal string Evaluation of previous goal completion ↳ nextGoal string Goal for the next step ↳ url string Current URL of the browser ↳ screenshotUrl string Optional screenshot URL ↳ actions array Stringified JSON actions performed ↳ duration number Step duration in seconds liveUrlstring Embeddable live browser session URL (active during execution) shareUrlstring Public shareable URL for the recorded session (post-run) sessionIdstring Browser Use session identifier