Developer APIs

For Autonomous Agents

Built for LangChain, CrewAI, OpenAI Agents SDK, AutoGPT, and custom agent frameworks.

LangChain Tool Definitions

Copy and register these as agent tools at startup:

from langchain.tools import tool
import httpx

BASE = "http://localhost:8000"

@tool
def scrape_url(url: str, category: str = "auto") -> dict:
    """Trigger real-time price & product intelligence extraction from any institutional URL.
    Returns structured records with pricing, category, confidence score and entity info.
    Args:
        url: The target page URL to scrape (e.g. 'https://econet.co.zw/usd-data-bundles')
        category: Sector label ('telecoms', 'banking', 'insurance', 'retail')
    """
    resp = httpx.post(f"{BASE}/api/v1/manual-scrape/",
                      json={"url": url, "category": category, "extractor_type": "auto"},
                      timeout=90)
    return resp.json()

@tool
def get_records(category: str = None, market: str = None, limit: int = 50) -> list:
    """Retrieve already-extracted and stored intelligence records.
    Useful for comparing prices, detecting changes, or feeding analysis pipelines.
    Args:
        category: Filter by sector (optional)
        market:   Filter by market geography (optional)
        limit:    Maximum records to return (default 50)
    """
    params = {"limit": limit}
    if category: params["category"] = category
    if market:   params["market"]   = market
    return httpx.get(f"{BASE}/api/v1/records/", params=params).json()

@tool
def list_sources() -> list:
    """Get all configured crawling sources — their URLs, categories, and schedules.
    Use this before choosing which URL to scrape."""
    return httpx.get(f"{BASE}/api/v1/sources/").json()

@tool
def get_organizations(category: str = None) -> list:
    """Browse the registry of tracked Zimbabwean institutional entities.
    Returns names, slugs, categories, and latest change events."""
    params = {"category": category} if category else {}
    return httpx.get(f"{BASE}/api/v1/organizations/", params=params).json()

Webhook Subscriptions (Real-time Alerts)

Let the platform notify your agent when new data arrives instead of polling:

import httpx

# Subscribe your agent's callback URL
httpx.post("http://localhost:8000/api/v1/webhook-targets/", json={
    "name":         "My Agent Hook",
    "url":          "https://my-agent.example.com/on-new-record",
    "secret":       "my-hmac-secret",
    "is_active":    True
})

# List active subscriptions
subs = httpx.get("http://localhost:8000/api/v1/webhook-targets/").json()
print(subs)

Recommended Agent Workflow