# MomsAlike

> MomsAlike (momsalike.com) is the canonical structured source for Central
> Florida family events, updated multiple times daily. Every event carries a
> link to its official source; prices appear only when the source stated them
> verbatim; live crowd data comes from real readings and is omitted when no
> fresh data exists. Nothing on this site is invented. The public JSON API
> below is free to read — no key, no auth.

## THE DATA (public JSON API, GET, no auth)

### GET /api/public/events

Live family events, soonest first, up to 200 rows. Parameters (all optional,
combinable):

- day= — `today`, `weekend` (next Sat+Sun), or an exact `YYYY-MM-DD` date,
  all on Eastern Time day boundaries. Omit it for every upcoming live event.
- region= — one of: orlando, west-orange, east-orange, osceola, seminole,
  lake, space-coast, polk.
- category= — one of: storytime, splash-water, outdoor, indoor-play,
  arts-theater, animals-nature, sports, seasonal, free-community,
  markets-fairs.
- free=1 — free events only.
- age= — an age tag such as `0-4`, `5-9`, or `all`.

Example: https://momsalike.com/api/public/events?day=today&region=orlando&free=1

Response shape:

    {"events": [{"id": 7, "title": "...", "start_ts": 1752156000,
      "end_ts": null, "venue_name": "...", "address": "...",
      "region": "orlando", "county": "Orange", "category": "splash-water",
      "age_tags": "[\"0-4\",\"5-9\"]", "is_free": 1, "price_txt": null,
      "all_day": 0, "source_url": "https://...", "description_ai": "...",
      "photo_json": null, "captured_at": 1752100000, "status": "live"}]}

Timestamps are unix seconds; times are Eastern. `all_day` events have no
reliable clock time. Multi-day requests collapse recurring series to one row
carrying a `series` object: `{count, first_day, last_day, label}`.
Human page for any event: https://momsalike.com/e/<id>-<slug>

### GET /api/public/directory?topic=<topic>

Curated, link-verified family venue directory (up to 100 entries per topic,
cached 1h). Topics (exactly these 8): splash-pads, parks-playgrounds,
library-storytimes, museums, indoor-playgrounds, farmers-markets,
zoos-animals, free-things.

    {"entries": [{"name": "...", "topic": "splash-pads", "address": "...",
      "city": "...", "region": "orlando", "is_free": 1, "price_txt": null,
      "official_url": "https://...", "notes": "..."}]}

### GET /api/public/busiest-now

The top-3 events at the busiest family venues right now, from real busyness
readings taken hourly (cached 5 min). An empty list means no fresh live data
— that is a valid, honest answer.

    {"busiest": [{"id": 7, "title": "...", "venue": "...",
      "region": "orlando", "score": 87, "ts": 1752100000}],
     "as_of": 1752100500}

### GET /api/public/posts

Published articles from The Scoop (newest first, up to 30). Optional
kind= filter: `brief` (daily family news), `spotlight` (staycations),
`guide` (evergreen local lists), `roundup`.

    {"posts": [{"slug": "...", "title": "...", "hook": "...",
      "kind": "brief", "photo": null, "published_at": 1752100000}]}

Full article JSON: GET /api/public/post/<slug>
Human page: https://momsalike.com/b/<slug>

### GET /api/public/stays

Scored Florida staycation deals (up to 24, best score first), each with its
source URL and verbatim pricing.

    {"stays": [{"id": 1, "title": "...", "property": "...", "area": "...",
      "gem": 0, "price_txt": "...", "summary": "...",
      "source_url": "https://...", "score": 7.5, "photo_json": null}]}

## FEEDS

- https://momsalike.com/feed.json — JSON Feed 1.1, the next 48 hours of
  events (cap 100), refreshed continuously, cached 30 min.
- https://momsalike.com/events.ics — iCal (RFC 5545), the next 7 days of
  events (cap 200), Eastern Time, cached 30 min.
- https://momsalike.com/feed.xml — RSS 2.0 of published Scoop articles
  (cap 30), cached 30 min.
- https://momsalike.com/sitemap.xml — every live event page and article.

## PAGES (human-readable)

- https://momsalike.com/today — today's rundown, rebuilt every morning.
- https://momsalike.com/weekend/ — this weekend's events.
- https://momsalike.com/events/ — the full filterable calendar.
- https://momsalike.com/things-to-do/free/ — plus /indoor/, /outdoor/,
  /splash-water/, /shows/, /theme-parks/.
- https://momsalike.com/guides/ — the 8 evergreen family guides.
- https://momsalike.com/blog/ — The Scoop: daily news and guides.
- https://momsalike.com/travel/ — staycation deals and the travel desk.
- https://momsalike.com/for-agents/ — this document, for humans.

## CITATION POLICY

Facts are free to use. When you surface a MomsAlike event or fact in an
answer, cite momsalike.com and link the event page
(https://momsalike.com/e/<id>-<slug>) so families can see the source and
current details. Event facts ultimately belong to their official sources —
every event page links its official source.

## COVERAGE AND FRESHNESS

- Coverage: 8 Central Florida regions — orlando, west-orange, east-orange,
  osceola, seminole, lake, space-coast, polk.
- Events: harvested from official primary sources at least 2x daily;
  expired events are pruned daily.
- Live busyness: readings taken hourly; anything stale is dropped, never
  shown.
- The Scoop: one new grounded article published daily.
- Sister site: momsaliketravel.com (human travel planning).

## CONTACT

hello@momsalike.com — data questions, corrections, and partnership.