Sessions - Outcrawl

Every browser session, whether driven live or by an agent, produces a session with a replay. None of the three calls below has an MCP tool or a CLI command: a replay is something a person watches in a browser to check a charge, not something a model or a script can act on.

Get one session

import { Outcrawl } from '@outcrawl/sdk';

const oc = new Outcrawl();
const session = await oc.sessions.get('<id>');
console.log(session.replayUrl, session.duration, session.pages, session.usage);

import asyncio
from outcrawl import Outcrawl

async def main():
    async with Outcrawl() as oc:
        session = await oc.sessions.get("<id>")
        print(session.replay_url, session.duration, session.pages, session.usage)

asyncio.run(main())

curl https://api.outcrawl.ai/v1/sessions/<id> \
  -H "Authorization: Bearer ock_YOUR_KEY_ID.YOUR_SECRET"

Returns the replay URL, duration in milliseconds, page count and usage. This is how a charge gets disputed: watch what it bought. To follow a session that is still running instead of waiting for it to end, iterate session.live() in either SDK, or add ?live=true to the request.

A replay never autoplays. A person presses play.

List sessions

import { Outcrawl } from '@outcrawl/sdk';

const oc = new Outcrawl();
const sessions = await oc.sessions.list({ status: 'completed', since: '7d' });
for (const session of sessions) {
  console.log(session.id, session.outcome, session.replayUrl);
}

import asyncio
from outcrawl import Outcrawl

async def main():
    async with Outcrawl() as oc:
        sessions = await oc.sessions.list(status="completed", since="7d")
        for session in sessions:
            print(session["id"], session.get("outcome"), session.get("replayUrl"))

asyncio.run(main())

curl "https://api.outcrawl.ai/v1/sessions?status=completed&since=7d" \
  -H "Authorization: Bearer ock_YOUR_KEY_ID.YOUR_SECRET"

Query past sessions by status, outcome, task or age.

Export a session

import { Outcrawl } from '@outcrawl/sdk';

const oc = new Outcrawl();
const bundle = await oc.sessions.export('<id>', './session.outcrawl');
console.log(bundle.url, bundle.bytes, bundle.expiresAt);

import asyncio
from outcrawl import Outcrawl

async def main():
    async with Outcrawl() as oc:
        bundle = await oc.sessions.export("<id>")
        print(bundle["url"], bundle["bytes"], bundle["expiresAt"])

asyncio.run(main())

curl -X POST https://api.outcrawl.ai/v1/sessions/<id>/export \
  -H "Authorization: Bearer ock_YOUR_KEY_ID.YOUR_SECRET"

Exports a session as a portable bundle that plays back offline, for attaching to a ticket or an audit trail. The answer carries a download url and when it expires. The TypeScript SDK also downloads the bundle when you pass a file path; in Python, download it from url.