Find businesses
find_businessesUse this when a person wants to book or ask about something on Bookatu and has no business in mind yet. Give the country and at least one of service, name or place (a town, city or area the person named, never their own position). Returns up to 10 businesses that chose to be found here, in name order, each with its city and area (never a street address), the languages it speaks, its lowest price, the services that match and its booking page. bookVia says how the business and each service are reached: assistant, website or enquiry, and a trip also has days. At a business whose bookVia is enquiry nothing is booked: the person asks it with send_enquiry. No business pays to be listed or placed. Do not use for a business you already know: pass it to get_business.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"country": "<country>"
},
"name": "find_businesses"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | The business's name, or part of it. | |
| limit | No | 1 to 10, 10 when not given. | |
| place | No | A town, city or area the person named. Never their own position. | |
| cursor | No | The nextCursor of the answer before, for the next page. | |
| speaks | No | A language the business should speak with the client (BCP 47). | |
| country | Yes | The country to look in, ISO 3166-1 alpha-2, such as NZ. | |
| service | No | What the person wants done, in their words. Matched against service names, categories and descriptions. | |
| language | No | The language to answer in (BCP 47). | |
| clientTimeZone | No | The client's IANA time zone, such as America/Toronto. Ask for their city when unsure. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | Yes | ||
| note | Yes | Results are not ads: no business pays for where it appears. | |
| businesses | Yes | ||
| nextCursor | Yes |