# Kidcation

> A community platform where families share honest, structured tips about kid-friendly hotels,
> resorts and destinations. "Family fit" is captured as language-neutral, filterable data so AI
> agents are first-class consumers, not an afterthought.

Every public Place page embeds schema.org JSON-LD (LodgingBusiness/TouristDestination, each Tip a
Review, family-fit via additionalProperty) and exposes the identical shape at
`https://kidcation.app/api/places/{place_id}`. Tips carry `inLanguage` and are never translated; there is
deliberately no aggregate star rating.

## Machine-readable data

- [Developer / MCP reference](https://kidcation.app/en/developers): the public read API — endpoint paths, parameters, JSON shapes, and code samples for wiring an agent or MCP server.
- [Attribute registry](https://kidcation.app/api/attributes): the self-describing vocabulary behind every PropertyValue propertyID — keys, types, allowed values, and English labels.
- [Sitemap](https://kidcation.app/sitemap.xml): every public Place URL; each links a page with embedded JSON-LD and a matching /api/places/{place_id} endpoint.
- [Search API](https://kidcation.app/api/search): natural-language discovery as JSON. `GET ?q=<free text>&must=<attribute key>` (repeat `must` for several hard filters); returns ranked places with per-signal score contributions, matched attribute keys, and each place's /api/places/{place_id} link. Rate-limited; robots-disallowed for crawlers but open to configured clients.
- [Search (human)](https://kidcation.app/en/search): the same discovery surface rendered with the map and family-fit filters.
- [Privacy Policy](https://kidcation.app/en/privacy): plain-language privacy, data-handling, consent, and third-party service commitments.

## Optional

- [robots.txt](https://kidcation.app/robots.txt): crawl policy — AI crawlers are welcome on all public content.