--- title: "Run a browser agent on a page" description: "Run job:browser.automation.run through the looot API: 1 provider, from $0.016 per result. Inputs, prices, output shape and code for curl, JavaScript and Python." sidebar: hidden: true --- {/* Generated by scripts/generate-api-reference.mjs from data/api-reference.json. Do not edit. */} Run a browser agent on a page. Job id `browser.automation.run`, in Scrapers (Browser tasks). As of 2026-10-01, 1 provider serve it through 1 tool. Run `job:browser.automation.run` and looot picks one of them; with `fallback` on, a miss moves on to the next. See [Jobs](/concepts/jobs). ## Inputs This job has one tool, so it takes that tool's fields. Any key you send passes through unchanged. | Name | Type | Required | Description | | --- | --- | --- | --- | | `agent_config` | string | no | Agent behavior configuration | | `api_integration` | string | no | Name of the integration making this API call (e.g., "dify", "zapier", "n8n"). Used for analytics. Example: "dify" | | `browser_profile` | string | no | Browser profile for execution. LITE uses standard browser, STEALTH uses anti-detection browser. | | `capture_config` | string | no | Configure which data to capture during the run. | | `credential_item_ids` | array | no | Scope vault credentials to specific credential URIs. Requires use_vault to be true. If omitted with use_vault: true, all enabled items are used. | | `goal` | string | yes | Natural language description of what to accomplish on the website. Example: "Find the pricing page and extract all plan details" | | `output_schema` | string | no | Optional provider-supported structured-output schema subset for the run result. Unsupported fields are rejected before the request is accepted. | | `profile_id` | string | no | Browser Context Profile ID to use when use_profile is true. | | `proxy_config` | string | no | Proxy configuration | | `url` | string | yes | Target website URL to automate. Example: "https://example.com" | | `use_profile` | boolean | no | Opt-in to the default Browser Context Profile if Browser Context Profiles are enabled; legacy callers are silently ignored when the profiles feature is disabled. Returns 400 when enabled but no default profile is set. | | `use_vault` | boolean | no | Opt-in to vault credentials for this run. When true, enabled vault items are included. Defaults to false. Example: true | | `webhook_url` | string | no | HTTPS URL to receive webhook notifications for run lifecycle events. Must use HTTPS. | ## Providers and prices | Provider | Tool | Price | | --- | --- | --- | | [TinyFish Search API](/providers/tinyfish) | [`tinyfish-automation-run`](/reference/tools/tinyfish-automation-run) | $0.016 per result | A call that fails at the provider costs $0. See [What's free](/money/free-and-failures). ## Output The run's `result` holds the provider's answer. Signed in, `looot inspect tinyfish-automation-run` prints its fields. ## Run it Every call needs your API token in `LOOOT_TOKEN`; [Sign in](/get-started/sign-in#use-the-token-in-scripts-and-agents) shows how to get one. Each run also needs a new idempotency key, so a retry never pays twice. With `wait: 30` the answer comes back inline when the run ends within 30 seconds. Otherwise you get the running run back: poll `GET /v1/runs/`. Example input with placeholder values: ```bash curl curl -X POST "https://api.looot.ai/v1/runs" \ -H "Authorization: Bearer $LOOOT_TOKEN" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{"endpointId":"job:browser.automation.run","input":{"url":"https://example.com","goal":"Find the pricing page and extract all plan details","use_vault":true,"profile_id":"","use_profile":"","output_schema":{"type":"object","required":["title","price"],"properties":{"price":{"type":"number"},"title":{"type":"string"}}},"api_integration":"dify","browser_profile":"","credential_item_ids":["",""]},"wait":30}' ``` ```js JavaScript const response = await fetch("https://api.looot.ai/v1/runs", { method: "POST", headers: { Authorization: `Bearer ${process.env.LOOOT_TOKEN}`, "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID(), }, body: JSON.stringify({ endpointId: "job:browser.automation.run", input: { url: "https://example.com", goal: "Find the pricing page and extract all plan details", use_vault: true, profile_id: "", use_profile: "", output_schema: { type: "object", required: ["title", "price"], properties: { price: { type: "number", }, title: { type: "string", }, }, }, api_integration: "dify", browser_profile: "", credential_item_ids: ["", ""], }, wait: 30, }), }); const run = await response.json(); console.log(run.status, run.result); ``` ```python Python import os import uuid import requests response = requests.post( "https://api.looot.ai/v1/runs", headers={ "Authorization": f"Bearer {os.environ['LOOOT_TOKEN']}", "Idempotency-Key": str(uuid.uuid4()), }, json={ "endpointId": "job:browser.automation.run", "input": { "url": "https://example.com", "goal": "Find the pricing page and extract all plan details", "use_vault": True, "profile_id": "", "use_profile": "", "output_schema": { "type": "object", "required": ["title", "price"], "properties": { "price": { "type": "number", }, "title": { "type": "string", }, }, }, "api_integration": "dify", "browser_profile": "", "credential_item_ids": ["", ""], }, "wait": 30, }, timeout=90, ) run = response.json() print(run["status"], run.get("result")) ``` To pin one provider, send its tool id as `endpointId` instead of `job:browser.automation.run`.