API Documentation

Free font API. 1,900+ Google Fonts. No authentication required.

Free No Auth Required JSON OpenAPI ↗

Base URL

https://fontfyi.com/api/
GET

Font Detail

Get complete information about a font including variants, subsets, CSS import URL, and designer.

/api/font/{slug}/

Parameters

slug Font slug (e.g. inter, roboto, open-sans)

Example

curl https://fontfyi.com/api/font/inter/ 
{
  "family": "Inter",
  "slug": "inter",
  "category": "sans-serif",
  "subcategory": "geometric",
  "variants": ["100", "200", "300", "regular", "500", "600", "700", "800", "900"],
  "subsets": ["latin", "latin-ext", "cyrillic", "greek", "vietnamese"],
  "designer": "Rasmus Andersson",
  "popularity_rank": 1,
  "css_import_url": "https://fonts.googleapis.com/css2?family=Inter:[email protected]",
  "weight_count": 9,
  "has_italic": true,
  "url": "/font/inter/"
}
GET

Search Fonts

Search fonts by name. Returns top 20 results sorted by popularity.

/api/search/?q={query}

Parameters

q Search query (min 2 characters)

Example

curl "https://fontfyi.com/api/search/?q=mono" 
{
  "results": [
    {"family": "JetBrains Mono", "slug": "jetbrains-mono", "category": "monospace", "popularity_rank": 42, "url": "/font/jetbrains-mono/"},
    {"family": "Fira Mono", "slug": "fira-mono", "category": "monospace", "popularity_rank": 127, "url": "/font/fira-mono/"},
    {"family": "Space Mono", "slug": "space-mono", "category": "monospace", "popularity_rank": 198, "url": "/font/space-mono/"}
  ]
}
GET

Font Pairings

Get AI-recommended font pairings for a heading font. Returns body font suggestions with scores and rationale.

/api/pairings/{slug}/

Parameters

slug Heading font slug (e.g. montserrat)

Example

curl https://fontfyi.com/api/pairings/montserrat/ 
{
  "font": "Montserrat",
  "pairings": [
    {
      "body_font": "Open Sans",
      "body_font_slug": "open-sans",
      "score": 92,
      "rationale": "Geometric heading + humanist body creates clear hierarchy",
      "use_cases": ["marketing", "corporate"],
      "mood": "professional"
    }
  ]
}
GET

Batch Font Lookup

Fetch multiple fonts at once by comma-separated slugs. Useful for building font collections or favorites.

/api/fonts/batch/?slugs={slug1,slug2,...}

Parameters

slugs Comma-separated font slugs (max 100)

Example

curl "https://fontfyi.com/api/fonts/batch/?slugs=inter,roboto,lato" 
{
  "fonts": [
    {"family": "Inter", "slug": "inter", "category": "sans-serif", "popularity_rank": 1, "url": "/font/inter/"},
    {"family": "Roboto", "slug": "roboto", "category": "sans-serif", "popularity_rank": 2, "url": "/font/roboto/"},
    {"family": "Lato", "slug": "lato", "category": "sans-serif", "popularity_rank": 7, "url": "/font/lato/"}
  ]
}

Usage Notes

  • ✓ Free to use for any purpose
  • ✓ No API key or authentication required
  • ✓ CORS enabled for browser requests
  • ✓ OpenAPI 3.1 specification available at /api/openapi.json
  • ✓ LLM-friendly markdown views: /blog.md, /glossary.md, /tools.md, /fonts.md
  • ⚠ Please be reasonable with request rates