Search local businesses
search_businessesFind verified local service businesses by job description and location (postal code, district, neighbourhood or town in Germany). Recognises the trade from everyday words and asks back with options when unclear. Returns matching services with price ranges. Only businesses that confirmed their own data are in results. A separate list, unverified, can hold businesses from public data that are not on Bookvia: always marked verified: false, never part of results. If the customer says the job is urgent, pass urgent: true: businesses that state they react within one hour right now come first. The order follows how well a business fits and never depends on payment.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_businesses"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of results, default 10 | |
| query | No | Free text in German describing the job, e.g. "Steckdose in der Küche setzen" or "Heizungswartung" | |
| offset | No | Skip this many results. Use next_offset from the previous answer to get the next page | |
| urgent | No | true only if the customer said the job is urgent, e.g. the heating is off or water is leaking. Ask the customer; never conclude it from the kind of job. Businesses that state they react within one hour at this moment are then listed first, see reacts_within_1h | |
| category | No | Trade or industry to filter by | |
| district | No | Berlin district or neighbourhood, e.g. "Neukölln", "Kreuzberg", "Prenzlauer Berg" | |
| location | No | Where the job is, as the customer said it: German postal code, district, neighbourhood or town, e.g. "12047", "Kreuzberg", "Berlin-Neukölln". Preferred over district and postal_code. | |
| remote_ok | No | true if the customer is fine with a provider who works online or by phone instead of coming by. Ask the customer when the job needs nobody on site (tax, legal or business advice, coaching, translation, tutoring, web design, IT for offices). Businesses anywhere in Germany that work remotely are then included, local ones first | |
| postal_code | No | German 5-digit postal code of the job location |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | All matching businesses, not only the ones on this page | |
| notice | Yes | ||
| results | Yes | ||
| unverified | No | Separate list, never part of results or total: businesses from public data that are NOT on Bookvia and have not confirmed anything. Only filled when trade and place of the search are clear. Read unverified_notice before you mention one | |
| next_offset | No | Pass as offset to get the next page. null: there are no more results | |
| interpretation | Yes | What Bookvia understood: trade and location. Selected automatically at 80 % confidence or more. | |
| remote_available | No | More matching businesses that work remotely and were left out because remote_ok was not set | |
| unverified_notice | No | What you must tell the customer about the entries in unverified. Only set when unverified is not empty | |
| interpreted_district | Yes | District the location filter was mapped to | |
| unverified_attribution | No | Source of the entries in unverified. Show this line whenever you show one of them. Only set when unverified is not empty |