Monitoring a run

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

const oc = new Outcrawl();
const run = await oc.agent.get('<id>');
console.log(run.status, run.goals, run.credits, run.data);

import asyncio
from outcrawl import Outcrawl

async def main():
    async with Outcrawl() as oc:
        run = await oc.agent.get("<id>")
        print(run["status"], run.get("goals"), run["credits"], run.get("data"))

asyncio.run(main())

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

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

const oc = new Outcrawl();
const events = oc.agent.events('<id>', { after: 0, level: 'step' });
for await (const record of events) {
  console.log(record.seq, record.kind, record.value);
}
console.log(events.cursor); // pass back as `after` to resume from here

import asyncio
from outcrawl import Outcrawl

async def main():
    async with Outcrawl() as oc:
        events = oc.agent.events("<id>", after=0, level="step")
        async for record in events:
            print(record["seq"], record["kind"], record["value"])
        print(events.cursor)  # pass back as `after` to resume from here

asyncio.run(main())

curl "https://api.outcrawl.ai/v1/agent/<id>/events?after=<cursor>&level=step" \
  -H "Authorization: Bearer ock_YOUR_KEY_ID.YOUR_SECRET"

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

const oc = new Outcrawl();
let cursor: string | undefined;
do {
  const page = await oc.agent.results('<id>', { cursor });
  for (const record of page) {
    console.log(record.kind, record.value);
  }
  cursor = page.cursor;
} while (cursor !== undefined);

import asyncio
from outcrawl import Outcrawl

async def main():
    async with Outcrawl() as oc:
        cursor = None
        while True:
            page = await oc.agent.results("<id>", cursor=cursor)
            for record in page:
                print(record["kind"], record["value"])
            cursor = page.cursor
            if cursor is None:
                break

asyncio.run(main())

curl "https://api.outcrawl.ai/v1/agent/<id>/results?cursor=<cursor>" \
  -H "Authorization: Bearer ock_YOUR_KEY_ID.YOUR_SECRET"

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

const oc = new Outcrawl();
const job = oc.agent({
  task: 'Report the title of the top story on Hacker News.',
  caps: { budget: '16.00' },
  webhook: 'https://yourapp.example/hooks/outcrawl',
});
console.log(await job.id());

import asyncio
from outcrawl import Outcrawl

async def main():
    async with Outcrawl() as oc:
        job = oc.agent(
            task="Report the title of the top story on Hacker News.",
            caps={"budget": "16.00"},
            webhook="https://yourapp.example/hooks/outcrawl",
        )
        print(await job.id())

asyncio.run(main())

curl https://api.outcrawl.ai/v1/agent \
  -H "Authorization: Bearer ock_YOUR_KEY_ID.YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "Report the title of the top story on Hacker News.",
    "caps": { "budget": "16.00" },
    "webhook": "https://yourapp.example/hooks/outcrawl"
  }'

x-outcrawl-signature: t=1758000000,v1=<base64url hmac>