TinyFish

Connect your AI agents to TinyFish.

Authentication: API key. See Magic Link for the runtime auth flow.

Sample use cases

  • Run a browser automation that finds the cheapest plan on a vendor’s pricing page
  • Start a batch of automations that check order status across supplier portals
  • Fetch a list of URLs and return their content for summarization

Available Tools

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…

close_browser_session

Close a remote browser session created by create_browser_session, ending its per-minute billing immediately…

list_browser_profiles

List saved Browser Context Profiles (persistent logged-in browser state). Use the returned id values for profile_id…

fetch_urls

Fetch and extract content from 1-10 URLs. Per-URL failures are returned in errors alongside any successful…

list_runs

List automation runs with optional server-side filters (status, goal substring, date range) and sorting. Use get_run…

get_run

Get full detail for one run, including its steps. Defaults to lean output: screenshots as URLs and HTML omitted. Use…

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…

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 get_run’s steps to find valid run_id/step_id pairs…

get_run_step_html

Get the raw HTML snapshot for one run step. Only available if capture_config.html was enabled on the run. Use…

search_web

Run a web search and return ranked results. Supports filtering by domain, date range, and recency. Use the page…

list_vault_credentials

List vault credential items available to this account. Use the returned id values for credential_item_ids when…

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…

list_browser_session_usage

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