--- title: "TinyFish Web Agent Automation API / Run browser automation synchronously" description: "TinyFish Search API tool tinyfish-automation-run on looot: input fields, $0.016 per result, output shape, and code to run it with curl, JavaScript or Python." sidebar: hidden: true --- {/* Generated by scripts/generate-api-reference.mjs from data/api-reference.json. Do not edit. */} Execute a browser automation task synchronously and wait for completion. Returns the final result once the automation finishes (success or failure). Use this endpoint when you need the complete result in a single response. Note: Runs created via this endpoint cannot be cancelled. If you need cancellation support, use `/v1/automation/run-async` or `/v1/automation/run-sse` instead. - **Tool id:** `tinyfish-automation-run` - **Provider:** [TinyFish Search API](/providers/tinyfish) - **Job:** [Run a browser agent on a page](/reference/jobs/browser-automation-run) (`browser.automation.run`) - **Price:** $0.016 per result. A call that fails at the provider costs $0. ## Inputs | 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. | ## 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":"tinyfish-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: "tinyfish-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": "tinyfish-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 let looot pick among every provider of this job instead, send `job:browser.automation.run` as `endpointId`; see [the job page](/reference/jobs/browser-automation-run).