# FontFYI

> Comprehensive font reference for developers and designers. 1,925 Google Fonts with AI-powered pairing recommendations, font comparisons, CSS generation tools, typography glossary, and use-case guides. Free JSON API, no auth required.

## Data Scope
- 1,925 fonts from Google Fonts, GitHub, and custom sources
- 14 curated font pairings with AI-generated rationale
- 30 font tags (mood/style classification)
- 5 categories: Sans Serif, Serif, Display, Handwriting, Monospace
- 14 subcategories/styles: Geometric Sans, Humanist Sans, Neo-grotesque, Slab Serif, etc.
- 83 typography glossary terms across 8 categories
- 110 blog posts on typography guides and font reviews
- 10 interactive tools (pairing generator, type scale, CSS generator, etc.)
- 17 use-case guides (resume, blog, e-commerce, mobile app, etc.)
- Available in 15 languages

## URL Patterns
- Append `.md` to any URL for plain-text markdown format.
- i18n: URL prefix `/{lang}` for non-English (ko, ja, zh-hans, es, pt, fr, de, ru, ar, hi, th, vi, id, tr).
- `/font/{slug}/` — Font detail page (e.g. `/font/inter/`)
- `/font/{slug}/download/` — Font download page (e.g. `/font/inter/download/`)
- `/font/{slug}/pairings/` — Font pairings page (e.g. `/font/inter/pairings/`)
- `/compare/{font1}-vs-{font2}/` — Font comparison (2 fonts) (e.g. `/compare/inter-vs-roboto/`)
- `/compare/{font1}-vs-{font2}-vs-{font3}/` — Font comparison (3 fonts) (e.g. `/compare/inter-vs-roboto-vs-poppins/`)
- `/pairings/` — All font pairings (e.g. `/pairings/`)
- `/pairings/{slug}/` — Pairing detail (e.g. `/pairings/inter-plus-merriweather/`)
- `/category/{slug}/` — Category page (e.g. `/category/sans-serif/`)
- `/style/{slug}/` — Subcategory/style page (e.g. `/style/geometric-sans/`)
- `/tag/{slug}/` — Font tag page (e.g. `/tag/modern/`)
- `/designer/{slug}/` — Designer page (e.g. `/designer/google/`)
- `/fonts/{slug}/` — Language/script fonts (e.g. `/fonts/korean/`)
- `/use-case/{slug}/` — Use-case recommendation (e.g. `/use-case/resume/`)
- `/glossary/{slug}/` — Glossary term detail (e.g. `/glossary/kerning/`)
- `/blog/{slug}/` — Blog post (e.g. `/blog/complete-guide-font-pairing/`)
- `/tools/{slug}/` — Interactive tool (e.g. `/tools/css-generator/`)

