Skip to main content
TinyFish logo
  • Category: ai agents
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 32
  • Triggers: 0
  • Slug: TINYFISH
  • Version: 20261101_00
  • Instant: Supported on the latest version. Support varies by tool.

Tools

Slug: TINYFISH_CANCEL_PROFILE_SETUP_SESSIONCancel a Browser Context Profile setup session and permanently discard its unsaved cookies and browser storage.

Input Parameters

string
required
Browser Context Profile whose temporary setup session should be cancelled.
string
required
Setup session to cancel and discard without saving its browser state.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_CANCEL_RESEARCH_RUNCancel one running TinyFish research run using a connected TinyFish account. Cancellation is irreversible but idempotent: terminal runs return their current status with cancelled=false.

Input Parameters

string
required
Running research run ID owned by the connected TinyFish account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_CANCEL_RUNSIdempotently cancel one or up to 100 asynchronous or SSE runs. Active cancellation is irreversible; synchronous runs cannot be cancelled, and already-terminal runs are returned with their actual status.

Input Parameters

array
required
One to 100 TinyFish run IDs to cancel. Only asynchronous and SSE runs can be cancelled; synchronous runs cannot be cancelled.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_CREATE_BROWSER_SESSIONCreate an isolated TinyFish remote browser session and return its CDP connection URL. This action starts billable browser infrastructure: TinyFish meters Browser usage until the session ends or becomes inactive. You must call Terminate Browser Session with the returned session_id immediately after browser work finishes, including after failures, to stop further usage charges. Creation can return before startup navigation completes.

Input Parameters

string
Optional startup URL. TinyFish adds https:// when given a bare domain; session creation may finish before navigation to this URL completes.
integer
Requested session lifetime in seconds (5-86400). The effective lifetime may be capped by the TinyFish account plan.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_CREATE_MONITORCreate a scheduled Page or Topic Monitor and immediately capture its paid baseline using a connected TinyFish account. Each completed baseline costs $0.005, failed runs are not charged, and an account can hold at most 50 Monitors; a timeout or server error can leave the Monitor created.

Input Parameters

string
Optional Monitor name.
string ("fetch" | "search")
required
fetch creates a Page Monitor; search creates a Topic Monitor.
string
required
Immutable Page or Topic target configuration.
string
Optional description of the change TinyFish should evaluate.
string
Optional public HTTP or HTTPS callback for scheduled results.
string
required
Five-field cron schedule, in UTC unless prefixed by CRON_TZ=<IANA zone>. Topic schedules must keep runs at least 30 minutes apart.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_CREATE_PROFILECreate a reusable Browser Context Profile for cookies and browser storage; this changes persistent account state.

Input Parameters

string
required
Human-readable name for the Browser Context Profile (1-100 characters).
boolean
Whether the new profile should become the account’s default profile.
string ("US" | "GB" | "CA" | "AU" | "DE" | "FR" | "IT" | "ES" | "NL" | "JP" | "SG" | "BR" | "IN")
Country for the profile proxy, or null for no country preference.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_DELETE_MONITORPermanently delete a TinyFish Monitor and its schedule using a connected TinyFish account. Its Monitor run history becomes unavailable and this action cannot be undone; verify an ambiguous outcome before another delete.

Input Parameters

string
required
Monitor ID to permanently delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_DELETE_PROFILEPermanently delete a Browser Context Profile and all browser state saved in it. This action cannot be undone.

Input Parameters

string
required
Browser Context Profile ID to permanently delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_DELETE_PROFILE_DOMAINPermanently remove saved cookies and browser storage for one domain from a Browser Context Profile. This action cannot be undone.

Input Parameters

string
required
Exact domain whose saved cookies and browser storage should be removed.
string
required
Browser Context Profile containing the saved domain state.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_FETCH_URLSRender and extract content from 1-10 URLs in one provider-native batch. Always inspect both results and errors because HTTP 200 can contain successful pages and per-URL failures together.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

integer
Cache freshness tolerance in seconds; 0 prefers a live fetch.
array
required
Between 1 and 10 public HTTP(S) URLs to fetch in parallel.
Whether to include absolute outbound page links.
string ("markdown" | "html" | "json")
Output representation for extracted page content.
string
Nonblank reason for fetching the pages, used to guide extraction.
Whether to include absolute image links.
string
ETag validator from a prior fetch; valid only with exactly one URL.
boolean
Whether to include browser and page-head metadata.
array
One to 20 nonblank CSS selectors (each at most 1000 characters) to remove.
string
Last-Modified validator from a prior fetch; valid only with exactly one URL.
array
One to 20 nonblank CSS selectors (each at most 1000 characters) to include.
integer
Independent wall-clock timeout for each URL in milliseconds (1-110000).
boolean
Whether to return origin ETag and Last-Modified validators when available.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_GET_MONITORGet one TinyFish Page or Topic Monitor by ID using a connected TinyFish account, including its target config, schedule, lifecycle status, webhook, and last error.

