Profiles - Outcrawl

A profile keeps a pinned exit and persistent storage, cookies and logins that survive across sessions. Pass one to a browser session or an agent run to keep a login rather than signing in fresh every time.

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

const oc = new Outcrawl();
const profile = await oc.profiles.create({ label: 'acme-user-42' });
const profiles = await oc.profiles.list();

import asyncio
from outcrawl import Outcrawl

async def main() -> None:
    async with Outcrawl() as oc:
        profile = await oc.profiles.create(label="acme-user-42")
        profiles = await oc.profiles.list()

asyncio.run(main())

curl -X POST https://api.outcrawl.ai/v1/profiles \
  -H "Authorization: Bearer ock_YOUR_KEY_ID.YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"label": "acme-user-42"}'

curl https://api.outcrawl.ai/v1/profiles -H "Authorization: Bearer ock_YOUR_KEY_ID.YOUR_SECRET"

Rules

Leased while open. A second concurrent use of the same profile is refused rather than silently forking its cookies.
Delete is irreversible. It removes the profile’s stored cookies and site data permanently.
Filter profiles.list by a label glob to find one quickly across a large account.

Browsers

A profile is what keeps a browser session’s login intact.