Python Client

pip install evomi-client

import asyncio
from evomi_client import EvomiClient

async def main():
    # Initialize with API key (or set EVOMI_API_KEY env var)
    client = EvomiClient(api_key="your-api-key")
    
    # Scrape a URL
    result = await client.scrape("https://example.com")
    print(result)
    
    # Get markdown output with auto JS detection
    result = await client.scrape(
        "https://example.com",
        output="markdown",
        mode="auto"
    )
    
    # AI-powered extraction
    result = await client.scrape(
        "https://example.com/products",
        ai_enhance=True,
        ai_prompt="Extract product names and prices"
    )

asyncio.run(main())

from evomi_client import EvomiClientSync

# Initialize with API key (or set EVOMI_API_KEY env var)
client = EvomiClientSync(api_key="your-api-key")

# Scrape a URL
result = client.scrape("https://example.com")
print(result)

export EVOMI_API_KEY="your-api-key"

client = EvomiClient(api_key="your-api-key")

client = EvomiClient(
    api_key="your-api-key",
    base_url="https://custom.evomi.com"
)

result = await client.crawl(
    domain="example.com",
    max_urls=100,
    depth=2,
    url_pattern="/products/.*",  # Regex filter
    async_mode=True  # Returns task_id
)

result = await client.map_website(
    domain="example.com",
    sources=["sitemap", "commoncrawl"],
    max_urls=500
)

result = await client.search_domains(
    query="best e-commerce sites in Germany",
    max_urls=20,
    region="de-de"
)

# Can also pass multiple queries
result = await client.search_domains(
    query=["online bookstores", "book shops UK"],
    max_urls=50,
    region="uk-en"
)

result = await client.agent_request(
    "Scrape example.com and extract all product prices"
)

result = await client.get_task_status(
    task_id="abc123",
    task_type="scrape"  # or "crawl", "map", "config_generate", "schema"
)

configs = await client.list_configs()

config = await client.create_config(
    name="My Scraper",
    config={"mode": "browser", "output": "markdown"}
)

config = await client.get_config("cfg_abc123")

config = await client.update_config("cfg_abc123", name="New Name")

await client.delete_config("cfg_abc123")

config = await client.generate_config(
    name="Amazon Scraper",
    prompt="Scrape product title, price, and reviews from Amazon"
)

schemas = await client.list_schemas()

schema = await client.create_schema(
    name="Product Schema",
    config={
        "url": "https://example.com/product",
        "extract_scheme": [
            {"label": "title", "type": "content", "selector": "h1"},
            {"label": "price", "type": "content", "selector": ".price"}
        ]
    },
    test=True  # Test the schema
)

status = await client.get_schema_status("sch_abc123")

schedule = await client.create_schedule(
    name="Daily Price Check",
    config_id="cfg_abc123",
    interval_minutes=1440,  # Daily
    start_time="09:00"  # UTC
)

schedules = await client.list_schedules(active_only=True)

await client.toggle_schedule("sched_abc123")

runs = await client.list_schedule_runs("sched_abc123")

storage = await client.create_storage_config(
    name="My S3",
    storage_type="s3_compatible",
    config={
        "bucket": "my-bucket",
        "region": "us-east-1",
        "access_key": "...",
        "secret_key": "..."
    },
    set_as_default=True
)

configs = await client.list_storage_configs()

info = await client.get_account_info()
print(f"Credits remaining: {info.get('credits', 'N/A')}")

import httpx
from evomi_client import EvomiClient

client = EvomiClient(api_key="your-key")

try:
    result = await client.scrape("https://example.com")
except httpx.HTTPStatusError as e:
    print(f"HTTP error: {e.response.status_code}")
    print(f"Response: {e.response.text}")
except httpx.RequestError as e:
    print(f"Request error: {e}")