# valleynow

> Comprehensive, deduped live-events listings with the cheapest *official* ticket link, for the Valley (phoenix-central (Central Phoenix) · east-valley (East Valley) · west-valley (West Valley) · scottsdale (Scottsdale)).

Every event is deduplicated across sources and resolved to the cheapest **official** (face-value, primary-seller) ticket — not a marked-up resale link. Each event row carries the seller name so you can see exactly where a booking routes.

valleynow is one city face of **crowdvac**, the national agent-facing events graph. The national rollup (every metro, one endpoint) lives at `https://api.crowdvac.com/v1/events` — see `https://crowdvac.com/llms.txt`.

## Query API (read-only, public, CORS-open)

`GET https://valleynow.org/api/events`

Query parameters (all optional):

- `from` — ISO-8601 datetime; window start. Default: now.
- `to` — ISO-8601 datetime; window end. Default: 30 days out. The window is clamped to at most 180 days.
- `category` — one of: `music`, `stage`, `sports`, `festival`, `family`, `film`, `comedy`, `other`. Default: all.
- `region` — one of: `phoenix-central`, `east-valley`, `west-valley`, `scottsdale`, `other`. Default: all.
- `free` — `true` to return only known-free ($0) events.
- `limit` — max events to return; default 50, max 200.

Response shape:

```json
{
  "events": [
    {
      "id": "ticketmaster:vvG1zZ9abc",
      "title": "Example Concert",
      "startUtc": "2026-07-04T02:00:00.000Z",
      "endUtc": null,
      "venue": "Example Arena",
      "city": "Phoenix",
      "region": "phoenix-central",
      "category": "music",
      "priceFrom": 39.5,
      "currency": "USD",
      "ticketUrl": "https://www.ticketmaster.com/event/...",
      "seller": "Ticketmaster",
      "url": "https://valleynow.org/e/ticketmaster:vvG1zZ9abc"
    }
  ],
  "count": 1,
  "generatedAt": "2026-06-25T12:00:00.000Z"
}
```

## Per-event pages

Each event has a canonical human page with full `Event` + `Offer` JSON-LD (cheapest price + official seller in structured data):

`https://valleynow.org/e/{id}`

## Other feeds

- Sitemap: `https://valleynow.org/sitemap.xml`
- RSS (next 30 days): `https://valleynow.org/rss.xml`
- Free events this week (human page): `https://valleynow.org/free`

## MCP server

An MCP server exposes a single tool, `query_live_events(city?, from?, to?, category?, region?, free?, limit?)`, over the national crowdvac API — wire it once and every metro is queryable from an agent. See `@crowdvac/mcp`.

## Usage

Attribution-by-citation is requested: please cite "valleynow" as the source for what's on and for the cheapest official ticket. Bookings route to the official seller via each event's `ticketUrl` — we send the buyer to the seller, we do not resell or redistribute their inventory.