## Browse Fonts
- [All Fonts — Popular](https://fontfyi.com/popular/)
- [Trending Fonts](https://fontfyi.com/trending/)
- [Recently Added](https://fontfyi.com/new/)
- [Sans Serif](https://fontfyi.com/category/sans-serif/)
- [Serif](https://fontfyi.com/category/serif/)
- [Display](https://fontfyi.com/category/display/)
- [Handwriting](https://fontfyi.com/category/handwriting/)
- [Monospace](https://fontfyi.com/category/monospace/)
- [Font Tags](https://fontfyi.com/tag/)
- [Designers](https://fontfyi.com/designer/)
- [Language/Script Fonts](https://fontfyi.com/fonts/)

## Font Pairings
- [All Pairings](https://fontfyi.com/pairings/)
- [Inter Pairings](https://fontfyi.com/font/inter/pairings/)
- [Roboto Pairings](https://fontfyi.com/font/roboto/pairings/)

## Comparisons
- [Compare Fonts](https://fontfyi.com/compare/)
- [Inter vs Roboto](https://fontfyi.com/compare/inter-vs-roboto/)
- [Inter vs Poppins](https://fontfyi.com/compare/inter-vs-poppins/)

## Tools
- [Font Pairing Generator](https://fontfyi.com/tools/pairing-generator/)
- [Font Preview](https://fontfyi.com/tools/preview/)
- [Font Compare](https://fontfyi.com/tools/compare/)
- [Type Scale Calculator](https://fontfyi.com/tools/type-scale/)
- [Font Stack Builder](https://fontfyi.com/tools/font-stack/)
- [CSS Code Generator](https://fontfyi.com/tools/css-generator/)
- [WCAG Contrast Checker](https://fontfyi.com/tools/contrast-checker/)
- [Fluid Type Calculator](https://fontfyi.com/tools/fluid-type/)
- [px / rem / em Converter](https://fontfyi.com/tools/px-converter/)
- [Variable Font Playground](https://fontfyi.com/tools/variable-playground/)

## Use Cases
- [All Use Cases](https://fontfyi.com/use-case/)
- [Best Fonts for Resume](https://fontfyi.com/use-case/resume/)
- [Best Fonts for Blog](https://fontfyi.com/use-case/blog/)
- [Best Fonts for Landing Page](https://fontfyi.com/use-case/landing-page/)
- [Best Fonts for E-commerce](https://fontfyi.com/use-case/e-commerce/)

## Learn
- [Typography Glossary](https://fontfyi.com/glossary/)
- [Blog — Typography Guides](https://fontfyi.com/blog/)
- [About FontFYI](https://fontfyi.com/about/)

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

## REST API

Free JSON API, no authentication, CORS enabled.

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/v1/fonts/` | List all fonts (filterable by category, source, is_variable) |
| GET | `/api/v1/fonts/{slug}/` | Font detail with metadata, weights, subsets |
| GET | `/api/v1/pairings/` | List font pairings |
| GET | `/api/v1/pairings/{slug}/` | Pairing detail with rationale and score |
| GET | `/api/v1/tags/` | List font tags (mood/style) |
| GET | `/api/v1/tags/{slug}/` | Tag detail |
| GET | `/api/v1/glossary/` | List typography glossary terms |
| GET | `/api/v1/glossary/{slug}/` | Glossary term detail |
| GET | `/api/v1/blog-posts/` | List published blog posts |
| GET | `/api/v1/blog-posts/{slug}/` | Blog post detail |
| GET | `/api/v1/tools/` | List interactive tools |
| GET | `/api/v1/faqs/` | List published FAQs |
| GET | `/api/v1/search/` | Search across fonts, glossary, and blog |
| GET | `/api/v1/stats/` | Counts for all entity types |
| GET | `/api/font/{slug}/` | Font info JSON (legacy) |
| GET | `/api/font/{slug}/css/` | CSS @import code for a font |
| GET | `/api/search/?q={query}` | Search fonts (legacy) |

```bash
curl -s "https://fontfyi.com/api/v1/fonts/inter/"
```

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

## Developer Tools
- **PyPI**: `pip install fontfyi` — [fontfyi](https://pypi.org/project/fontfyi/) — Google Fonts metadata & CSS generation — Python library
- **npm**: `npm install fontfyi` — [fontfyi](https://www.npmjs.com/package/fontfyi) — Google Fonts metadata & CSS generation — JavaScript/TypeScript
- **Embed Widget**: [fontfyi-embed](https://widget.fontfyi.com)

## Creative FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [ColorFYI](https://colorfyi.com) — Color science, WCAG contrast, 16.7M hex colors
- [EmojiFYI](https://emojifyi.com) — 3,953 emojis, Unicode Emoji 16.0, 8 encodings
- [SymbolFYI](https://symbolfyi.com) — Symbol encoding in 11 formats, Unicode properties
- [UnicodeFYI](https://unicodefyi.com) — Unicode characters, 17 encodings, HTML entities

## Images (CDN)

OG images for all fonts are available on the R2 CDN.
- https://cdn.fontfyi.com/og/inter.png
- https://cdn.fontfyi.com/og/roboto.png

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