Developer Documentation

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.

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

Quick Start

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

API Endpoints

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)

URL Patterns

Use these patterns to construct URLs programmatically:

/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/)

Response Format

All endpoints return JSON with pagination:

Example JSON response

{
  "count": 636,
  "next": "https://example.com/api/v1/items/?page=2",
  "previous": null,
  "results": [
    {"slug": "example", "name": "Example Item", "...": "..."}
  ]
}

OpenAPI Specification

Full API schema available as OpenAPI 3.1.0 JSON. Import into Swagger UI, Postman, or any OpenAPI-compatible tool.

SDK Packages

PyPI

pip install fontfyi

Google Fonts metadata & CSS generation — Python library

npm

npm install fontfyi

Google Fonts metadata & CSS generation — JavaScript/TypeScript

Embed Widget

Embed data cards on your site: https://widget.fontfyi.com
npm install fontfyi-embed

Format Support

Markdown endpoints: Append .md to any page URL for LLM-friendly markdown output.
Internationalization: Content available in 14 languages: ko, ja, zh-hans, es, pt, fr, de, ru, ar, hi, th, vi, id, tr.