Connect your AI Agents to TinyFish in minutes

run_automation

start_automation

start_automations_batch

create_browser_session

Create a remote browser session and return its Chrome DevTools Protocol (CDP) endpoint. This hands back a raw browser connection for external automation tooling — it is not something this agent drives directly. Billed per minute until the session ends or its inactivity timeout is reached — call closebrowsersession to end billing early.

close_browser_session

Close a remote browser session created by createbrowsersession, ending its per-minute billing immediately. Idempotent — closing an already-ended session still succeeds.

list_browser_profiles

List saved Browser Context Profiles (persistent logged-in browser state). Use the returned id values for profileid when calling runautomation, startautomation, or startautomationsbatch with useprofile=True.

fetch_urls

Fetch and extract content from 1-10 URLs. Per-URL failures are returned in errors alongside any successful results rather than failing the whole call.

list_runs

List automation runs with optional server-side filters (status, goal substring, date range) and sorting. Use get_run for full step-level detail on a specific run.

get_run

Get full detail for one run, including its steps. Defaults to lean output: screenshots as URLs and HTML omitted. Use getrunstepscreenshot/getrunstephtml to fetch individual step content directly, or pass screenshots='base64'/html='base64' here to inline it (subject to a total size budget across all steps; check each step's screenshottruncated/htmltruncated to see what was omitted).

get_runs_batch

Get full detail for up to 100 runs by ID in a single call. Inlined step content is subject to a total size budget across the whole response; check each step's screenshottruncated/htmltruncated to see what was omitted, then use getrunstepscreenshot/getrunstephtml to fetch it individually.

cancel_run

Cancel a pending or running automation run. Has no effect (returns the current status) if the run already finished.

cancel_runs_batch

Cancel up to 100 pending or running automation runs by ID in a single call.

get_run_step_screenshot

Get the screenshot for one run step as base64-encoded JPEG. Use getrun's steps to find valid runid/stepid pairs. Screenshots over 512KB are not returned: contentbase64 is null and truncated is true. There is no param to raise that cap — use the step's screenshot URL from get_run instead.

get_run_step_html

Get the raw HTML snapshot for one run step. Only available if captureconfig.html was enabled on the run. Use getrun's steps to find valid runid/stepid pairs.

search_web

Run a web search and return ranked results. Supports filtering by domain, date range, and recency. Use the page param (0-10) to fetch more results; check the response's hasnextpage before requesting another.

validate_credential

Check that the TinyFish connection works by calling the wallet endpoint.

list_vault_credentials

List vault credential items available to this account. Use the returned id values for credentialitemids when calling runautomation, startautomation, or startautomationsbatch.

get_wallet

Get the current wallet balance, auto-reload configuration, and billing rates for this account.

list_fetch_usage

List paginated usage records for the fetch API.

list_search_usage

List paginated usage records for the search API. Each record has the query and its result count, not the results themselves.

list_browser_session_usage

List paginated usage records for browser sessions, optionally filtered by session_id or status.