Skip to main content
Glama

Search places

search_places
Read-onlyIdempotent

Find places for an intent near a location

The core call. Give one or more categories (exact names like "Coffee", or ids from list_categories; all must match) and a location — a city name or an area_id from list_areas, or coordinates with a radius — and get places ranked by Atly's score for those categories, each with quotable reasons from real reviews, a link to cite, a Google Maps link, whether it is open now, and when Atly added and last refreshed it. The first three also carry hours, contact and good-to-know. Scores are 0–10 and relative to other places in the same country; a place with no score is unmeasured, not bad. The order also weighs how many reviews back each category score (so it is not always by score) and, on a gluten-free ask, its gluten_free.safety rating. For most dishes and drinks, classes, tours and event or travel companies rank lower than the places that serve them, and doc_notes names any that moved; to get those, pass place_type. If no place matches every category, trailing categories are dropped until something does (the first is never dropped), and dropped_categories says which. Ranking considers the strongest 100 candidates by Atly's base score (400 with place_type); dropped_categories lists the dropped ones as you sent them.

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": {
      "categories": "<categories>"
    },
    "name": "search_places"
  }
}

Input Schema

NameRequiredDescriptionDefault
latNo
lonNo
limitNoPlaces to return, at most 25; a larger value returns 25.
area_idNoAn id from `list_areas`; the search covers that area's viewport. A city name also works ("Austin", "Boise, ID"): it resolves to the matching area, or, for a city with no area, to the extent of the places whose address is in it, only if Atly has at least five there (`list_areas` says whether it does); the response's `area` and doc_notes say what it resolved to. Give this or lat/lon, not both.
radius_kmNoUsed with lat/lon, in km. Held to 0.2-50 (doc_notes say so when it was).
categoriesYesCategory names or ids, most important first. Every result matches all of them (after any relaxation). A name that is not exact is refused, with the close matches in the error.
place_typeNoOptional. Keep only places whose Google place type contains one of these words, matched as whole words: "restaurant" keeps "Mexican restaurant" and "Pizza restaurant", "coffee" keeps "Coffee shop", "bar" keeps "Wine bar" but not "Barber shop". A place matches on its main type (`place_type` in results) or any of its other Google types. Use it when the user asks for a kind of venue ("gluten-free restaurants"), not a dish or a feature. Google's types are literal: "Cafe" and "Coffee shop" are different, so for cafes pass both ["cafe", "coffee"]. The filter is applied to the strongest 400 places for the categories and never relaxed.

Output Schema

