Skip to content
looot docs
Esc
↑↓navigate↵open⌘Jpreview
On this page

TinyFish Web Agent Automation API / Run browser automation synchronously

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.

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.

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 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/<runId>.

Example input with placeholder values:

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":"<profile_id>","use_profile":"<use_profile>","output_schema":{"type":"object","required":["title","price"],"properties":{"price":{"type":"number"},"title":{"type":"string"}}},"api_integration":"dify","browser_profile":"<browser_profile>","credential_item_ids":["<credential_item_ids>","<credential_item_ids>"]},"wait":30}'
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: "<profile_id>",
      use_profile: "<use_profile>",
      output_schema: {
        type: "object",
        required: ["title", "price"],
        properties: {
          price: {
            type: "number",
          },
          title: {
            type: "string",
          },
        },
      },
      api_integration: "dify",
      browser_profile: "<browser_profile>",
      credential_item_ids: ["<credential_item_ids>", "<credential_item_ids>"],
    },
    wait: 30,
  }),
});
const run = await response.json();
console.log(run.status, run.result);
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": "<profile_id>",
            "use_profile": "<use_profile>",
            "output_schema": {
                "type": "object",
                "required": ["title", "price"],
                "properties": {
                    "price": {
                        "type": "number",
                    },
                    "title": {
                        "type": "string",
                    },
                },
            },
            "api_integration": "dify",
            "browser_profile": "<browser_profile>",
            "credential_item_ids": ["<credential_item_ids>", "<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.

Was this page helpful?