Input Parameters

string
required
Monitor ID owned by the connected TinyFish account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_GET_PROFILEGet one Browser Context Profile and its saved-domain metadata.

Input Parameters

string
required
Browser Context Profile ID to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_GET_RESEARCH_RUNRead one saved TinyFish research run using a connected TinyFish account, including status, partial or final reports, plan, evidence, and iteration count. Inspect status before treating any report as complete; unsuccessful runs can retain partial results.

Input Parameters

string
required
Research run ID owned by the connected TinyFish account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_GET_RUNSGet summary records for 1-100 TinyFish automation run IDs in one request. The response separately reports IDs that were not found or are not owned.

Input Parameters

array
required
TinyFish automation run IDs to retrieve in one batch (1-100 IDs).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_GET_WALLETGet the TinyFish wallet balance, auto-reload and pending-top-up state, and current Agent and Browser rates. Monetary values are returned as exact decimal strings. Legacy-credit accounts report FEATURE_NOT_AVAILABLE rather than an authentication failure.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_LIST_MONITORSList Page and Topic Monitors owned by a connected TinyFish account, including their IDs for management and run operations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_LIST_PROFILESList Browser Context Profiles available to the connected TinyFish account. Use the returned IDs when attaching or managing reusable browser state.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_LIST_RESEARCH_RUNSList saved TinyFish research runs with optional status, query, date, and sort filters, returning one cursor-controlled page.

Input Parameters

integer
Maximum saved runs to return (1-100).
string
Filter saved research runs by query text.
string
Opaque cursor returned by this tool. Omit it for the first page.
string ("RUNNING" | "COMPLETED" | "FAILED" | "CANCELLED" | "TIMED_OUT" | "QUEUED")
Filter by a TinyFish research-run lifecycle status.
string
Return runs created after this ISO 8601 timestamp.
string
Return runs created before this ISO 8601 timestamp.
string ("asc" | "desc")
Sort by creation time in ascending or descending order. Continuation cursors retain the first page’s value.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_LIST_RUNSList automation runs with optional status, goal, date, and sort filters, returning one cursor-controlled page.

Input Parameters

string
Filter runs by a case-insensitive partial match on goal text.
integer
Maximum runs to return in this page (1-100).
string
Opaque cursor returned by this tool. Omit it for the first page.
string ("PENDING" | "RUNNING" | "COMPLETED" | "FAILED" | "CANCELLED")
Return only runs in this lifecycle state.
string
Return runs created after this ISO 8601 timestamp.
string
Return runs created before this ISO 8601 timestamp.
string ("asc" | "desc")
Sort by creation time in ascending or descending order.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_LIST_USAGEList one page of Search, Fetch, or Browser usage history. Search and Fetch usage reads are free; Browser usage requires the paid Browser service.

Input Parameters

integer
One-based usage-history page.
integer
Maximum usage records to return in this page (1-1000).
string ("completed" | "failed" | "running" | "ended")
Filter by completed or failed for Search and Fetch, or running or ended for Browser.
string ("search" | "fetch" | "browser")
required
TinyFish product whose usage history should be listed.
string
Return usage created before this ISO 8601 timestamp.
string
Browser session ID filter; valid only when service is browser.
string
Return usage created after this ISO 8601 timestamp.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_LIST_VAULT_CONNECTIONSList display-safe metadata for password-manager vaults connected to TinyFish. Credentials and secret values are excluded.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_LIST_VAULT_ITEMSList display-safe metadata for items synchronized from password-manager vaults connected to TinyFish. Secret field values are never returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_RUN_MONITOR_NOWRun an existing Page or Topic Monitor immediately and save its result; managed Instant users must connect their own TinyFish account. Each completed run costs $0.005 and sends no webhook or email notification; a timeout or server error leaves creation uncertain.

Input Parameters

string
required
Existing active, paused, or failed Monitor ID to run immediately.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_SAVE_PROFILE_SETUP_SESSIONPersist cookies and browser storage from a completed setup session into a Browser Context Profile, then clean up the temporary session. Persisted state and successful session cleanup cannot be undone. The response retains domain-level skips and failures plus cleanup status so partial success remains visible.

Input Parameters

string
required
Profile that should receive the setup session’s browser state.
string
required
Completed setup session whose cookies and browser storage should be persisted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_SEARCH_WEBSearch live web pages, news, or research papers with domain and time filters, optionally fetching result pages inline, and return exactly one caller-selected zero-based result page.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