NameRequiredDescriptionDefault
areaNoThe resolved search geometry — an area (id, name, level, center, bbox), a city known only from its places (name, level, region, country, center, bbox; no id), or a circle (center, radius_km).
placesNo
call_idNo
doc_notesNo
total_matchedNoHow many places match in this area, capped ("1000+"). Absent with `place_type` (the count cannot see place types) or when counting timed out.
dropped_categoriesNoCategories dropped to avoid an empty result, as you sent them (a name or an id).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / area_id / description
      Previous value: -"An id from `list_areas`; the search covers that area's viewport. A city name also works (\"Austin\", \"Boise, ID\"): it resolves to the matching area, or, for a city with no area, to the extent of the places whose address is in it; the response's `area` and doc_notes say what it resolved to. Give this or lat/lon, not both."New value: +"An id from `list_areas`; the search covers that area's viewport. A city name also works (\"Austin\", \"Boise, ID\"): it resolves to the matching area, or, for a city with no area, to the extent of the places whose address is in it, only if Atly has at least five there (`list_areas` says whether it does); the response's `area` and doc_notes say what it resolved to. Give this or lat/lon, not both."
  2. Changed1 schema field changed
    • changedOutput schema / properties / places / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "additionalProperties": {},
      -      "properties": {
      -        "added_at": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "When Atly added the place. Not a freshness date."
      -        },
      -        "address": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "blurb": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "One-line editorial summary."
      -        },
      -        "business_status": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "category_scores": {
      -          "anyOf": [
      -            {
      -              "items": {
      -                "additionalProperties": {},
      -                "properties": {
      -                  "category_id": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "name": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "reviews": {
      -                    "anyOf": [
      -                      {
      -                        "maximum": 9007199254740991,
      -                        "minimum": -9007199254740991,
      -                        "type": "integer"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ],
      -                    "description": "Reviews that mention this category."
      -                  },
      -                  "score": {
      -                    "anyOf": [
      -                      {
      -                        "type": "number"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ],
      -                    "description": "This category's own 0–10 score. Absent when it fails the test score uses (the place is closed, has under 36 reviews, or too few of its reviews mention this category); reviews is still given. Show no score for it then."
      -                  }
      -                },
      -                "type": "object"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "data_refreshed_at": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "When Atly last refreshed the place's data from its sources. Absent when unknown."
      -        },
      -        "distance_km": {
      -          "anyOf": [
      -            {
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "From the search center: the coordinates given, or the area's center (the middle of its bounding box when it has one)."
      -        },
      -        "gluten_free": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": {},
      -              "properties": {
      -                "dedicated_fryer": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "YES",
      -                        "NO",
      -                        "UNKNOWN",
      -                        "NOT_APPLICABLE"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "dedicated_kitchen": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "YES",
      -                        "NO",
      -                        "UNKNOWN",
      -                        "NOT_APPLICABLE"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "menu": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "DEDICATED_GF_MENU",
      -                        "GF_OPTIONS_MARKED",
      -                        "GF_OPTIONS_NOT_MARKED",
      -                        "UNKNOWN"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "safety": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "100% dedicated gluten-free",
      -                        "celiac friendly (low risk of cross-contamination)",
      -                        "accommodating (some risk of cross-contamination)",
      -                        "discuss cross-contamination with staff"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "trained_staff": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "YES",
      -                        "NO",
      -                        "UNKNOWN",
      -                        "NOT_APPLICABLE"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "verified_by_atly": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Present only for places with a gluten-free identity."
      -        },
      -        "good_to_know": {
      -          "anyOf": [
      -            {
      -              "items": {
      -                "type": "string"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "google_rating": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "hours": {
      -          "anyOf": [
      -            {
      -              "items": {
      -                "additionalProperties": {},
      -                "properties": {
      -                  "close": {
      -                    "type": "string"
      -                  },
      -                  "close_day": {
      -                    "anyOf": [
      -                      {
      -                        "enum": [
      -                          "sun",
      -                          "mon",
      -                          "tue",
      -                          "wed",
      -                          "thu",
      -                          "fri",
      -                          "sat"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ]
      -                  },
      -                  "day": {
      -                    "enum": [
      -                      "sun",
      -                      "mon",
      -                      "tue",
      -                      "wed",
      -                      "thu",
      -                      "fri",
      -                      "sat"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  "open": {
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "day",
      -                  "open",
      -                  "close"
      -                ],
      -                "type": "object"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Weekly opening hours in the place's local time, one entry per opening (a day can have several). close 24:00 means it closes at midnight; close_day is set when it closes after midnight, on that day. In get_place and the first search results; absent when unknown."
      -        },
      -        "hours_updated_at": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "When the opening hours were last updated. Absent when there are no hours or no date. Over a year old (or absent with hours), say they may have changed and suggest checking with the place."
      -        },
      -        "id": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "lat": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "lon": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "maps_url": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Google Maps link for the place (directions), from its Google place id. Not an Atly page: cite url for Atly."
      -        },
      -        "menu_url": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "name": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "open_now": {
      -          "anyOf": [
      -            {
      -              "type": "boolean"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Open at the time of the response, by its hours and timezone; false when the place is closed temporarily or for good. Absent when its hours or timezone are unknown. As fresh as the hours: see hours_updated_at."
      -        },
      -        "phone": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "place_type": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "price": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "reasons": {
      -          "anyOf": [
      -            {
      -              "items": {
      -                "additionalProperties": {},
      -                "properties": {
      -                  "kind": {
      -                    "anyOf": [
      -                      {
      -                        "type": "string"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ],
      -                    "description": "What the statement is about: Specific Food, Specific Drink, Specific Alcohol (a named dish or drink), Food, Drink, Alcohol, Ambiance, Service, Amenity, Event, Establishment Features or Non-Specific Informative. A gluten-safety warning can carry another, such as Personal Experience, Ambiguous or Other."
      -                  },
      -                  "sentiment": {
      -                    "anyOf": [
      -                      {
      -                        "enum": [
      -                          "positive",
      -                          "neutral",
      -                          "negative"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ]
      -                  },
      -                  "text": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  }
      -                },
      -                "type": "object"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Short first-person statements from real reviews, most useful first. Quote them."
      -        },
      -        "reservation_url": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "review_count": {
      -          "anyOf": [
      -            {
      -              "maximum": 9007199254740991,
      -              "minimum": -9007199254740991,
      -              "type": "integer"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "score": {
      -          "anyOf": [
      -            {
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Atly score 0–10 — for the requested categories in search, the overall score in get_place — relative to other places in the same country. Absent when unmeasured (too few reviews, closed, or, in search, a requested category that too few of its reviews mention)."
      -        },
      -        "timezone": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "IANA timezone of the place."
      -        },
      -        "url": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Canonical Atly page. Link it when you cite. Absent when the place has no page yet."
      -        },
      -        "website": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "added_at": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "When Atly added the place. Not a freshness date."
      +        },
      +        "address": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "blurb": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "One-line editorial summary."
      +        },
      +        "business_status": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "category_scores": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "additionalProperties": {},
      +                "properties": {
      +                  "category_id": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "name": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "reviews": {
      +                    "anyOf": [
      +                      {
      +                        "maximum": 9007199254740991,
      +                        "minimum": -9007199254740991,
      +                        "type": "integer"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ],
      +                    "description": "Reviews that mention this category."
      +                  },
      +                  "score": {
      +                    "anyOf": [
      +                      {
      +                        "type": "number"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ],
      +                    "description": "This category's own 0–10 score. Absent when it fails the test score uses (the place is closed, has under 36 reviews, or too few of its reviews mention this category); reviews is still given. Show no score for it then."
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "data_refreshed_at": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "When Atly last refreshed the place's data from its sources. Absent when unknown."
      +        },
      +        "distance_km": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "From the search center: the coordinates given, or the area's center (the middle of its bounding box when it has one)."
      +        },
      +        "gluten_free": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {},
      +              "properties": {
      +                "dedicated_fryer": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "YES",
      +                        "NO",
      +                        "UNKNOWN",
      +                        "NOT_APPLICABLE"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "dedicated_kitchen": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "YES",
      +                        "NO",
      +                        "UNKNOWN",
      +                        "NOT_APPLICABLE"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "menu": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "DEDICATED_GF_MENU",
      +                        "GF_OPTIONS_MARKED",
      +                        "GF_OPTIONS_NOT_MARKED",
      +                        "UNKNOWN"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "safety": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "100% dedicated gluten-free",
      +                        "celiac friendly (low risk of cross-contamination)",
      +                        "accommodating (some risk of cross-contamination)",
      +                        "discuss cross-contamination with staff"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "trained_staff": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "YES",
      +                        "NO",
      +                        "UNKNOWN",
      +                        "NOT_APPLICABLE"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "verified_by_atly": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Present only for places with a gluten-free identity."
      +        },
      +        "good_to_know": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "google_rating": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "hours": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "additionalProperties": {},
      +                "properties": {
      +                  "close": {
      +                    "type": "string"
      +                  },
      +                  "close_day": {
      +                    "anyOf": [
      +                      {
      +                        "enum": [
      +                          "sun",
      +                          "mon",
      +                          "tue",
      +                          "wed",
      +                          "thu",
      +                          "fri",
      +                          "sat"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "day": {
      +                    "enum": [
      +                      "sun",
      +                      "mon",
      +                      "tue",
      +                      "wed",
      +                      "thu",
      +                      "fri",
      +                      "sat"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "open": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "day",
      +                  "open",
      +                  "close"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Weekly opening hours in the place's local time, one entry per opening (a day can have several). close 24:00 means it closes at midnight; close_day is set when it closes after midnight, on that day. In get_place and the first search results; absent when unknown."
      +        },
      +        "hours_updated_at": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "When the opening hours were last updated. Absent when there are no hours or no date. Over a year old (or absent with hours), say they may have changed and suggest checking with the place."
      +        },
      +        "id": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "lat": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "lon": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "maps_url": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Google Maps link for the place (directions), from its Google place id. Not an Atly page: cite url for Atly."
      +        },
      +        "menu_url": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "name": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "open_now": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Open at the time of the response, by its hours and timezone; false when the place is closed temporarily or for good. Absent when its hours or timezone are unknown. As fresh as the hours: see hours_updated_at."
      +        },
      +        "phone": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "place_type": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "price": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "reasons": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "additionalProperties": {},
      +                "properties": {
      +                  "kind": {
      +                    "anyOf": [
      +                      {
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ],
      +                    "description": "What the statement is about: Specific Food, Specific Drink, Specific Alcohol (a named dish or drink), Food, Drink, Alcohol, Ambiance, Service, Amenity, Event, Establishment Features or Non-Specific Informative. Personal Experience (a reviewer's own story) appears at most once per requested category, only for one that no positive statement of those kinds names. A gluten-safety warning can be of any kind, such as Personal Experience, Ambiguous or Other."
      +                  },
      +                  "sentiment": {
      +                    "anyOf": [
      +                      {
      +                        "enum": [
      +                          "positive",
      +                          "neutral",
      +                          "negative"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "text": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Short first-person statements from real reviews, most useful first. Quote them."
      +        },
      +        "reservation_url": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "review_count": {
      +          "anyOf": [
      +            {
      +              "maximum": 9007199254740991,
      +              "minimum": -9007199254740991,
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "score": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Atly score 0–10, relative to other places in the same country. In get_place, the overall score. In search, the Atly app's blend of the overall score with the scores on the requested categories, so even with one category it can differ from that category's own category_scores score: quote score for how good the place is for the ask, the category's score for how reviewers rate that one thing. Absent when unmeasured (too few reviews, closed, or, in search, a requested category that too few of its reviews mention)."
      +        },
      +        "timezone": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "IANA timezone of the place."
      +        },
      +        "url": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Canonical Atly page. Link it when you cite. Absent when the place has no page yet."
      +        },
      +        "website": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  3. Changed2 schema fields changed
    • changedOutput schema / properties / area / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {},
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "bbox": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "type": "number"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "[west, south, east, north]; absent when unknown and for a circle."
      +      },
      +      "center": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "type": "number"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "[lon, lat]"
      +      },
      +      "country": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "For a city known only from its places."
      +      },
      +      "id": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "The area's id (list_areas). Absent for a city known only from its places and for a circle."
      +      },
      +      "level": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "city, neighborhood or state."
      +      },
      +      "name": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "radius_km": {
      +        "anyOf": [
      +          {
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "For a circle (coordinates given), the radius searched."
      +      },
      +      "region": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "For a city known only from its places, its state or equivalent."
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / places / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "additionalProperties": {},
      -      "properties": {
      -        "added_at": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "When Atly added the place. Not a freshness date."
      -        },
      -        "address": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "blurb": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "One-line editorial summary."
      -        },
      -        "business_status": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "category_scores": {
      -          "anyOf": [
      -            {
      -              "items": {
      -                "additionalProperties": {},
      -                "properties": {
      -                  "category_id": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "name": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "reviews": {
      -                    "anyOf": [
      -                      {
      -                        "maximum": 9007199254740991,
      -                        "minimum": -9007199254740991,
      -                        "type": "integer"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ],
      -                    "description": "Reviews that mention this category."
      -                  },
      -                  "score": {
      -                    "type": [
      -                      "number",
      -                      "null"
      -                    ]
      -                  }
      -                },
      -                "type": "object"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "data_refreshed_at": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "When Atly last refreshed the place's data from its sources. Absent when unknown."
      -        },
      -        "distance_km": {
      -          "anyOf": [
      -            {
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "From the search center: the coordinates given, or the area's center (the middle of its bounding box when it has one)."
      -        },
      -        "gluten_free": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": {},
      -              "properties": {
      -                "dedicated_fryer": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "YES",
      -                        "NO",
      -                        "UNKNOWN",
      -                        "NOT_APPLICABLE"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "dedicated_kitchen": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "YES",
      -                        "NO",
      -                        "UNKNOWN",
      -                        "NOT_APPLICABLE"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "menu": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "DEDICATED_GF_MENU",
      -                        "GF_OPTIONS_MARKED",
      -                        "GF_OPTIONS_NOT_MARKED",
      -                        "UNKNOWN"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "safety": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "100% dedicated gluten-free",
      -                        "celiac friendly (low risk of cross-contamination)",
      -                        "accommodating (some risk of cross-contamination)",
      -                        "discuss cross-contamination with staff"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "trained_staff": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "YES",
      -                        "NO",
      -                        "UNKNOWN",
      -                        "NOT_APPLICABLE"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "verified_by_atly": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Present only for places with a gluten-free identity."
      -        },
      -        "good_to_know": {
      -          "anyOf": [
      -            {
      -              "items": {
      -                "type": "string"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "google_rating": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "hours": {
      -          "anyOf": [
      -            {
      -              "items": {
      -                "additionalProperties": {},
      -                "properties": {
      -                  "close": {
      -                    "type": "string"
      -                  },
      -                  "close_day": {
      -                    "anyOf": [
      -                      {
      -                        "enum": [
      -                          "sun",
      -                          "mon",
      -                          "tue",
      -                          "wed",
      -                          "thu",
      -                          "fri",
      -                          "sat"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ]
      -                  },
      -                  "day": {
      -                    "enum": [
      -                      "sun",
      -                      "mon",
      -                      "tue",
      -                      "wed",
      -                      "thu",
      -                      "fri",
      -                      "sat"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  "open": {
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "day",
      -                  "open",
      -                  "close"
      -                ],
      -                "type": "object"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Weekly opening hours in the place's local time, one entry per opening (a day can have several). close 24:00 means it closes at midnight; close_day is set when it closes after midnight, on that day. In get_place and the first search results; absent when unknown."
      -        },
      -        "hours_updated_at": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "When the opening hours were last updated. Absent when there are no hours or no date. Over a year old (or absent with hours), say they may have changed and suggest checking with the place."
      -        },
      -        "id": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "lat": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "lon": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "maps_url": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Google Maps link for the place (directions), from its Google place id. Not an Atly page: cite url for Atly."
      -        },
      -        "menu_url": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "name": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "open_now": {
      -          "anyOf": [
      -            {
      -              "type": "boolean"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Open at the time of the response, by its hours and timezone; false when the place is closed temporarily or for good. Absent when its hours or timezone are unknown. As fresh as the hours: see hours_updated_at."
      -        },
      -        "phone": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "place_type": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "price": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "reasons": {
      -          "anyOf": [
      -            {
      -              "items": {
      -                "additionalProperties": {},
      -                "properties": {
      -                  "kind": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "sentiment": {
      -                    "anyOf": [
      -                      {
      -                        "enum": [
      -                          "positive",
      -                          "neutral",
      -                          "negative"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ]
      -                  },
      -                  "text": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  }
      -                },
      -                "type": "object"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Short first-person statements from real reviews, most useful first. Quote them."
      -        },
      -        "reservation_url": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "review_count": {
      -          "anyOf": [
      -            {
      -              "maximum": 9007199254740991,
      -              "minimum": -9007199254740991,
      -              "type": "integer"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "score": {
      -          "anyOf": [
      -            {
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Atly score 0–10 — for the requested categories in search, the overall score in get_place — relative to other places in the same country. Absent when unmeasured (too few reviews, or closed)."
      -        },
      -        "timezone": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "IANA timezone of the place."
      -        },
      -        "url": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Canonical Atly page. Link it when you cite. Absent when the place has no page yet."
      -        },
      -        "website": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "added_at": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "When Atly added the place. Not a freshness date."
      +        },
      +        "address": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "blurb": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "One-line editorial summary."
      +        },
      +        "business_status": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "category_scores": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "additionalProperties": {},
      +                "properties": {
      +                  "category_id": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "name": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "reviews": {
      +                    "anyOf": [
      +                      {
      +                        "maximum": 9007199254740991,
      +                        "minimum": -9007199254740991,
      +                        "type": "integer"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ],
      +                    "description": "Reviews that mention this category."
      +                  },
      +                  "score": {
      +                    "anyOf": [
      +                      {
      +                        "type": "number"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ],
      +                    "description": "This category's own 0–10 score. Absent when it fails the test score uses (the place is closed, has under 36 reviews, or too few of its reviews mention this category); reviews is still given. Show no score for it then."
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "data_refreshed_at": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "When Atly last refreshed the place's data from its sources. Absent when unknown."
      +        },
      +        "distance_km": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "From the search center: the coordinates given, or the area's center (the middle of its bounding box when it has one)."
      +        },
      +        "gluten_free": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {},
      +              "properties": {
      +                "dedicated_fryer": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "YES",
      +                        "NO",
      +                        "UNKNOWN",
      +                        "NOT_APPLICABLE"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "dedicated_kitchen": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "YES",
      +                        "NO",
      +                        "UNKNOWN",
      +                        "NOT_APPLICABLE"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "menu": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "DEDICATED_GF_MENU",
      +                        "GF_OPTIONS_MARKED",
      +                        "GF_OPTIONS_NOT_MARKED",
      +                        "UNKNOWN"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "safety": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "100% dedicated gluten-free",
      +                        "celiac friendly (low risk of cross-contamination)",
      +                        "accommodating (some risk of cross-contamination)",
      +                        "discuss cross-contamination with staff"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "trained_staff": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "YES",
      +                        "NO",
      +                        "UNKNOWN",
      +                        "NOT_APPLICABLE"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "verified_by_atly": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Present only for places with a gluten-free identity."
      +        },
      +        "good_to_know": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "google_rating": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "hours": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "additionalProperties": {},
      +                "properties": {
      +                  "close": {
      +                    "type": "string"
      +                  },
      +                  "close_day": {
      +                    "anyOf": [
      +                      {
      +                        "enum": [
      +                          "sun",
      +                          "mon",
      +                          "tue",
      +                          "wed",
      +                          "thu",
      +                          "fri",
      +                          "sat"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "day": {
      +                    "enum": [
      +                      "sun",
      +                      "mon",
      +                      "tue",
      +                      "wed",
      +                      "thu",
      +                      "fri",
      +                      "sat"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "open": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "day",
      +                  "open",
      +                  "close"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Weekly opening hours in the place's local time, one entry per opening (a day can have several). close 24:00 means it closes at midnight; close_day is set when it closes after midnight, on that day. In get_place and the first search results; absent when unknown."
      +        },
      +        "hours_updated_at": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "When the opening hours were last updated. Absent when there are no hours or no date. Over a year old (or absent with hours), say they may have changed and suggest checking with the place."
      +        },
      +        "id": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "lat": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "lon": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "maps_url": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Google Maps link for the place (directions), from its Google place id. Not an Atly page: cite url for Atly."
      +        },
      +        "menu_url": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "name": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "open_now": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Open at the time of the response, by its hours and timezone; false when the place is closed temporarily or for good. Absent when its hours or timezone are unknown. As fresh as the hours: see hours_updated_at."
      +        },
      +        "phone": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "place_type": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "price": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "reasons": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "additionalProperties": {},
      +                "properties": {
      +                  "kind": {
      +                    "anyOf": [
      +                      {
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ],
      +                    "description": "What the statement is about: Specific Food, Specific Drink, Specific Alcohol (a named dish or drink), Food, Drink, Alcohol, Ambiance, Service, Amenity, Event, Establishment Features or Non-Specific Informative. A gluten-safety warning can carry another, such as Personal Experience, Ambiguous or Other."
      +                  },
      +                  "sentiment": {
      +                    "anyOf": [
      +                      {
      +                        "enum": [
      +                          "positive",
      +                          "neutral",
      +                          "negative"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "text": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Short first-person statements from real reviews, most useful first. Quote them."
      +        },
      +        "reservation_url": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "review_count": {
      +          "anyOf": [
      +            {
      +              "maximum": 9007199254740991,
      +              "minimum": -9007199254740991,
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "score": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Atly score 0–10 — for the requested categories in search, the overall score in get_place — relative to other places in the same country. Absent when unmeasured (too few reviews, closed, or, in search, a requested category that too few of its reviews mention)."
      +        },
      +        "timezone": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "IANA timezone of the place."
      +        },
      +        "url": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Canonical Atly page. Link it when you cite. Absent when the place has no page yet."
      +        },
      +        "website": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  4. Changed1 schema field changed
    • changedOutput schema / properties / places / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "additionalProperties": {},
      -      "properties": {
      -        "added_at": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "When Atly added the place. Not a freshness date."
      -        },
      -        "address": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "blurb": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "One-line editorial summary."
      -        },
      -        "business_status": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "category_scores": {
      -          "anyOf": [
      -            {
      -              "items": {
      -                "additionalProperties": {},
      -                "properties": {
      -                  "category_id": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "name": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "reviews": {
      -                    "anyOf": [
      -                      {
      -                        "maximum": 9007199254740991,
      -                        "minimum": -9007199254740991,
      -                        "type": "integer"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ],
      -                    "description": "Reviews that mention this category."
      -                  },
      -                  "score": {
      -                    "type": [
      -                      "number",
      -                      "null"
      -                    ]
      -                  }
      -                },
      -                "type": "object"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "data_refreshed_at": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "When Atly last refreshed the place's data from its sources. Absent when unknown."
      -        },
      -        "distance_km": {
      -          "anyOf": [
      -            {
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "From the search center: the coordinates given, or the area's center (the middle of its bounding box when it has one)."
      -        },
      -        "gluten_free": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": {},
      -              "properties": {
      -                "dedicated_fryer": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "dedicated_kitchen": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "menu": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "safety": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "100% dedicated gluten-free",
      -                        "celiac friendly (low risk of cross-contamination)",
      -                        "accommodating (some risk of cross-contamination)",
      -                        "discuss cross-contamination with staff"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "trained_staff": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "verified_by_atly": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Present only for places with a gluten-free identity."
      -        },
      -        "good_to_know": {
      -          "anyOf": [
      -            {
      -              "items": {
      -                "type": "string"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "google_rating": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "hours": {
      -          "anyOf": [
      -            {
      -              "items": {
      -                "additionalProperties": {},
      -                "properties": {
      -                  "close": {
      -                    "type": "string"
      -                  },
      -                  "close_day": {
      -                    "anyOf": [
      -                      {
      -                        "enum": [
      -                          "sun",
      -                          "mon",
      -                          "tue",
      -                          "wed",
      -                          "thu",
      -                          "fri",
      -                          "sat"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ]
      -                  },
      -                  "day": {
      -                    "enum": [
      -                      "sun",
      -                      "mon",
      -                      "tue",
      -                      "wed",
      -                      "thu",
      -                      "fri",
      -                      "sat"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  "open": {
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "day",
      -                  "open",
      -                  "close"
      -                ],
      -                "type": "object"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Weekly opening hours in the place's local time, one entry per opening (a day can have several). close 24:00 means it closes at midnight; close_day is set when it closes after midnight, on that day. In get_place and the first search results; absent when unknown."
      -        },
      -        "hours_updated_at": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "When the opening hours were last updated. Absent when there are no hours or no date. Over a year old (or absent with hours), say they may have changed and suggest checking with the place."
      -        },
      -        "id": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "lat": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "lon": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "maps_url": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Google Maps link for the place (directions), from its Google place id. Not an Atly page: cite url for Atly."
      -        },
      -        "menu_url": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "name": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "open_now": {
      -          "anyOf": [
      -            {
      -              "type": "boolean"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Open at the time of the response, by its hours and timezone; false when the place is closed temporarily or for good. Absent when its hours or timezone are unknown. As fresh as the hours: see hours_updated_at."
      -        },
      -        "phone": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "place_type": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "price": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "reasons": {
      -          "anyOf": [
      -            {
      -              "items": {
      -                "additionalProperties": {},
      -                "properties": {
      -                  "kind": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "sentiment": {
      -                    "anyOf": [
      -                      {
      -                        "enum": [
      -                          "positive",
      -                          "neutral",
      -                          "negative"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ]
      -                  },
      -                  "text": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  }
      -                },
      -                "type": "object"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Short first-person statements from real reviews, most useful first. Quote them."
      -        },
      -        "reservation_url": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "review_count": {
      -          "anyOf": [
      -            {
      -              "maximum": 9007199254740991,
      -              "minimum": -9007199254740991,
      -              "type": "integer"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "score": {
      -          "anyOf": [
      -            {
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Atly score 0–10 — for the requested categories in search, the overall score in get_place — relative to other places in the same country. Absent when unmeasured (too few reviews, or closed)."
      -        },
      -        "timezone": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "IANA timezone of the place."
      -        },
      -        "url": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Canonical Atly page. Link it when you cite. Absent when the place has no page yet."
      -        },
      -        "website": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "added_at": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "When Atly added the place. Not a freshness date."
      +        },
      +        "address": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "blurb": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "One-line editorial summary."
      +        },
      +        "business_status": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "category_scores": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "additionalProperties": {},
      +                "properties": {
      +                  "category_id": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "name": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "reviews": {
      +                    "anyOf": [
      +                      {
      +                        "maximum": 9007199254740991,
      +                        "minimum": -9007199254740991,
      +                        "type": "integer"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ],
      +                    "description": "Reviews that mention this category."
      +                  },
      +                  "score": {
      +                    "type": [
      +                      "number",
      +                      "null"
      +                    ]
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "data_refreshed_at": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "When Atly last refreshed the place's data from its sources. Absent when unknown."
      +        },
      +        "distance_km": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "From the search center: the coordinates given, or the area's center (the middle of its bounding box when it has one)."
      +        },
      +        "gluten_free": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {},
      +              "properties": {
      +                "dedicated_fryer": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "YES",
      +                        "NO",
      +                        "UNKNOWN",
      +                        "NOT_APPLICABLE"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "dedicated_kitchen": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "YES",
      +                        "NO",
      +                        "UNKNOWN",
      +                        "NOT_APPLICABLE"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "menu": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "DEDICATED_GF_MENU",
      +                        "GF_OPTIONS_MARKED",
      +                        "GF_OPTIONS_NOT_MARKED",
      +                        "UNKNOWN"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "safety": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "100% dedicated gluten-free",
      +                        "celiac friendly (low risk of cross-contamination)",
      +                        "accommodating (some risk of cross-contamination)",
      +                        "discuss cross-contamination with staff"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "trained_staff": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "YES",
      +                        "NO",
      +                        "UNKNOWN",
      +                        "NOT_APPLICABLE"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "verified_by_atly": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Present only for places with a gluten-free identity."
      +        },
      +        "good_to_know": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "google_rating": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "hours": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "additionalProperties": {},
      +                "properties": {
      +                  "close": {
      +                    "type": "string"
      +                  },
      +                  "close_day": {
      +                    "anyOf": [
      +                      {
      +                        "enum": [
      +                          "sun",
      +                          "mon",
      +                          "tue",
      +                          "wed",
      +                          "thu",
      +                          "fri",
      +                          "sat"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "day": {
      +                    "enum": [
      +                      "sun",
      +                      "mon",
      +                      "tue",
      +                      "wed",
      +                      "thu",
      +                      "fri",
      +                      "sat"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "open": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "day",
      +                  "open",
      +                  "close"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Weekly opening hours in the place's local time, one entry per opening (a day can have several). close 24:00 means it closes at midnight; close_day is set when it closes after midnight, on that day. In get_place and the first search results; absent when unknown."
      +        },
      +        "hours_updated_at": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "When the opening hours were last updated. Absent when there are no hours or no date. Over a year old (or absent with hours), say they may have changed and suggest checking with the place."
      +        },
      +        "id": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "lat": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "lon": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "maps_url": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Google Maps link for the place (directions), from its Google place id. Not an Atly page: cite url for Atly."
      +        },
      +        "menu_url": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "name": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "open_now": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Open at the time of the response, by its hours and timezone; false when the place is closed temporarily or for good. Absent when its hours or timezone are unknown. As fresh as the hours: see hours_updated_at."
      +        },
      +        "phone": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "place_type": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "price": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "reasons": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "additionalProperties": {},
      +                "properties": {
      +                  "kind": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "sentiment": {
      +                    "anyOf": [
      +                      {
      +                        "enum": [
      +                          "positive",
      +                          "neutral",
      +                          "negative"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "text": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Short first-person statements from real reviews, most useful first. Quote them."
      +        },
      +        "reservation_url": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "review_count": {
      +          "anyOf": [
      +            {
      +              "maximum": 9007199254740991,
      +              "minimum": -9007199254740991,
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "score": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Atly score 0–10 — for the requested categories in search, the overall score in get_place — relative to other places in the same country. Absent when unmeasured (too few reviews, or closed)."
      +        },
      +        "timezone": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "IANA timezone of the place."
      +        },
      +        "url": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Canonical Atly page. Link it when you cite. Absent when the place has no page yet."
      +        },
      +        "website": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  5. Changed3 schema fields changed
    • changedInput schema / properties / categories / description
      Previous value: -"Category names or ids, most important first. Every result matches all of them (after any relaxation). A name that is not exact is refused (400) with the close matches in the error."New value: +"Category names or ids, most important first. Every result matches all of them (after any relaxation). A name that is not exact is refused, with the close matches in the error."
    • changedOutput schema / properties / places / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "additionalProperties": {},
      -      "properties": {
      -        "added_at": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "When Atly added the place. Not a freshness date."
      -        },
      -        "address": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "blurb": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "One-line editorial summary."
      -        },
      -        "business_status": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "category_scores": {
      -          "anyOf": [
      -            {
      -              "items": {
      -                "additionalProperties": {},
      -                "properties": {
      -                  "category_id": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "name": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "reviews": {
      -                    "anyOf": [
      -                      {
      -                        "maximum": 9007199254740991,
      -                        "minimum": -9007199254740991,
      -                        "type": "integer"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ],
      -                    "description": "Reviews that mention this category."
      -                  },
      -                  "score": {
      -                    "type": [
      -                      "number",
      -                      "null"
      -                    ]
      -                  }
      -                },
      -                "type": "object"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "data_refreshed_at": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "When Atly last refreshed the place's data from its sources. Absent when unknown."
      -        },
      -        "distance_km": {
      -          "anyOf": [
      -            {
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "From the search center."
      -        },
      -        "gluten_free": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": {},
      -              "properties": {
      -                "dedicated_fryer": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "dedicated_kitchen": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "menu": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "safety": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "100% dedicated gluten-free",
      -                        "celiac friendly (low risk of cross-contamination)",
      -                        "accommodating (some risk of cross-contamination)",
      -                        "discuss cross-contamination with staff"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "trained_staff": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "verified_by_atly": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Present only for places with a gluten-free identity."
      -        },
      -        "good_to_know": {
      -          "anyOf": [
      -            {
      -              "items": {
      -                "type": "string"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "google_rating": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "hours": {
      -          "anyOf": [
      -            {
      -              "items": {
      -                "additionalProperties": {},
      -                "properties": {
      -                  "close": {
      -                    "type": "string"
      -                  },
      -                  "close_day": {
      -                    "anyOf": [
      -                      {
      -                        "enum": [
      -                          "sun",
      -                          "mon",
      -                          "tue",
      -                          "wed",
      -                          "thu",
      -                          "fri",
      -                          "sat"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ]
      -                  },
      -                  "day": {
      -                    "enum": [
      -                      "sun",
      -                      "mon",
      -                      "tue",
      -                      "wed",
      -                      "thu",
      -                      "fri",
      -                      "sat"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  "open": {
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "day",
      -                  "open",
      -                  "close"
      -                ],
      -                "type": "object"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Weekly opening hours in the place's local time, one entry per opening (a day can have several). close 24:00 means it closes at midnight; close_day is set when it closes after midnight, on that day. In get_place and the first search results; absent when unknown."
      -        },
      -        "hours_updated_at": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "When the opening hours were last updated. Absent when there are no hours or no date. Over a year old (or absent with hours), say they may have changed and suggest checking with the place."
      -        },
      -        "id": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "lat": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "lon": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "maps_url": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Google Maps link for the place (directions), from its Google place id. Not an Atly page: cite url for Atly."
      -        },
      -        "menu_url": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "name": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "open_now": {
      -          "anyOf": [
      -            {
      -              "type": "boolean"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Open at the time of the response, by its hours and timezone; false when the place is closed temporarily or for good. Absent when its hours or timezone are unknown. As fresh as the hours: see hours_updated_at."
      -        },
      -        "phone": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "place_type": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "price": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "reasons": {
      -          "anyOf": [
      -            {
      -              "items": {
      -                "additionalProperties": {},
      -                "properties": {
      -                  "kind": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "sentiment": {
      -                    "anyOf": [
      -                      {
      -                        "enum": [
      -                          "positive",
      -                          "neutral",
      -                          "negative"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ]
      -                  },
      -                  "text": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  }
      -                },
      -                "type": "object"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Short first-person statements from real reviews, most useful first. Quote them."
      -        },
      -        "reservation_url": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "review_count": {
      -          "anyOf": [
      -            {
      -              "maximum": 9007199254740991,
      -              "minimum": -9007199254740991,
      -              "type": "integer"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "score": {
      -          "anyOf": [
      -            {
      -              "type": "number"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Atly score 0–10 — for the requested categories in search, the overall score in get_place — relative to other places in the same country. Absent when unmeasured (too few reviews, or closed)."
      -        },
      -        "timezone": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "IANA timezone of the place."
      -        },
      -        "url": {
      -          "anyOf": [
      -            {
      -              "type": "string"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Canonical Atly page. Link it when you cite. Absent when the place has no page yet."
      -        },
      -        "website": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "added_at": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "When Atly added the place. Not a freshness date."
      +        },
      +        "address": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "blurb": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "One-line editorial summary."
      +        },
      +        "business_status": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "category_scores": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "additionalProperties": {},
      +                "properties": {
      +                  "category_id": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "name": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "reviews": {
      +                    "anyOf": [
      +                      {
      +                        "maximum": 9007199254740991,
      +                        "minimum": -9007199254740991,
      +                        "type": "integer"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ],
      +                    "description": "Reviews that mention this category."
      +                  },
      +                  "score": {
      +                    "type": [
      +                      "number",
      +                      "null"
      +                    ]
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "data_refreshed_at": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "When Atly last refreshed the place's data from its sources. Absent when unknown."
      +        },
      +        "distance_km": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "From the search center: the coordinates given, or the area's center (the middle of its bounding box when it has one)."
      +        },
      +        "gluten_free": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {},
      +              "properties": {
      +                "dedicated_fryer": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "dedicated_kitchen": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "menu": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "safety": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "100% dedicated gluten-free",
      +                        "celiac friendly (low risk of cross-contamination)",
      +                        "accommodating (some risk of cross-contamination)",
      +                        "discuss cross-contamination with staff"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "trained_staff": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "verified_by_atly": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Present only for places with a gluten-free identity."
      +        },
      +        "good_to_know": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "google_rating": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "hours": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "additionalProperties": {},
      +                "properties": {
      +                  "close": {
      +                    "type": "string"
      +                  },
      +                  "close_day": {
      +                    "anyOf": [
      +                      {
      +                        "enum": [
      +                          "sun",
      +                          "mon",
      +                          "tue",
      +                          "wed",
      +                          "thu",
      +                          "fri",
      +                          "sat"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "day": {
      +                    "enum": [
      +                      "sun",
      +                      "mon",
      +                      "tue",
      +                      "wed",
      +                      "thu",
      +                      "fri",
      +                      "sat"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "open": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "day",
      +                  "open",
      +                  "close"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Weekly opening hours in the place's local time, one entry per opening (a day can have several). close 24:00 means it closes at midnight; close_day is set when it closes after midnight, on that day. In get_place and the first search results; absent when unknown."
      +        },
      +        "hours_updated_at": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "When the opening hours were last updated. Absent when there are no hours or no date. Over a year old (or absent with hours), say they may have changed and suggest checking with the place."
      +        },
      +        "id": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "lat": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "lon": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "maps_url": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Google Maps link for the place (directions), from its Google place id. Not an Atly page: cite url for Atly."
      +        },
      +        "menu_url": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "name": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "open_now": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Open at the time of the response, by its hours and timezone; false when the place is closed temporarily or for good. Absent when its hours or timezone are unknown. As fresh as the hours: see hours_updated_at."
      +        },
      +        "phone": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "place_type": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "price": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "reasons": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "additionalProperties": {},
      +                "properties": {
      +                  "kind": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "sentiment": {
      +                    "anyOf": [
      +                      {
      +                        "enum": [
      +                          "positive",
      +                          "neutral",
      +                          "negative"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "text": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Short first-person statements from real reviews, most useful first. Quote them."
      +        },
      +        "reservation_url": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "review_count": {
      +          "anyOf": [
      +            {
      +              "maximum": 9007199254740991,
      +              "minimum": -9007199254740991,
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "score": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Atly score 0–10 — for the requested categories in search, the overall score in get_place — relative to other places in the same country. Absent when unmeasured (too few reviews, or closed)."
      +        },
      +        "timezone": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "IANA timezone of the place."
      +        },
      +        "url": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Canonical Atly page. Link it when you cite. Absent when the place has no page yet."
      +        },
      +        "website": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / total_matched / description
      Previous value: -"How many places match in this area, capped (\"1000+\"). Absent when counting timed out."New value: +"How many places match in this area, capped (\"1000+\"). Absent with `place_type` (the count cannot see place types) or when counting timed out."
  6. Changed11 schema fields changed
    • changedInput schema / properties / categories / description
      Previous value: -"Category ids, most important first. Every result matches all of them (after any relaxation)."New value: +"Category names or ids, most important first. Every result matches all of them (after any relaxation). A name that is not exact is refused (400) with the close matches in the error."
    • addedInput schema / properties / limit / maximum
      Added value: +9007199254740991
    • addedInput schema / properties / radius_km / anyOf
      Added value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / radius_km / description
      Previous value: -"Used with lat/lon."New value: +"Used with lat/lon, in km. Held to 0.2-50 (doc_notes say so when it was)."
    • removedInput schema / properties / radius_km / type
      Removed value: -"number"
    • changedOutput schema / additionalProperties
      Previous value: -falseNew value: +{}
    • changedOutput schema / properties / area / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "description": "The resolved search geometry — an area (id, name, level, center, bbox), a city known only from its places (name, level, region, country, center, bbox; no id), or a circle (center, radius_km).",
      -    "properties": {},
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {},
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / dropped_categories / anyOf
      Previous value: -[
      -  {
      -    "description": "Category ids dropped to avoid an empty result.",
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / dropped_categories / description
      Previous value: -"Category ids dropped to avoid an empty result."New value: +"Categories dropped to avoid an empty result, as you sent them (a name or an id)."
    • changedOutput schema / properties / places / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "address": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "blurb": {
      -          "description": "One-line editorial summary.",
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "category_scores": {
      -          "anyOf": [
      -            {
      -              "items": {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "category_id": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "name": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "reviews": {
      -                    "anyOf": [
      -                      {
      -                        "description": "Reviews that mention this category.",
      -                        "type": "integer"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ],
      -                    "description": "Reviews that mention this category."
      -                  },
      -                  "score": {
      -                    "type": [
      -                      "number",
      -                      "null"
      -                    ]
      -                  }
      -                },
      -                "type": "object"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "distance_km": {
      -          "description": "From the search center.",
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "gluten_free": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": false,
      -              "description": "Present only for places with a gluten-free identity.",
      -              "properties": {
      -                "dedicated_fryer": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "dedicated_kitchen": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "menu": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "safety": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "100% dedicated gluten-free",
      -                        "celiac friendly (low risk of cross-contamination)",
      -                        "accommodating (some risk of cross-contamination)",
      -                        "discuss cross-contamination with staff"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "trained_staff": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "verified_by_atly": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Present only for places with a gluten-free identity."
      -        },
      -        "google_rating": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "id": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "last_updated": {
      -          "description": "When Atly last refreshed this place's data from its sources. Absent when unknown; never the date the place was added.",
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "lat": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "lon": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "name": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "place_type": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "price": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "reasons": {
      -          "anyOf": [
      -            {
      -              "description": "Short first-person statements from real reviews, most useful first. Quote them.",
      -              "items": {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "kind": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "sentiment": {
      -                    "anyOf": [
      -                      {
      -                        "enum": [
      -                          "positive",
      -                          "neutral",
      -                          "negative"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ]
      -                  },
      -                  "text": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  }
      -                },
      -                "type": "object"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Short first-person statements from real reviews, most useful first. Quote them."
      -        },
      -        "review_count": {
      -          "anyOf": [
      -            {
      -              "type": "integer"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "score": {
      -          "description": "Atly score 0–10 — for the requested categories in search",
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "url": {
      -          "description": "Canonical Atly page. Link it when you cite.",
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "added_at": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "When Atly added the place. Not a freshness date."
      +        },
      +        "address": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "blurb": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "One-line editorial summary."
      +        },
      +        "business_status": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "category_scores": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "additionalProperties": {},
      +                "properties": {
      +                  "category_id": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "name": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "reviews": {
      +                    "anyOf": [
      +                      {
      +                        "maximum": 9007199254740991,
      +                        "minimum": -9007199254740991,
      +                        "type": "integer"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ],
      +                    "description": "Reviews that mention this category."
      +                  },
      +                  "score": {
      +                    "type": [
      +                      "number",
      +                      "null"
      +                    ]
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "data_refreshed_at": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "When Atly last refreshed the place's data from its sources. Absent when unknown."
      +        },
      +        "distance_km": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "From the search center."
      +        },
      +        "gluten_free": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {},
      +              "properties": {
      +                "dedicated_fryer": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "dedicated_kitchen": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "menu": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "safety": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "100% dedicated gluten-free",
      +                        "celiac friendly (low risk of cross-contamination)",
      +                        "accommodating (some risk of cross-contamination)",
      +                        "discuss cross-contamination with staff"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "trained_staff": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "verified_by_atly": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Present only for places with a gluten-free identity."
      +        },
      +        "good_to_know": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "google_rating": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "hours": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "additionalProperties": {},
      +                "properties": {
      +                  "close": {
      +                    "type": "string"
      +                  },
      +                  "close_day": {
      +                    "anyOf": [
      +                      {
      +                        "enum": [
      +                          "sun",
      +                          "mon",
      +                          "tue",
      +                          "wed",
      +                          "thu",
      +                          "fri",
      +                          "sat"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "day": {
      +                    "enum": [
      +                      "sun",
      +                      "mon",
      +                      "tue",
      +                      "wed",
      +                      "thu",
      +                      "fri",
      +                      "sat"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "open": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "day",
      +                  "open",
      +                  "close"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Weekly opening hours in the place's local time, one entry per opening (a day can have several). close 24:00 means it closes at midnight; close_day is set when it closes after midnight, on that day. In get_place and the first search results; absent when unknown."
      +        },
      +        "hours_updated_at": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "When the opening hours were last updated. Absent when there are no hours or no date. Over a year old (or absent with hours), say they may have changed and suggest checking with the place."
      +        },
      +        "id": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "lat": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "lon": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "maps_url": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Google Maps link for the place (directions), from its Google place id. Not an Atly page: cite url for Atly."
      +        },
      +        "menu_url": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "name": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "open_now": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Open at the time of the response, by its hours and timezone; false when the place is closed temporarily or for good. Absent when its hours or timezone are unknown. As fresh as the hours: see hours_updated_at."
      +        },
      +        "phone": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "place_type": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "price": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "reasons": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "additionalProperties": {},
      +                "properties": {
      +                  "kind": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "sentiment": {
      +                    "anyOf": [
      +                      {
      +                        "enum": [
      +                          "positive",
      +                          "neutral",
      +                          "negative"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "text": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Short first-person statements from real reviews, most useful first. Quote them."
      +        },
      +        "reservation_url": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "review_count": {
      +          "anyOf": [
      +            {
      +              "maximum": 9007199254740991,
      +              "minimum": -9007199254740991,
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "score": {
      +          "anyOf": [
      +            {
      +              "type": "number"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Atly score 0–10 — for the requested categories in search, the overall score in get_place — relative to other places in the same country. Absent when unmeasured (too few reviews, or closed)."
      +        },
      +        "timezone": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "IANA timezone of the place."
      +        },
      +        "url": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Canonical Atly page. Link it when you cite. Absent when the place has no page yet."
      +        },
      +        "website": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / total_matched / anyOf
      Previous value: -[
      -  {
      -    "anyOf": [
      -      {
      -        "type": "integer"
      -      },
      -      {
      -        "type": "string"
      -      }
      -    ],
      -    "description": "How many places match in this area, capped (\"1000+\"). Absent when counting timed out."
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "anyOf": [
      +      {
      +        "maximum": 9007199254740991,
      +        "minimum": -9007199254740991,
      +        "type": "integer"
      +      },
      +      {
      +        "type": "string"
      +      }
      +    ]
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  7. Changed2 schema fields changed
    • addedInput schema / properties / place_type
      Added value: +{
      +  "description": "Optional. Keep only places whose Google place type contains one of these words, matched as whole words: \"restaurant\" keeps \"Mexican restaurant\" and \"Pizza restaurant\", \"coffee\" keeps \"Coffee shop\", \"bar\" keeps \"Wine bar\" but not \"Barber shop\". A place matches on its main type (`place_type` in results) or any of its other Google types. Use it when the user asks for a kind of venue (\"gluten-free restaurants\"), not a dish or a feature. Google's types are literal: \"Cafe\" and \"Coffee shop\" are different, so for cafes pass both [\"cafe\", \"coffee\"]. The filter is applied to the strongest 400 places for the categories and never relaxed.",
      +  "items": {
      +    "maxLength": 40,
      +    "minLength": 2,
      +    "type": "string"
      +  },
      +  "maxItems": 5,
      +  "type": "array"
      +}
    • changedOutput schema / properties / places / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "address": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "blurb": {
      -          "description": "One-line editorial summary.",
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "category_scores": {
      -          "anyOf": [
      -            {
      -              "items": {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "category_id": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "name": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "reviews": {
      -                    "anyOf": [
      -                      {
      -                        "description": "Reviews that mention this category.",
      -                        "type": "integer"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ],
      -                    "description": "Reviews that mention this category."
      -                  },
      -                  "score": {
      -                    "type": [
      -                      "number",
      -                      "null"
      -                    ]
      -                  }
      -                },
      -                "type": "object"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "distance_km": {
      -          "description": "From the search center.",
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "gluten_free": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": false,
      -              "description": "Present only for places with a gluten-free identity.",
      -              "properties": {
      -                "dedicated_fryer": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "dedicated_kitchen": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "menu": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "safety": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "100% dedicated gluten-free",
      -                        "celiac friendly (low risk of cross-contamination)",
      -                        "accommodating (some risk of cross-contamination)",
      -                        "discuss cross-contamination with staff"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "trained_staff": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "verified_by_atly": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Present only for places with a gluten-free identity."
      -        },
      -        "google_rating": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "id": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "last_updated": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "lat": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "lon": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "name": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "place_type": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "price": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "reasons": {
      -          "anyOf": [
      -            {
      -              "description": "Short first-person statements from real reviews, most useful first. Quote them.",
      -              "items": {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "kind": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "sentiment": {
      -                    "anyOf": [
      -                      {
      -                        "enum": [
      -                          "positive",
      -                          "neutral",
      -                          "negative"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      {
      -                        "type": "null"
      -                      }
      -                    ]
      -                  },
      -                  "text": {
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  }
      -                },
      -                "type": "object"
      -              },
      -              "type": "array"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ],
      -          "description": "Short first-person statements from real reviews, most useful first. Quote them."
      -        },
      -        "review_count": {
      -          "anyOf": [
      -            {
      -              "type": "integer"
      -            },
      -            {
      -              "type": "null"
      -            }
      -          ]
      -        },
      -        "score": {
      -          "description": "Atly score 0–10 — for the requested categories in search",
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "url": {
      -          "description": "Canonical Atly page. Link it when you cite.",
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "address": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "blurb": {
      +          "description": "One-line editorial summary.",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "category_scores": {
      +          "anyOf": [
      +            {
      +              "items": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "category_id": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "name": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "reviews": {
      +                    "anyOf": [
      +                      {
      +                        "description": "Reviews that mention this category.",
      +                        "type": "integer"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ],
      +                    "description": "Reviews that mention this category."
      +                  },
      +                  "score": {
      +                    "type": [
      +                      "number",
      +                      "null"
      +                    ]
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "distance_km": {
      +          "description": "From the search center.",
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "gluten_free": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": false,
      +              "description": "Present only for places with a gluten-free identity.",
      +              "properties": {
      +                "dedicated_fryer": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "dedicated_kitchen": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "menu": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "safety": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "100% dedicated gluten-free",
      +                        "celiac friendly (low risk of cross-contamination)",
      +                        "accommodating (some risk of cross-contamination)",
      +                        "discuss cross-contamination with staff"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "trained_staff": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "verified_by_atly": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Present only for places with a gluten-free identity."
      +        },
      +        "google_rating": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "id": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "last_updated": {
      +          "description": "When Atly last refreshed this place's data from its sources. Absent when unknown; never the date the place was added.",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "lat": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "lon": {
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "name": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "place_type": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "price": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "reasons": {
      +          "anyOf": [
      +            {
      +              "description": "Short first-person statements from real reviews, most useful first. Quote them.",
      +              "items": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "kind": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "sentiment": {
      +                    "anyOf": [
      +                      {
      +                        "enum": [
      +                          "positive",
      +                          "neutral",
      +                          "negative"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      {
      +                        "type": "null"
      +                      }
      +                    ]
      +                  },
      +                  "text": {
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "description": "Short first-person statements from real reviews, most useful first. Quote them."
      +        },
      +        "review_count": {
      +          "anyOf": [
      +            {
      +              "type": "integer"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "score": {
      +          "description": "Atly score 0–10 — for the requested categories in search",
      +          "type": [
      +            "number",
      +            "null"
      +          ]
      +        },
      +        "url": {
      +          "description": "Canonical Atly page. Link it when you cite.",
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  8. Changed6 schema fields changed
    • changedInput schema / properties / area_id / description
      Previous value: -"An id from `list_areas`; the search covers that area's viewport. Give this or lat/lon, not both."New value: +"An id from `list_areas`; the search covers that area's viewport. A city name also works (\"Austin\", \"Boise, ID\"): it resolves to the matching area, or, for a city with no area, to the extent of the places whose address is in it; the response's `area` and doc_notes say what it resolved to. Give this or lat/lon, not both."
    • addedInput schema / properties / area_id / maxLength
      Added value: +120
    • addedInput schema / properties / limit / description
      Added value: +"Places to return, at most 25; a larger value returns 25."
    • removedInput schema / properties / limit / maximum
      Removed value: -25
    • changedOutput schema / properties / area / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "description": "The resolved search geometry — an area (id, name, level, center, bbox) or a circle (center, radius_km).",
      -    "properties": {},
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": true,
      +    "description": "The resolved search geometry — an area (id, name, level, center, bbox), a city known only from its places (name, level, region, country, center, bbox; no id), or a circle (center, radius_km).",
      +    "properties": {},
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / area / description
      Previous value: -"The resolved search geometry — an area (id, name, level, center, bbox) or a circle (center, radius_km)."New value: +"The resolved search geometry — an area (id, name, level, center, bbox), a city known only from its places (name, level, region, country, center, bbox; no id), or a circle (center, radius_km)."
  9. First observed

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnly, idempotent, non-destructive, closed-world), and the description adds substantial non-obvious behavior: scores are 0–10 and country-relative, an unscored place is unmeasured rather than bad, ordering weighs review volume and gluten-free safety, candidate pools are capped at 100 (400 with `place_type`), and trailing categories are relaxed with `dropped_categories` reporting the result. These are exactly the traits an agent could not infer from structured fields.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The core constraint is front-loaded well, but the body is a dense block with run-on sentences and duplicated material — `dropped_categories` is explained twice in near-identical terms, and the 100/400 candidate cap is mentioned in two separate places. It is information-rich but could be trimmed by roughly a third without losing anything an agent needs.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 7-parameter search tool with an output schema, this covers the edge cases that actually cause bad calls: category relaxation order, what `dropped_categories` means, how scores are normalized, and why results may not be sorted by `score`. Nothing essential to invoking it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 71%, so the schema already documents most parameters; the description still adds meaning beyond it by explaining that categories must all match after relaxation and that the first is never dropped, plus how `place_type` interacts with ranking depth. Some of its parameter detail (area_id resolution, radius clamping, whole-word type matching) restates the schema, so it earns a 4 rather than a 5.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb+resource ("Find places for an intent near a location") and immediately frames itself as "The core call," which positions it against siblings like get_place, list_areas, and list_categories. It also enumerates exactly what comes back (ranked places, quotable reasons, cite link, Maps link, open-now, freshness), so an agent knows precisely what this call yields.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly routes the agent: categories can be exact names or ids from `list_categories`, location can be a city name or `area_id` from `list_areas`, or coordinates with radius. It states when to use `place_type` ("when the user asks for a kind of venue ... not a dish or a feature") and warns that the filter is never relaxed, which is exactly the when/when-not guidance an agent needs.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.