Skip to Content

Connect TinyFish to Your AI Agent

Find sources, read pages, run browser tasks, and track scheduled changes from your assistant.

43 toolsAPI key

20,000 free app calls every month(paid services billed separately)

Try a TinyFish Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo SkillTinyFish

Research a topic

Search for sources and build a cited report.

/oo TinyFish: Research [topic], compare reliable sources, and summarize the findings with citations.

Start Working with TinyFish

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect TinyFish

    Create an API key at https://agent.tinyfish.ai/api-keys.

    Connect TinyFish→
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →
  • A TinyFish API key.
  • Wallet balance or a legacy plan for paid features.
  • Search and Fetch have daily free allowances. Monitor requires a personal API key.
  • Browser tasks can change data on websites. Saved browser state and vault connections can grant access to signed-in accounts.
  • Remote browser sessions require a CDP client for interaction. Wallet top-ups require an externally obtained MPP payment credential.

TinyFish Tools

TinyFish combines search and content extraction with browser agents, research, monitors, reusable browser profiles, password-manager connections, and wallet management.

Search and extract pages

Find web pages, news, and research papers, then extract their content.

Run browser workflows

Submit tasks and retrieve progress, results, and captured files.

Monitor changes

Schedule Page and Topic Monitors and manage their runs.

Manage browser access

Create remote browser sessions and reuse saved profiles and vault credentials.

Manage wallet funds

Check wallet information and complete an MPP top-up with your payment credential.

43 tools

Submit Run

Submit a browser automation task asynchronously. The agent can perform arbitrary website operations; use get_run to retrieve progress and results.

tinyfish.submit_run

Submit Run Batch

Atomically submit 1–100 browser automation tasks. Shared profile_id and output_schema apply to the batch. Retrieve each run using get_run or get_runs.

tinyfish.submit_run_batch

List Runs

List and search automation runs with cursor pagination, status, goal, and creation-time filters.

tinyfish.list_runs

Get Runs

Retrieve up to 100 automation runs, including per-run results, steps, and missing IDs.

tinyfish.get_runs

Cancel Runs

Cancel up to 100 automation runs. Already terminal runs retain their existing status; missing IDs are returned separately.

tinyfish.cancel_runs

Get Run

Retrieve an automation run and captured steps. Prefer screenshot URLs for JSON clients; use get_step_screenshot or get_step_html to transfer captured files.

tinyfish.get_run

Cancel Run

Cancel an asynchronous automation run. Already terminal runs retain their status. Runs started through the synchronous API cannot be cancelled.

tinyfish.cancel_run

Get Step Screenshot

Download a captured automation-step screenshot and return a file-transit URL.

tinyfish.get_step_screenshot

Get Step Html

Download a captured automation-step HTML snapshot and return a file-transit URL. Requires capture_config.html when submitting the run.

tinyfish.get_step_html

Search

Search web pages, news or research papers with optional content fetching.

tinyfish.search

List Search Usage

List paginated search usage records and recorded results.

tinyfish.list_search_usage

Fetch Urls

Fetch up to ten URLs with content extraction, selectors and conditional request support; inspect per-URL errors.

tinyfish.fetch_urls

List Fetch Usage

List paginated fetch usage records.

tinyfish.list_fetch_usage

Start Research

Start deep or maximum-depth research and retrieve its reports through get_research_run.

tinyfish.start_research

List Research Runs

List research runs with query, state, timestamp and cursor filters.

tinyfish.list_research_runs

Get Research Run

Get research progress, final reports, sources and terminal outcome.

tinyfish.get_research_run

Cancel Research Run

Cancel a research run and return whether its state changed.

tinyfish.cancel_research_run

Create Monitor

Create a Page or Topic Monitor with a schedule and baseline run; requires a personal API key.

tinyfish.create_monitor

List Monitors

List Page and Topic Monitors owned by the personal API key.

tinyfish.list_monitors

Get Monitor

Get a Page or Topic Monitor and its configuration.

tinyfish.get_monitor

Update Monitor

Pause or resume a Monitor, or update its schedule and optional metadata; these update modes cannot be combined.

tinyfish.update_monitor

Delete Monitor

Delete a Monitor and stop its scheduled runs.

tinyfish.delete_monitor

Run Monitor

Run a Monitor immediately and return its Page or Topic results.

tinyfish.run_monitor

List Profiles

List Browser Context Profiles and tracked signed-in sites.

tinyfish.list_profiles

Create Profile

Create a Browser Context Profile for reusable browser state.

tinyfish.create_profile

Get Profile

Get a Browser Context Profile and its saved domain metadata.

tinyfish.get_profile

Update Profile

Update profile metadata, default selection, or proxy country.

tinyfish.update_profile

Delete Profile

Delete a Browser Context Profile and its saved state.

tinyfish.delete_profile

Create Profile Setup Session

Start an interactive setup browser to sign in and capture state for a profile.

tinyfish.create_profile_setup_session

Cancel Profile Setup Session

Cancel a profile setup session without saving browser state.

tinyfish.cancel_profile_setup_session

Save Profile Setup Session

Save cookies and browser storage from a setup session into its profile.

tinyfish.save_profile_setup_session

Upload Profile State

Upload cookies, local storage, and session storage into a Browser Context Profile.

tinyfish.upload_profile_state

Delete Profile Domain

Delete cookies and storage for one saved profile domain.

tinyfish.delete_profile_domain

Connect Vault

Connect 1Password or Bitwarden and immediately sync display-safe credential metadata.

tinyfish.connect_vault

List Vault Connections

List connected password managers and validation status.

tinyfish.list_vault_connections

Disconnect Vault

Disconnect a password manager and remove its stored enabled items.

tinyfish.disconnect_vault

List Vault Items

List display-safe vault item metadata available from connected password managers.

tinyfish.list_vault_items

Sync Vault Items

Sync connected password managers and return item metadata and synchronization counts.

tinyfish.sync_vault_items

Get Wallet

Get wallet balance, auto-reload configuration, rates, and pending top-up details.

tinyfish.get_wallet

Top Up Wallet

Request a wallet top-up or submit caller-supplied MPP payment authorization. Return the payment challenge when payment is required. A pending result means payment was charged; do not pay again.

tinyfish.top_up_wallet

Create Browser Session

Create a remote browser session and return CDP connection details for an external browser client.

tinyfish.create_browser_session

List Browser Usage

List paginated browser session usage, filtered by session, timestamps, or status.

tinyfish.list_browser_usage

Terminate Browser Session

Terminate a remote browser session; an already-ended session also succeeds.

tinyfish.terminate_browser_session

Frequently Asked Questions

How do long-running tasks return results?

Submit a task, then use the linked result action to retrieve its status and final output. Captured screenshots and HTML snapshots can be returned as downloadable files.