Skip to main content
Glama

Get place details

get_place
Read-only

Everything about one place

Full detail for a place id from search_places: profile, hours, scores for the categories reviewers mention most (up to 40), up to eight quotable statements, good-to-know facts, gluten-free identity when known, and the canonical Atly URL to cite.

Input Schema

NameRequiredDescriptionDefault
idYesA place id from search_places, or an atly.com place link (with or without https://) or its slug. In a REST path, URL-encode a link.

Output Schema

NameRequiredDescriptionDefault
placeNo
call_idNo
doc_notesNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / place / anyOf
      Previous value: -[
      -  {
      -    "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": "null"
      -  }
      -]New value: +[
      +  {
      +    "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": "null"
      +  }
      +]
  2. Changed1 schema field changed
    • changedOutput schema / properties / place / anyOf
      Previous value: -[
      -  {
      -    "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": "null"
      -  }
      -]New value: +[
      +  {
      +    "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": "null"
      +  }
      +]
  3. Changed4 schema fields changed
    • addedInput schema / properties / id / description
      Added value: +"A place id from search_places, or an atly.com place link (with or without https://) or its slug. In a REST path, URL-encode a link."
    • changedInput schema / properties / id / maxLength
      Previous value: -40New value: +300
    • changedOutput schema / additionalProperties
      Previous value: -falseNew value: +{}
    • changedOutput schema / properties / place / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "address": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "blurb": {
      -        "description": "One-line editorial summary.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "business_status": {
      -        "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."
      -      },
      -      "good_to_know": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "google_rating": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "hours": {
      -        "anyOf": [
      -          {
      -            "description": "Weekly opening periods as reported by Google ({open:{day,time}, close:{day,time}}, day 0 = Sunday), when known. get_place's doc_notes say when they were last updated.",
      -            "items": {
      -              "additionalProperties": true,
      -              "properties": {},
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Weekly opening periods as reported by Google ({open:{day,time}, close:{day,time}}, day 0 = Sunday), when known. get_place's doc_notes say when they were last updated."
      -      },
      -      "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"
      -        ]
      -      },
      -      "menu_url": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "name": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "phone": {
      -        "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."
      -      },
      -      "reservation_url": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "review_count": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "score": {
      -        "description": "Atly score 0–10 — for the requested categories in search",
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "timezone": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "url": {
      -        "description": "Canonical Atly page. Link it when you cite.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "website": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "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": "null"
      +  }
      +]
  4. Changed1 schema field changed
    • changedOutput schema / properties / place / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "address": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "blurb": {
      -        "description": "One-line editorial summary.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "business_status": {
      -        "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."
      -      },
      -      "good_to_know": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "google_rating": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "hours": {
      -        "anyOf": [
      -          {
      -            "description": "Weekly opening periods as reported by Google, when known.",
      -            "items": {
      -              "additionalProperties": true,
      -              "properties": {},
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "Weekly opening periods as reported by Google, when known."
      -      },
      -      "id": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "last_updated": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "lat": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "lon": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "menu_url": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "name": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "phone": {
      -        "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."
      -      },
      -      "reservation_url": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "review_count": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "score": {
      -        "description": "Atly score 0–10 — for the requested categories in search",
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "timezone": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "url": {
      -        "description": "Canonical Atly page. Link it when you cite.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "website": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "address": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "blurb": {
      +        "description": "One-line editorial summary.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "business_status": {
      +        "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."
      +      },
      +      "good_to_know": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "google_rating": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "hours": {
      +        "anyOf": [
      +          {
      +            "description": "Weekly opening periods as reported by Google ({open:{day,time}, close:{day,time}}, day 0 = Sunday), when known. get_place's doc_notes say when they were last updated.",
      +            "items": {
      +              "additionalProperties": true,
      +              "properties": {},
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "Weekly opening periods as reported by Google ({open:{day,time}, close:{day,time}}, day 0 = Sunday), when known. get_place's doc_notes say when they were last updated."
      +      },
      +      "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"
      +        ]
      +      },
      +      "menu_url": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "name": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "phone": {
      +        "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."
      +      },
      +      "reservation_url": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "review_count": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "score": {
      +        "description": "Atly score 0–10 — for the requested categories in search",
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "timezone": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "url": {
      +        "description": "Canonical Atly page. Link it when you cite.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "website": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  5. First observed

TDQS

A4.2/5.0
Behavior4/5

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

Annotations already declare read-only, non-destructive, closed-world behavior, and an output schema exists. The description adds useful behavioral context about the return payload: profile, hours, category scores capped at 40, up to eight quotes, facts, and a canonical URL. It does not cover auth or rate limits, but those are not essential for this read operation.

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

Conciseness4/5

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

The description is short and front-loads the core purpose before listing returned content. The return-content list is dense but earns its place by telling the agent what useful detail to expect.

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?

Given one fully documented parameter, read-only annotations, and an output schema, the description provides enough context to call the tool correctly. It identifies the input source and summarizes the rich payload without needing to re-document schema fields.

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

Parameters3/5

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

Schema description coverage is 100%, and the schema already explains that `id` may be a place id from `search_places`, an Atly URL, or a slug. The description only reinforces the `search_places` source and adds no new syntax or format details, so baseline 3 applies.

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?

The description states a specific retrieval operation (full detail for one place) and names the exact sibling it follows from, `search_places`. An agent can distinguish this from search and from unrelated tools like `list_areas` without opening the schema.

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

Usage Guidelines4/5

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

It clearly implies this is the follow-up call for a place id obtained from `search_places`, which is the main usage context. It stops short of explicit when-not-to-use guidance or naming alternative detail tools, but the intended path is clear.

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.