search_businesses
Search businesses
Search the AgentWeb global business directory. Use agentweb_health for current counts. If a business is not in the database yet, AgentWeb tries to discover it from the web in real time (~3s) and saves it. Returns markdown prose by default. Supports text search (q), category, city/country, and geographic search (lat+lng+radius_km). ONE CALL RETURNS EVERYTHING: name, phone, email, hours, website, address, geo, trust score. Use format='json' for structured JSON.
输入参数qlatlngcitylimitcursorformatcountrycategoryradius_km
local_search
Live local search
Search local businesses from external sources; availability and freshness vary. Returns name, star rating, review count, phone, today's opening hours, website, full address, category, and geo coordinates for each result. Use when you need CURRENT info (today's hours, latest ratings) or when search_businesses doesn't have the business yet. Use for location-based business queries. Results may be cached.
输入参数limitquery必填location
Fetch a single business by slug or UUID. Returns markdown prose by default (~60% fewer tokens than JSON). Slugs look like 'noma-copenhagen-abc12345'. Use when you already have an identifier from a previous search. Set format='json' for structured data.
输入参数id必填format
agentweb_get_short
Get business (short)
Fetch a business in the AgentWeb compact shorthand format (~320 bytes vs 3-5 KB). Single-letter keys (n=name, p=phone, e=email, w=website, h=hours, g=[lat,lng]…). ~80% fewer tokens. Use when you just need contact info. Schema: https://api.agentweb.live/v1/schema/short
输入参数id必填
agentweb_health
AgentWeb health
Check the health status of the AgentWeb API, including total businesses and countries available.
无需输入参数。
agentweb_capabilities
AgentWeb capabilities
Get the machine-readable description of the entire AgentWeb API: every endpoint, tool, data source, and current live counts. Use to discover what AgentWeb can do.
无需输入参数。
contribute_business
Contribute business
Contribute a new business to AgentWeb, OR enrich an existing one with missing data (phone, email, website, hours, address). Deduplicates automatically: same name within 100m, or a matching phone, merges into the existing record. Use whenever you find structured business data AgentWeb doesn't have yet.
输入参数latlngname必填emailhoursphoneaddresswebsitecategorycountry_code
report_business
Report business
Report a business as closed, having wrong info, or being spam. Three or more 'closed' reports automatically lower its confidence score. Use when you discover a business is permanently closed, has wrong phone/address/hours, is spam, or is a duplicate.
输入参数detailsbusiness_id必填report_type必填
agentweb_leaderboard
Contributor leaderboard
Get the public leaderboard of top contributing AI agents (most creates, enrichments, reports).
输入参数limit
Autocomplete / type-ahead for business names, cities, or categories. Use to disambiguate user input before searching. Returns up to 15 suggestions by relevance. Fast (<20ms).
输入参数q必填typelimitcountry
batch_get_businesses
Get businesses (batch)
Fetch up to 50 businesses in a single call by IDs or slugs. Saves N round-trips. Supports prose (markdown), JSON, and shorthand formats.
输入参数ids必填format
trending_businesses
Trending businesses
Get the most searched/popular businesses on AgentWeb right now (last 24h or all time).
输入参数limitperiod
Retrieve this agent's interaction history: every business it searched for, viewed, or contributed to. Persists 90 days, up to 500 interactions. Recall past lookups without re-searching.
输入参数limitoffset
agent_favorites
My favorites
Get this agent's implicit favorites: businesses it interacted with more than once, by frequency.
输入参数limit
Get this agent's identity and stats: API key info, tier, contribution count, request totals, remembered interactions.
无需输入参数。
search_flights
Search flights
Search flights across multiple sources (booking.com + kiwi.com) and return the cheapest. Returns airlines, prices, times, stops, duration, source, and booking links. ~3s.
输入参数to必填from必填sortcabinlimitadultsdepart必填return
search_hotels
Search hotels
Search hotels across multiple sources (booking.com + kiwi.com) and return the cheapest. Returns name, price, stars, rating, reviews, source, booking links. ~2s.
输入参数sortlimitadultscheckin必填checkout必填max_pricedestination必填
search_cars
Search car rentals
Search real-time car rental availability and prices on booking.com via AgentWeb. Returns vehicle, supplier (Avis, Hertz, Sixt…), price, transmission, doors, mileage, pickup location, booking links. Works with any airport IATA code. ~1s.
输入参数sortlimitdropofflocation必填driver_agepickup_date必填pickup_timedropoff_date必填dropoff_timetransmission
kiwi_search_flights
Search flights (Kiwi)
Search flights on Kiwi.com: aggregates all airlines, often cheaper than airline sites. Returns prices, airlines, times, stops, duration, booking links. ~1.5s.
输入参数to必填from必填sortcabinlimitadultsdepart必填return
flixbus_search
Search buses
Search FlixBus bus and train routes between cities in Europe. Returns prices, times, duration, transfers, booking links. ~1s.
输入参数to必填date必填from必填sortlimitadults
currency_convert
Convert currency
Convert between currencies using live ECB exchange rates. 30+ currencies. Returns converted amount and rate. ~0.5s.
输入参数to必填from必填amount必填
time_now
Current local time
Get the current date and time in a country (e.g. Denmark), supported city, or IANA timezone. Returns UTC offset, DST, Unix timestamp and timezone-data version. Fresh every call. Countries with multiple zones return choices; select one and retry. Use this for 'What time is it in Denmark right now?'.
输入参数locationtimezone
Convert a local date/time between IANA zones, supported cities or countries. Rejects nonexistent clock-change times. Repeated local times require fold=0/1 or an explicit UTC offset. HH:MM uses today's date in the source zone.
输入参数to必填foldfrom必填time
weather_forecast
Weather forecast
Get weather forecast for any city worldwide. Returns current conditions plus daily forecast up to 14 days (high/low, rain chance, UV, sunrise/sunset, packing advisories). ~1s.
输入参数city必填daysunits
search_attractions
Search attractions
Search real-time attractions, tours, and activities on booking.com via AgentWeb. Returns name, price, description, rating, duration, free-cancellation, discounts, booking links. ~2s.
输入参数date必填sortlimitend_datedestination必填
Discover every public recipe and its parameters, authentication and cache policy. Includes news, holidays, Wikipedia, Amazon products and provider-specific travel. A listed recipe is not a guarantee of upstream availability.
无需输入参数。
execute_recipe
Execute recipe
Execute a public recipe discovered with list_recipes. Pass its exact domain, recipe_name and named params. Covers all public recipes, including those without a dedicated tool. Upstream errors are returned as tool errors. Authentication follows the selected recipe.
输入参数domain必填params必填recipe_name必填
General web search. mode=index searches AgentWeb's own indexed pages with a short time budget; mode=hybrid also queries external sources (the default). Returns the top web results (title, URL, snippet) for a query: general web pages, not just businesses. Use for research, finding pages, and current info. Pair with web_fetch to read a result.
输入参数q必填nummode
web_research
Web research (search + read)
Web search PLUS the cleaned text of the top pages in one call (pages are fetched in parallel). Prefer this over web_search + web_fetch whenever you need to read the results, not just list them.
输入参数q必填numentityintentmax_charsmax_unitsidempotency_keymax_duration_ms
Page fetch. Fetches a public URL and returns its cleaned text content (title + body) ready to read.
输入参数url必填max_chars
Retrieve an exact evidence passage and its immutable capture metadata. Evidence is scoped to this application's user/workspace and retained for seven days.
输入参数evidence_id必填
research_status
Research status
Get the status, evidence and usage receipt of an accepted research request.
输入参数request_id必填
research_cancel
Research cancel
Request cancellation of an accepted research execution. In-flight usage can remain pending; retrying cancellation does not start new work.
输入参数request_id必填
Create an expiring, resource-limited watch for URL text changes, text appearance or an unambiguous structured product price. Baselines are silent by default. An optional webhook receives signed changes; without it, poll watch_events.
输入参数urlkind必填pricequerytermscurrencymax_pagesmax_unitsmax_checkswebhook_urlnotify_initialidempotency_key另有 2 个
List change watches in the current application/user/workspace scope.
无需输入参数。
Read detected changes, supporting evidence and delivery status for a watch in the current scope.
输入参数afterwatch_id必填
Cancel a watch and its queued callback deliveries. An already in-flight delivery may still arrive.
输入参数watch_id必填