search_businesses
Search the business directory
Find businesses on Agoria by free-text query, category, and/or city. Returns each business's slug plus the actions its agent can take, so you can act on it directly from this same connection.
输入参数cityquerycategory
search_market
Search everything for sale
Search individual items across every business on the network — property listings, vehicles, courses, products, services, events, plans — with typed filters, a price range and a radius around a place. Prefer this over search_businesses whenever the user is looking for a THING rather than a company. Returns items with prices, locations, photo counts and the seller's verification status.
输入参数kindpagesortlimitquerywherefiltersmaxPriceminPriceradiusKmverifiedOnly
ask_market
Search everything for sale, in one sentence
Same index as search_market, but takes a plain sentence — 'three bedroom house under 800k in Geelong', 'automatic ute under 80,000km' — and works out the filters itself. Use it when you have the user's own words; use search_market when you already know the exact filters.
输入参数question必填
get_item
Get one item for sale
Everything about a single item: full facets, photos, where it is, who is selling it and how well-proven they are, a price guide computed from comparable items on the network, and the adjacent services a buyer usually needs next (finance, inspection, conveyancing, transport).
输入参数ref必填
list_market_filters
List the item kinds and filters available
What can be searched and filtered on. Call this when you are unsure which `kind` or which `filters` keys search_market will accept.
输入参数kind
price_guide
What is a fair price?
A price distribution for comparable items on the network — asking prices, and where the network settled the sale, what buyers actually paid. Widens the comparison and says so when the exact match is too thin to be meaningful.
输入参数kind必填whereattributes必填
create_want
Tell the network what you're looking for
Save a standing search on the customer's behalf. They get told when matching supply appears, AND — anonymously, without their contact details — sellers who could satisfy it can see it and offer. Use this when search_market found nothing good: it converts a dead end into a request the market can answer.
输入参数namecadencecontact必填request必填
open_demand
What buyers are looking for and nobody is supplying
Open standing requests from real buyers, anonymised. Useful for a business deciding what to stock or list, and for understanding where the network has no supply at all.
输入参数kindwhereunmetOnly
resolve_place
Turn a place name into a point and a radius
Resolve a suburb, postcode or city to coordinates and the radius that name implies. Use it to check a place exists before passing it to search_market.
输入参数where必填
get_business
Get a business profile
Get full details for a business by slug: description, contact, hours, services, FAQs, and the actions its agent supports.
输入参数slug必填
list_products
List products at a business
List the products a business sells by slug — price/sale, availability/stock, brand, SKU/GTIN, variants, specs, dimensions.
输入参数slug必填query
get_reviews
Get reviews & rating for a business
Get a business's aggregate rating and reviews by slug. Optionally filter to a product/service id.
输入参数slug必填targetId
check_availability
Check availability at a business
Check open appointment slots for a service at a business on a date (YYYY-MM-DD).
输入参数date必填slug必填serviceId必填
book_appointment
Book an appointment at a business
Book an appointment at any business by slug. Confirm the slot with check_availability first.
输入参数noteslug必填startsAt必填serviceId必填customerName必填customerContact必填
take_action
Take an action at a business
Perform any non-booking action a business supports (request_quote, place_order, send_message, pay_invoice, sign_document, subscribe, register…). Get valid action ids and their fields from get_business. Pass the action's fields as a JSON object. If the result is 'action_required', hand the user the next.url (payment/signing link) or re-call with fields.confirmToken to confirm.
输入参数slug必填action必填fields必填
request_quotes
Get quotes from several businesses at once
Describe a job once and send it to the businesses that can price it. Each one answers with a real number, what it covers, and how long the price stands. Returns a briefToken — poll compare_quotes with it to see the prices as they land, then accept_quote to choose one. Use this instead of calling request_quote at each business separately.
输入参数slugstitlebudgetdetails必填categorylocationneededBycustomerNamecustomerContact必填
compare_quotes
Compare the quotes on a brief
See every business's answer to a brief side by side: price, what it covers, lead time, rating, whether the payment would be protected, and which is cheapest or soonest.
输入参数briefToken必填
accept_quote
Accept one of the quotes
Choose a business's quote. This creates a real order at that business and declines the others. If that business protects payments, the reply carries a payment link where the money is held by Agoria until the customer confirms they got the work — hand that link to the customer.
输入参数slug必填briefToken必填