integer
Zero-based result page (0-10).
string
required
Search query (1-2000 characters).
string
Why the results are needed, used by TinyFish to improve ranking.
string
Language code for results. TinyFish infers it from location, or defaults to en when both fields are omitted.
string
Country code for localized results. TinyFish infers it from language, or defaults to US when both fields are omitted.
string
Earliest publication date, inclusive (YYYY-MM-DD). Not compatible with recency_minutes or research_paper searches.
string
Latest publication date, inclusive (YYYY-MM-DD). Not compatible with recency_minutes or research_paper searches.
string ("web" | "news" | "research_paper")
Content corpus to search: web, news, or research_paper.
boolean
Fetch each result page inline with TinyFish’s default Fetch settings. Fetched content or per-result fetch errors are returned on each result.
array
Exclude results from these domains; sent as one comma-separated value.
array
Only return results from these domains; sent as one comma-separated value.
integer
Only return content from the last 1-5256000 minutes. Not compatible with date bounds or research_paper searches.
boolean
Request thumbnail URLs when available; sent as true or false.
integer
Maximum publication year, inclusive (0-9999). Valid only for research_paper searches.
integer
Minimum publication year, inclusive (0-9999). Valid only for research_paper searches.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_START_PROFILE_SETUP_SESSIONStart a billable temporary remote browser session for establishing login state in a Browser Context Profile. The returned browser state is not saved automatically: after setup, always call Save Profile Setup Session to persist it or Cancel Profile Setup Session to discard it and tear down the session.

Input Parameters

string
Optional absolute HTTP(S) URL or bare domain to open when the temporary setup browser starts. TinyFish prefixes bare domains with https://.
string
required
Browser Context Profile that will receive saved login and browser state.
integer
Requested lifetime of the billable temporary browser session in seconds (5-86400), subject to the account plan’s cap.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_START_RESEARCH_ASYNCStart a paid TinyFish research run in the background and return its run ID; managed Instant users must connect their own TinyFish account. A timeout does not prove rejection, so avoid automatically submitting the same research again.

Input Parameters

string ("auto" | "instant" | "standard" | "deep" | "max")
Research depth. Omit for deep; legacy auto selects standard.
string
required
Research question.
boolean
Whether synthesis events contain report text. The async response remains non-streaming and must be polled.
string
Include results on or after this date.
string
Standard or instant research session to continue.
string
Include results on or before this date.
string ("web" | "news" | "research_paper")
Source corpus to research.
string
Completed research run whose report and evidence seed this run.
object
Domain preferences or restrictions.
string
BCP 47 report language tag, such as en, ja, or pt-BR.
integer
Freshness window in minutes.
boolean
Allow relevant social and community sources.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_SYNC_VAULT_ITEMSRefresh display-safe item metadata from all password-manager vaults already connected to TinyFish. Synchronization can add, update, or remove mirrored items. Returns synchronization counts and allowlisted item metadata without credential or secret values.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_TERMINATE_BROWSER_SESSIONIdempotently terminate a remote TinyFish browser session to stop further browser usage charges. Already-ended sessions are also successful.

Input Parameters

string
required
Browser session to terminate; use only a session the caller owns.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_UPDATE_MONITORPause or resume a TinyFish Monitor, or edit its schedule and delivery metadata, using a connected TinyFish account. Status changes cannot be combined with other edits, and schedule or metadata edits require a schedule; type and target config are immutable.

Input Parameters

string
Replacement name. Explicit null clears it; omission preserves it.
string ("active" | "paused")
Resume or pause scheduled checks. This must be the only update field.
string
Replacement change purpose. Explicit null clears it; omission preserves it.
string
required
Monitor ID owned by the connected TinyFish account.
string
Replacement public HTTP or HTTPS callback. Explicit null clears it; omission preserves it.
string
Replacement five-field schedule, optionally prefixed by CRON_TZ=<IANA zone>. Required for schedule or metadata edits. TinyFish enforces the 30-minute Topic minimum because this PATCH does not include type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_UPDATE_PROFILERename a Browser Context Profile or change its default and proxy-country settings. Omitted fields remain unchanged.

Input Parameters

string
New profile name (1-100 characters); omit to leave it unchanged.
string
required
Browser Context Profile ID to update.
boolean
Whether this profile should be the account default; omit to leave it unchanged.
string ("US" | "GB" | "CA" | "AU" | "DE" | "FR" | "IT" | "ES" | "NL" | "JP" | "SG" | "BR" | "IN")
New proxy country; pass null explicitly to clear the setting, or omit the field to leave it unchanged.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TINYFISH_UPLOAD_PROFILE_STATEUpload cookies and local or session storage directly into a Browser Context Profile. This changes persistent login state and may transmit authentication secrets; call it only with the credential owner’s explicit authorization. TinyFish provides no rollback endpoint, so restoring prior state requires a caller-held copy or deleting the affected domains.

Input Parameters

array
required
Up to 3000 browser cookies. WARNING: cookies can grant account access; provide them only with the credential owner’s explicit authorization.
string
required
Browser Context Profile ID that should receive the uploaded state.
array
Up to 100 local-storage origin records. WARNING: values may contain authentication tokens or private user data.
array
Up to 100 session-storage origin records. WARNING: values may contain authentication tokens or private user data.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not