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")

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 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())