Python SDK

pip install outcrawl

import asyncio
from outcrawl import Outcrawl

async def main() -> None:
    async with Outcrawl() as oc:                       # reads OUTCRAWL_API_KEY
        doc = await oc.scrape("https://example.com", formats=["markdown"])
        print(doc.markdown)                             # or doc["markdown"], it is the wire object
        print(doc.usage)                                # every call returns what it cost

        job = oc.agent(
            task="Report the title of the top story on Hacker News.",
            caps={"budget": "16.00"},                    # the one ceiling a submit must carry
        )
        async for record in job:                        # the event cursor, while it runs
            print(record["kind"], record["value"])
        run = await job                                 # and the settled run, on the same job
        print(run["status"], run.get("data"))           # data is absent until there is an answer

asyncio.run(main())

import asyncio
from outcrawl import Outcrawl, ProfileInUseError, QuotaExceededError

async def main() -> None:
    async with Outcrawl() as oc:
        profile = await oc.profiles.create(label="acme-user-42")
        try:
            doc = await oc.scrape("https://example.com", profile=profile.id)
            print(doc.markdown)
        except ProfileInUseError as leased:
            print("profile busy until", leased.held_until)
        except QuotaExceededError as over:
            await asyncio.sleep(over.retry_after_seconds)

asyncio.run(main())