AgentWeb.live — Global Business Directory for AI Agents

API base: https://api.agentweb.live/v1

Homepage: https://agentweb.live

Setup

An API key is required. Check for AGENTWEB_API_KEY env var first. If not set, ask the user:

> "To search AgentWeb's business directory, you'll need a free API key. You can either:

> 1. Sign up at https://agentweb.live and paste me the key

> 2. Give me your email and I'll register for you right now (your email is sent to agentweb.live to create the key)

>

> Which do you prefer?"

If they choose option 2, register via curl:

curl -s -X POST https://api.agentweb.live/v1/register \
  -H 'Content-Type: application/json' \
  -d '{"email": "USER_EMAIL", "name": "OpenClaw Agent"}'

Save the returned api_key value and use it for all subsequent requests in this session. Suggest the user sets AGENTWEB_API_KEY in their environment to skip this next time.

Auth: ?api_key=KEY or header X-API-Key: KEY

Endpoints

Search businesses

curl -s "https://api.agentweb.live/v1/search?q=thai+restaurant&lat=55.67&lng=12.56&radius_km=5&limit=10&api_key=KEY"

Parameters (all optional): q (text), category, lat+lng+radius_km (geo), country_code (ISO 2-letter), limit (1-100).

Get business details

curl -s "https://api.agentweb.live/v1/business/UUID?api_key=KEY"

Returns: name, phone_numbers, email, website, address, opening_hours, category, coordinates, trust score.

Contribute a business

curl -s -X POST "https://api.agentweb.live/v1/contribute?api_key=KEY" \
  -H 'Content-Type: application/json' \
  -d '{"name": "Business Name", "phone": "+45 12345678", "category": "restaurant", "country_code": "DK"}'

Only name is required. Optional: phone, email, website, category, address (object), country_code, hours (object), lat, lng.

Important: Always ask the user for approval before contributing data. Only contribute publicly available business information.

Report a problem

curl -s -X POST "https://api.agentweb.live/v1/report?api_key=KEY" \
  -H 'Content-Type: application/json' \
  -d '{"business_id": "UUID", "report_type": "closed", "details": "Permanently closed"}'

Types: closed, wrong_phone, wrong_address, wrong_hours, spam, duplicate, other.

Workflow

1. Search or get business → use the data
2. If data is missing or business not found, and you find it elsewhere → ask the user if they'd like to contribute it, then POST /v1/contribute
3. If data is wrong → POST /v1/report

Privacy: Never contribute personal/private data. Only contribute publicly available business information (name, public phone, public website, address, hours).

Rate Limits

100 requests/minute per key (free tier). 429 response includes retry_after seconds.

Full API Reference

For detailed response formats and all parameters, read references/api-docs.md.