Google Fonts Library Metadata Extractor

Look up Google Fonts families by name, browse a category, or export the full library with weights, variable-font axes, language subsets, designers, popularity, and ready-to-use CSS embed URLs.

Open on Apify GitHub source

Input schema

Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.

Field	Type	Required	Description
`mode`	string	required	What to fetch from the Google Fonts library.
`families`	array	optional	Exact font family names, e.g. `Roboto`, `Open Sans`, `Lora`, `Playfair Display`. Case-insensitive.
`category`	string	optional	Filter the library to a single font category.

Show all input fields

Field	Type	Required	Description
`mode`	string	required	What to fetch from the Google Fonts library.
`families`	array	optional	Exact font family names, e.g. `Roboto`, `Open Sans`, `Lora`, `Playfair Display`. Case-insensitive.
`category`	string	optional	Filter the library to a single font category.
`maxItems`	integer	optional	Hard cap on the number of font records emitted.

Download the published input schema

View complete JSON

{
  "description": "Look up Google Fonts families by name, browse by category, or list the entire library.",
  "properties": {
    "category": {
      "default": "Sans Serif",
      "description": "Filter the library to a single font category.",
      "editor": "select",
      "enum": [
        "Sans Serif",
        "Serif",
        "Display",
        "Handwriting",
        "Monospace"
      ],
      "enumTitles": [
        "Sans Serif",
        "Serif",
        "Display",
        "Handwriting",
        "Monospace"
      ],
      "prefill": "Sans Serif",
      "title": "Category (mode=byCategory)",
      "type": "string"
    },
    "families": {
      "default": [
        "Roboto"
      ],
      "description": "Exact font family names, e.g. `Roboto`, `Open Sans`, `Lora`, `Playfair Display`. Case-insensitive.",
      "editor": "stringList",
      "prefill": [
        "Roboto"
      ],
      "title": "Font families (mode=byFamily)",
      "type": "array"
    },
    "maxItems": {
      "default": 50,
      "description": "Hard cap on the number of font records emitted.",
      "maximum": 2000,
      "minimum": 1,
      "prefill": 50,
      "title": "Max items",
      "type": "integer"
    },
    "mode": {
      "default": "byFamily",
      "description": "What to fetch from the Google Fonts library.",
      "editor": "select",
      "enum": [
        "byFamily",
        "byCategory",
        "listAll"
      ],
      "enumTitles": [
        "Lookup specific font families by name",
        "Browse a font category",
        "List the entire library"
      ],
      "prefill": "byFamily",
      "title": "Mode",
      "type": "string"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "Google Fonts Scraper Input",
  "type": "object"
}

Output schema

Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.

Field	Type	Required	Description
`fonts`	string	optional	Dataset containing all scraped Google Fonts families.

Download the published output schema

View complete JSON

{
  "actorOutputSchemaVersion": 1,
  "description": "Google Fonts family records with category, weights, variable-font axes, subsets, designers, popularity, and specimen/CSS URLs.",
  "properties": {
    "fonts": {
      "description": "Dataset containing all scraped Google Fonts families.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Google Fonts",
      "type": "string"
    }
  },
  "title": "Google Fonts Library Metadata Extractor Output"
}

Dataset schema

Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.

Download the published dataset schema

View complete JSON

{
  "actorSpecification": 1,
  "views": {
    "overview": {
      "display": {
        "component": "table",
        "properties": {}
      },
      "title": "Fonts",
      "transformation": {
        "fields": [
          "family",
          "category",
          "weights",
          "subsets",
          "popularity",
          "googleFontsUrl"
        ]
      }
    }
  }
}

Key-value schema

Published key-value store definitions, when provided by this build.

This definition is not present in the default published build. See the published README for available documentation.

Published README

Read the full published documentation

Google Fonts Library Metadata Extractor

Get structured metadata for Google's free, open-source font library instead of reading it off the fonts.google.com catalog by hand. Look a family up by name, pull every family in one of the five categories, or export the whole library at once, with weights, variable-font axes, language subsets, designer credits, and ready-to-paste specimen and CSS embed URLs.

What this actor does

Three modes: byFamily, byCategory, listAll
Every family: weights, style variants, variable-font axes, language subsets, designers
Ranking signals: popularity and trending positions across the whole library
Ready-to-use URLs: a specimen page URL and a css2 embed URL for each family
Empty fields are always omitted — records only contain data that actually exists

Output per font family

Field	Description
`family`	Font family name (e.g. `Roboto`, `Open Sans`)
`displayName`	A display-friendly variant of the family name, when Google Fonts publishes one separate from `family`
`category`	`Sans Serif` / `Serif` / `Display` / `Handwriting` / `Monospace`
`stroke`	Stroke classification when present (e.g. `Sans Serif`, `Slab Serif`)
`classifications`	Secondary tags (e.g. `Display`, `Monospace`, `Symbols`)
`subsets`	Language / script subsets (e.g. `latin`, `cyrillic`, `greek`, `vietnamese`)
`weights`	Distinct numeric weights (e.g. `["100","400","700","900"]`)
`variants`	All style variants incl. italics (e.g. `["400","400i","700"]`)
`axes`	Variable-font axes: `[{tag, min, max, defaultValue}]`
`isVariable`	`true` when the family ships a variable font
`designers`	List of designer / foundry names
`popularity`	Popularity rank across the library (lower = more popular)
`trending`	Trending rank across the library
`dateAdded`	Date the family was first added to Google Fonts
`lastModified`	Date the family was last updated
`primaryScript` / `primaryLanguage`	Primary script / language when set
`colorCapabilities`	Color-font tech when present (e.g. `COLRV1`, `OTSVG`)
`isOpenSource`	`true` when Google Fonts marks the family open source in its metadata (true on virtually every family, since the whole library is open source)
`isBrandFont`	`true` when Google Fonts flags this family as a brand font
`isNoto`	`true` when the family is part of the Noto font collection
`googleFontsUrl`	Specimen page, e.g. `https://fonts.google.com/specimen/Open+Sans`
`cssUrl`	Embed stylesheet, e.g. `https://fonts.googleapis.com/css2?family=Open+Sans`
`recordType`	`font`
`scrapedAt`	ISO-8601 timestamp of the scrape

Output per failed lookup (recordType = `error`)

When a requested family name in families doesn't match any family in the library (mode=byFamily), the actor emits a typed error record instead of silently skipping it:

Field	Description
`error`	Short error type, e.g. `not_found`
`message`	Human-readable explanation
`input`	The family name that didn't match
`sourceUrl`	The Google Fonts metadata endpoint queried
`scrapedAt`	ISO-8601 timestamp

Input

Field	Type	Default	Description
`mode`	string	`byFamily`	`byFamily` / `byCategory` / `listAll`
`families`	array	`["Roboto"]`	Exact family names (mode=byFamily), case-insensitive
`category`	string	`Sans Serif`	One category (mode=byCategory)
`maxItems`	integer	`50`	Hard cap on emitted records (1–2000)

Example: look up specific families

{
  "mode": "byFamily",
  "families": ["Roboto", "Open Sans", "Playfair Display", "JetBrains Mono"]
}

Example: browse every monospace font

{
  "mode": "byCategory",
  "category": "Monospace",
  "maxItems": 100
}

Example: export the whole library

{
  "mode": "listAll",
  "maxItems": 2000
}

Use cases

Design systems — build a searchable, filterable font picker from live Google Fonts data
Web performance — pull the exact css2 URLs and weights you need before self-hosting
Typography research — analyse the library by category, popularity, or variable-font support
App onboarding — offer users a curated font list without hand-maintaining metadata
SEO / content tooling — enrich articles and galleries with accurate font specifications
Localization — filter families by language subset (Cyrillic, Greek, Vietnamese, and more)

FAQ

Where does the data come from? The official public Google Fonts metadata catalog that powers fonts.google.com. No login or API key is required.

How many fonts are covered? The entire library — over 1,900 families and growing. listAll returns all of them (up to maxItems).

What are the categories? Sans Serif, Serif, Display, Handwriting, and Monospace.

What's the difference between weights and variants? weights lists the distinct numeric weights (e.g. 400, 700). variants lists every shipped style, including italics (e.g. 400, 400i, 700, 700i).

What are axes? For variable fonts, the adjustable axes — such as wght (weight), wdth (width), slnt (slant), or opsz (optical size) — each with its min, max, and defaultValue.

How do I embed a font? Use the cssUrl in a <link> tag, then reference the family in your CSS font-family. You can add :wght@... to the URL to request specific weights.

Are these fonts free to use? Yes. Every Google Font is open source (licensed under the SIL Open Font License or Apache License 2.0) and free for commercial and personal use.

How fresh is the data? Live — the actor fetches the current metadata document on every run, so new families and updates appear as soon as Google publishes them.

Is this affiliated with Google? No. This is an independent, third-party actor that reads Google Fonts' publicly available library metadata and is not affiliated with or endorsed by Google.

Python quickstart

Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.

Open the step-by-step Python guide →

Source build ki7Rr9Ay6NYX8F1iZ. Documentation is regenerated from the default published build; private drafts are not included.

Google Fonts Library Metadata Extractor

Input schema

Output schema

Dataset schema

Key-value schema

Published README

Google Fonts Library Metadata Extractor

What this actor does

Output per font family

Output per failed lookup (recordType = error)

Input

Example: look up specific families

Example: browse every monospace font

Example: export the whole library

Use cases

FAQ

Python quickstart

Output per failed lookup (recordType = `error`)