# Workout Places — AI Discovery

Workout Places is a directory of outdoor gyms, calisthenics parks, and street workout spots worldwide. This file helps AI agents understand and consume our data.

## Entity model

- **Place**: A single outdoor gym or calisthenics park. Fields: humanId (stable numeric ID), name, generatedName (stable fact-based name for unnamed places), description, latitude, longitude, photos (URLs), equipment (array of equipment keys/objects), address (city, countryName, countryCode, citySlug, countrySlug), limitedAccess (boolean), status (published only in public data). Display name = name, else generatedName, else description. Places are identified by humanId in URLs (e.g. /places/12345). Place pages also show user ratings (1–5 stars) and reviews. Deleted places return HTTP 410 Gone.

- **City**: A geographic city derived from place addresses. Cities have a name, countryName, countrySlug, and a URL slug (e.g. kyiv, london). No separate city table — cities are aggregates of places by address.city.

- **Country**: A country derived from place addresses. Countries have a name, countryCode, and a URL slug. No separate country table — countries are aggregates of places by address.countryName/countryCode.

- **Equipment**: Types of equipment at a place (e.g. pull-up bars, parallel bars). Each has: key (slug, e.g. pull_up_bars), name, description, type (EQUIPMENT | FACILITIES | GAMES). Equipment keys are used in filters and equipment+city SEO pages.

## Key URLs

- **Sitemap (all indexable URLs)**: https://workout-places.com/sitemap.xml
- **Public read-only API**: https://workout-places.com/api/public/places
- **OpenAPI spec**: https://workout-places.com/api/public/openapi.json
- **Full AI guide (examples, URL patterns, data relationships)**: https://workout-places.com/llms-full.txt

## Top entry points

- Home: https://workout-places.com/
- Map / list of all places: https://workout-places.com/places
- Cities index: https://workout-places.com/cities
- Countries index: https://workout-places.com/countries
- Blog: https://workout-places.com/blog
- Data study — outdoor gyms per capita (city & country ranking, methodology): https://workout-places.com/studies/outdoor-gyms-per-capita-2026

## URL patterns

- Place detail: /places/{humanId}
- City hub: /city/{citySlug}
- Country hub: /countries/{countrySlug}
- Equipment + city SEO: /equipment/{equipmentSlug}/{citySlug}

Use the sitemap for a full list of place, city, country, and equipment-city URLs.