# BoardGameFYI

> Comprehensive board game reference for tabletop enthusiasts, game designers, and collectors. Covers board games with mechanics, categories, designers, artists, publishers, awards, progression paths, game night themes, playbooks with strategy tips, interactive tools, glossary, and in-depth guides. 15 languages supported.

## Data Scope
- Board games with player count, play time, complexity, age, and BGG rating
- Game mechanics (worker placement, deck building, area control, etc.)
- Game categories (strategy, family, party, cooperative, etc.)
- Designers, artists, and publishers with game portfolios
- Awards (Spiel des Jahres, Golden Geek, etc.) with nominees and winners
- Game expansions linked to base games
- Progression paths — curated learning sequences for game genres
- Game night themes — curated game selections for events
- Playbooks with teach steps and strategy tips per game
- Side-by-side game comparisons
- Interactive tools: game finder, player count matcher, complexity calculator, collection analyzer, game night planner, teach order generator, board game quiz
- Board game terminology glossary
- In-depth guides organized by series

## URL Patterns
- Append `.md` to any URL for plain-text markdown format.
- i18n: URL prefix `/{lang}` for non-English (ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id).
- `/games/` — Browse all board games (e.g. `/games/`)
- `/games/{slug}/` — Game detail (e.g. `/games/catan/`)
- `/mechanics/` — Game mechanics (e.g. `/mechanics/`)
- `/mechanics/{slug}/` — Mechanic detail (e.g. `/mechanics/dice-rolling/`)
- `/categories/` — Game categories (e.g. `/categories/`)
- `/categories/{slug}/` — Category detail (e.g. `/categories/card-game/`)
- `/designers/` — Game designers (e.g. `/designers/`)
- `/designers/{slug}/` — Designer detail (e.g. `/designers/reiner-knizia/`)
- `/artists/` — Game artists (e.g. `/artists/`)
- `/artists/{slug}/` — Artist detail (e.g. `/artists/rodger-b-macgowan/`)
- `/publishers/` — Game publishers (e.g. `/publishers/`)
- `/publishers/{slug}/` — Publisher detail (e.g. `/publishers/rio-grande-games/`)
- `/awards/` — Board game awards (e.g. `/awards/`)
- `/awards/{slug}/` — Award detail (e.g. `/awards/spiel-des-jahres/`)
- `/rankings/` — Board game rankings (e.g. `/rankings/`)
- `/rankings/{slug}/` — Ranking detail (e.g. `/rankings/highest-rated-board-games/`)
- `/paths/` — Progression paths (e.g. `/paths/`)
- `/paths/{slug}/` — Progression path detail (e.g. `/paths/area-control-escalation/`)
- `/nights/` — Game night themes (e.g. `/nights/`)
- `/nights/{slug}/` — Game night detail (e.g. `/nights/all-day-gaming/`)
- `/compare/` — Game comparisons (e.g. `/compare/`)
- `/terms/` — Board game glossary (e.g. `/terms/`)
- `/guides/` — In-depth guides (e.g. `/guides/`)
- `/tools/` — Interactive tools (e.g. `/tools/`)
- `/tools/game-finder/` — Game finder (e.g. `/tools/game-finder/`)
- `/tools/board-game-quiz/` — Board game quiz (e.g. `/tools/board-game-quiz/`)

## Games & Discovery
- [All Games](https://boardgamefyi.com/games/)
- [Mechanics](https://boardgamefyi.com/mechanics/)
- [Categories](https://boardgamefyi.com/categories/)
- [Awards](https://boardgamefyi.com/awards/)
- [Game Comparisons](https://boardgamefyi.com/compare/)

## People & Industry
- [Designers](https://boardgamefyi.com/designers/)
- [Artists](https://boardgamefyi.com/artists/)
- [Publishers](https://boardgamefyi.com/publishers/)

## Curated Experiences
- [Progression Paths](https://boardgamefyi.com/paths/)
- [Game Night Themes](https://boardgamefyi.com/nights/)

## Interactive Tools
- [Game Finder](https://boardgamefyi.com/tools/game-finder/)
- [Board Game Quiz](https://boardgamefyi.com/tools/board-game-quiz/)
- [All Tools](https://boardgamefyi.com/tools/)

## Learn
- [Glossary](https://boardgamefyi.com/terms/)
- [Guides](https://boardgamefyi.com/guides/)

## Embed Widget
- [BoardGameFYI Widget Docs](https://widget.boardgamefyi.com)
- [boardgamefyi-embed on npm](https://www.npmjs.com/package/boardgamefyi-embed)
- [boardgamefyi-embed on GitHub](https://github.com/fyipedia/boardgamefyi-embed)

## REST API

Free REST API. No authentication required. JSON responses. CORS enabled.

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/v1/games/` | All board games |
| GET | `/api/v1/games/{slug}/` | Game detail |
| GET | `/api/v1/mechanics/` | Game mechanics |
| GET | `/api/v1/categories/` | Game categories |
| GET | `/api/v1/designers/` | Game designers |
| GET | `/api/v1/artists/` | Game artists |
| GET | `/api/v1/publishers/` | Game publishers |
| GET | `/api/v1/awards/` | Board game awards |
| GET | `/api/v1/progression-paths/` | Progression paths |
| GET | `/api/v1/game-night-themes/` | Game night themes |
| GET | `/api/v1/glossary/` | Glossary terms |
| GET | `/api/v1/guide-series/` | Guide series |
| GET | `/api/v1/guides/` | Guide articles |
| GET | `/api/v1/tools/` | Interactive tools |
| GET | `/api/v1/faqs/` | FAQs |
| GET | `/api/v1/stats/` | Site statistics |

```bash
curl -s "https://boardgamefyi.com/api/v1/games/"
```

[API Docs](https://boardgamefyi.com/developers/) · [OpenAPI Spec](https://boardgamefyi.com/api/openapi.json)

## Developer Tools
- **PyPI**: `pip install boardgamefyi` — [boardgamefyi](https://pypi.org/project/boardgamefyi/) — Board games, rules and reviews API client
- **Embed Widget**: [boardgamefyi-embed](https://widget.boardgamefyi.com)

## Guide FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [CalcFYI](https://calcfyi.com) — 200+ calculators, financial, health, math
- [SalaryFYI](https://salaryfyi.com) — Salary comparison, tax calculators, 36 countries
- [UnivFYI](https://univfyi.com) — University rankings, programs, admissions

## Full Index
- [Full content index](https://boardgamefyi.com/llms-full.txt)
- [XML Sitemap](https://boardgamefyi.com/sitemap.xml)