search_beaches
Find public beaches by city or consented coordinates and rank them for swimming, family, warm-water, low-wind, surf, accessibility or amenities. Returns compact results with BeachFinder links.
Parameters11
| query | string | optional | Beach, activity or free-text search |
| city | string | optional | Destination city; use this instead of coordinates |
| country | string | optional | |
| lat | number | optional | Latitude supplied with user consent |
| lng | number | optional | Longitude supplied with user consent |
| radiusKm | number | optional | |
| limit | integer | optional | |
| lang | string | optional | |
| intent | string | optional | |
| maxWindKmh | number | optional | |
| minWaterTempC | number | optional |
Raw schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 90,
"description": "Beach, activity or free-text search"
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 90,
"description": "Destination city; use this instead of coordinates"
},
"country": {
"type": "string",
"minLength": 2,
"maxLength": 60
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90,
"description": "Latitude supplied with user consent"
},
"lng": {
"type": "number",
"minimum": -180,
"maximum": 180,
"description": "Longitude supplied with user consent"
},
"radiusKm": {
"type": "number",
"minimum": 1,
"maximum": 150,
"default": 50
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 5
},
"lang": {
"type": "string",
"enum": [
"en",
"fr",
"es",
"de",
"it",
"pt",
"nl",
"ja",
"ko",
"zh",
"ar",
"tr",
"ru",
"id"
],
"default": "en"
},
"intent": {
"type": "string",
"enum": [
"general",
"swimming",
"family",
"low-wind",
"warm-water",
"surf",
"accessible",
"amenities"
],
"default": "general"
},
"maxWindKmh": {
"type": "number",
"minimum": 0,
"maximum": 150
},
"minWaterTempC": {
"type": "number",
"minimum": -5,
"maximum": 45
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}