fresha_search_venues
Search Fresha's salon, barber and wellness marketplace and return one page of venues: each venue's id, slug, name, canonical page URL, address with coordinates, business-type label, average rating with its rating count, rating badge, cover image and distance, plus the gateway's own match count and a forward cursor. Pass a latitude/longitude pair to search a place; with neither, the gateway falls back to its own default centre, which is not your market, and the response reports the centre it used. query, min_price, service_gender (EVERYONE, MALE, FEMALE), awards (BEST_IN_CLASS, HIGHLY_RECOMMENDED), sort (DISTANCE, RATING, RECOMMENDED) and the three treatment ids from fresha_taxonomy all change the result set. first is 1 to 200, and larger values are rejected because the gateway rejects them too. Page with next_cursor as after while has_next_page is true; a page past the end is an empty list, count 0 with no error is an honest empty result for a valid filter, and a malformed cursor silently restarts at page one, so a repeated first page does not mean a different result set. Use fresha_taxonomy first when you want a treatment filter: a well-formed id that does not exist returns zero results rather than an error. Results carry no price; fresha_venue is the only tool that returns one.
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": "fresha_search_venues"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Optional result ordering, one of: DISTANCE, RATING, RECOMMENDED. Omit for the gateway's own default, which is the same order as RECOMMENDED. | |
| after | No | Opaque forward cursor: pass next_cursor from the previous page, or omit for the first page. A page past the end returns zero venues. A malformed cursor is NOT an error upstream: it silently restarts the list at page 1, so do not treat a repeated first page as a different result set. | |
| first | No | Venues per page, default 20, maximum 200. Larger values are rejected because the gateway rejects them too (201 answers Outside of range); the gateway's own fallback for an omitted or zero value is 60, and this route always sends a concrete value. | |
| query | No | Optional free-text query matched by Fresha's own venue search. Empty means no keyword filter. | |
| awards | No | Optional Fresha award filter, one of: BEST_IN_CLASS, HIGHLY_RECOMMENDED. The gateway's own argument is a list; this route exposes one value and sends it as a one-element list. | |
| latitude | No | Optional latitude of the search centre. Supply it together with longitude; with neither, the gateway uses its own default centre. | |
| longitude | No | Optional longitude of the search centre. Supply it together with latitude. | |
| min_price | No | Optional minimum service price in the market's own currency, as the gateway's own filter takes it. A search result carries no price: check a venue's own service menu, which is the only place this API publishes prices. | |
| service_gender | No | Optional venue gender focus, one of: EVERYONE, MALE, FEMALE. The gateway's own argument is a list; this route exposes one value and sends it as a one-element list. | |
| treatment_tag_id | No | Optional taxonomy tag id in the form tag:<slug>, from fresha-taxonomy. Any other shape is rejected; a well-formed id that does not exist returns zero results without an error. | |
| treatment_type_id | No | Optional taxonomy treatment id in the form treatment:<category-slug>/<type-slug>, from fresha-taxonomy. Any other shape is rejected; a well-formed id that does not exist returns zero results without an error. | |
| treatment_category_id | No | Optional taxonomy category id in the form category:<slug>, from fresha-taxonomy. Any other shape is rejected; a well-formed id that does not exist returns zero results without an error. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | The tool result payload (shape varies per tool; see each tool's docs resource). |