Browser API Reference

async def get_inspector_url(base_url: str) -> str:
    async with httpx.AsyncClient() as client:
        for _ in range(20):
            pages = (await client.get(f"{base_url}/pages", timeout=5)).json()
            nav = next((p for p in pages if p.get("url") not in ("", "about:blank", "about:newtab")), None)
            if nav:
                return nav["devtoolsFrontendUrl"]
            await asyncio.sleep(1)
    raise TimeoutError("navigation never completed")

async function getInspectorUrl(baseUrl: string): Promise<string> {
  for (let i = 0; i < 20; i++) {
    const res = await fetch(`${baseUrl}/pages`);
    const pages: { url: string; devtoolsFrontendUrl: string }[] = await res.json();
    const nav = pages.find(p => !['', 'about:blank', 'about:newtab'].includes(p.url));
    if (nav) return nav.devtoolsFrontendUrl;
    await new Promise(r => setTimeout(r, 1000));
  }
  throw new Error('navigation never completed');
}

from tinyfish import TinyFish

client = TinyFish()
session = client.browser.sessions.create(url="https://www.tinyfish.ai")
print(session.session_id)
print(session.cdp_url)

import { TinyFish } from "@tiny-fish/sdk";

const client = new TinyFish();
const session = await client.browser.sessions.create({
  url: "https://www.tinyfish.ai",
});
console.log(session.session_id);
console.log(session.cdp_url);

import asyncio
from tinyfish import TinyFish
from playwright.async_api import async_playwright

client = TinyFish()

async def main():
    # 1. Create a browser session
    session = client.browser.sessions.create(url="https://scrapeme.live/shop")

    # 2. Connect via Playwright CDP
    async with async_playwright() as p:
        browser = await p.chromium.connect_over_cdp(session.cdp_url)
        await asyncio.sleep(2)  # let startup navigation settle

        page = browser.contexts[0].pages[0]
        await page.wait_for_load_state("domcontentloaded")

        # 3. Interact with the page
        print(await page.title())
        await page.screenshot(path="shop.png")

    # Session auto-cleans up after 1 hour of inactivity

asyncio.run(main())

import { TinyFish } from "@tiny-fish/sdk";
import { chromium } from "playwright";

const client = new TinyFish();

// 1. Create a browser session
const session = await client.browser.sessions.create({
  url: "https://scrapeme.live/shop",
});

// 2. Connect via Playwright CDP
const browser = await chromium.connectOverCDP(session.cdp_url);
await new Promise((r) => setTimeout(r, 2000)); // let startup navigation settle

const page = browser.contexts()[0].pages()[0];
await page.waitForLoadState("domcontentloaded");

// 3. Interact with the page
console.log(await page.title());
await page.screenshot({ path: "shop.png" });

// Session auto-cleans up after 1 hour of inactivity