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必填
