agentweb

Python SDK for AgentWeb.live — the global business directory for AI agents.

Search 11M+ businesses across 195 countries via a simple API.

Installation

pip install agentweb

Quick Start

from agentweb import AgentWebClient

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

# Search for businesses
results = client.search("coffee shop", country="US", limit=5)
print(results)

# Geo search
results = client.search("restaurant", lat=40.7128, lng=-74.0060, radius_km=2)

# Get a single business
biz = client.get_business("some-business-id")

# Health check
status = client.health()

API Reference

AgentWebClient(api_key, base_url=..., timeout=30)

Create a client. Get your API key at agentweb.live.

client.search(q, *, lat, lng, radius_km, country, limit)

Search for businesses. All parameters except q are optional.

client.get_business(business_id)

Fetch a single business by its AgentWeb ID.

client.health()

Check API health and stats.

License

MIT