blinkpdf-io Fonts API
Hosted font catalog and Google Fonts capability discovery
Hosted font catalog and Google Fonts capability discovery
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/blinkpdf-io:blinkpdf-io-fonts-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Blink PDF Fonts API
description: 'Render Markdown into accessible, PDF/UA-conformant PDFs over HTTP. Send Markdown plus optional document metadata, fonts, page layout, viewer hints, and per-block style overrides to `POST /v1/render`, or use a structured template such as `POST /v1/templates/sandwich-document/render` or `POST /v1/templates/layout-document/render`. Fill by name is a separate verb: template (PDF bytes or stored id) plus `{ name: value }` returns a filled PDF; it is not a second verb on `POST /v1/render`. Inspect the complete AcroForm hierarchy at `POST /v1/inspect`, dry-run at `POST /v1/validate-fill`, and fill at `POST /v1/fill`. `POST /v1/fill` streams the PDF and does not keep the output. Stored templates live at `/v1/templates` (store, list, update, delete, download); JSON get/patch/delete by id is gone. Each visible revision atomically binds immutable blank bytes, inspect, resources, and pins. Inspect describes unsupported document and field traits through capabilities and diagnostics; strict fill and template storage reject unsupported subsets. Names are ISO fully qualified names. Omitted names stay unchanged. `false` is a value. Unknown names reject the request. The filled PDF never includes `/NeedAppearances`. Fill is request/response: a live template PDF is one binary multipart part capped by the tier `maxTemplateBytes`, and produce has a 120 second ceiling. No job id. Authentication is via an `x-api-key` header. An unknown path returns HTTP 404 with the named error `not_found`. A method a registered path does not accept returns 405 `method_not_allowed` with an `Allow` header listing the methods that path accepts.'
version: 5.0.0
contact:
name: Blink PDF Support
email: support@blinkpdf.io
license:
name: Proprietary
identifier: LicenseRef-Proprietary
servers:
- url: https://api.blinkpdf.io
description: Production
tags:
- name: Fonts
description: Hosted font catalog and Google Fonts capability discovery
paths:
/v1/fonts:
get:
tags:
- Fonts
summary: List available fonts
description: 'Returns the hosted font catalog — every family is available on every plan — and the Google Fonts capability: any Google Fonts family can be used by passing `googleFontsUrls` on `POST /v1/render` (up to `googleFonts.maxFamiliesPerUrl` families per URL). Use a hosted `key` as a `fontStack` entry; only `weighted` families can serve as the document body/heading family, and a family declared in `googleFontsUrls` can also be referenced by name in `rules` (`set.family`). The `guidance` array carries the pairing/positional rules and the validate-first preflight tip; preflight a font choice with `POST /v1/render/validate` (a misspelled Google family returns 400 `google_font_not_found` without spending a render).'
operationId: listFonts
security:
- apiKey: []
responses:
'200':
description: The hosted catalog and the Google Fonts capability.
headers:
ETag:
schema:
type: string
description: Strong validator keyed on the catalog bytes for the caller (the catalog carries its plan `tier`); changes exactly when that body changes
content:
application/json:
schema:
$ref: '#/components/schemas/Fonts.List'
'304':
description: Catalog unchanged (matched `If-None-Match`).
'401':
description: A named error whose `error` is `unauthorized` (the `x-api-key` header is missing, or names no valid, enabled `bp_*` key).
content:
application/json:
schema:
$ref: '#/components/schemas/Error.unauthorized'
'405':
description: A named error whose `error` is `method_not_allowed` (the path does not accept this method; the `Allow` header lists the ones it accepts).
headers:
Allow:
schema:
const: GET, HEAD
type: string
description: Methods this path accepts
content:
application/json:
schema:
$ref: '#/components/schemas/Error.method_not_allowed'
'429':
description: 'A named error whose `error` is `rate_limited` (the per-address flood shield in front of every route: too many requests from this client address; retry after `Retry-After`).'
headers:
Retry-After:
schema:
minimum: 1
type: integer
description: Seconds to wait before retrying; every 429 states it, and in a batch in which no item succeeded it is the first failed row's `retryAfterSeconds`
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Error.rate_limited'
examples:
rate_limited:
summary: '`rate_limited`'
value:
error: rate_limited
detail: Too many requests from this client address. Retry after the Retry-After interval.
retryAfterSeconds: 5
'500':
description: A named error whose `error` is `internal_error` (an unexpected server error).
content:
application/json:
schema:
$ref: '#/components/schemas/Error.internal_error'
'503':
description: A named error whose `error` is `service_unavailable` (API key validation or the subscription tier lookup is temporarily unavailable; retry shortly).
content:
application/json:
schema:
$ref: '#/components/schemas/Error.service_unavailable'
components:
schemas:
Error.service_unavailable:
additionalProperties: false
description: 'Named error: `error` names it, `detail` explains it, and the members its code declares follow.'
type: object
required:
- error
- detail
properties:
error:
const: service_unavailable
type: string
detail:
description: Caller-safe sentence naming the cause and the fix
type: string
Error.method_not_allowed:
additionalProperties: false
description: 'Named error: `error` names it, `detail` explains it, and the members its code declares follow.'
type: object
required:
- error
- detail
properties:
error:
const: method_not_allowed
type: string
detail:
description: Caller-safe sentence naming the cause and the fix
type: string
Fonts.List:
description: 'Fonts available to the authenticated caller: the hosted catalog (available on every plan) and the Google Fonts by-URL capability (`googleFontsUrls` on `POST /v1/render`, also available on every plan)'
type: object
required:
- tier
- hosted
- googleFonts
- guidance
properties:
tier:
description: The caller's resolved billing tier
type: string
enum:
- free
- pro
- business
hosted:
description: Every hosted family in the catalog; all of them are available on every plan
type: array
items:
type: object
required:
- key
- kind
- faces
properties:
key:
description: Registry key to use in `fontStack` (and, for `weighted` families, as a `set.family` value in `rules`)
type: string
kind:
description: Cascade role of the family; only `weighted` families can serve as the document body/heading family
type: string
enum:
- weighted
- emoji
- emoji-color
- code
faces:
minItems: 1
description: Stable content-addressed binaries for every role and variant.
type: array
items:
type: object
required:
- role
- variant
- asset
- postScriptName
- weight
properties:
role:
type: string
enum:
- body
- heading
- display
- emoji
- code
variant:
type: string
enum:
- regular
- italic
- bold
- boldItalic
asset:
pattern: ^[Bb][Ll][Ii][Nn][Kk]://[Aa][Ss][Ss][Ee][Tt]/[A-Za-z0-9_-]{43}(?![A-Za-z0-9_-])
type: string
postScriptName:
minLength: 1
type: string
weight:
minimum: 100
maximum: 900
multipleOf: 100
description: CSS usWeightClass on the 100–900 grid
type: integer
googleFonts:
type: object
required:
- maxFamiliesPerUrl
properties:
maxFamiliesPerUrl:
minimum: 1
description: Maximum distinct Google Fonts families one URL of `googleFontsUrls` may declare, and the whole pool across its URLs
type: integer
guidance:
description: 'Prose the flat catalog cannot convey: pairing/positional order, `set.family` references, and the validate-first preflight tip'
type: array
items:
type: string
Error.unauthorized:
additionalProperties: false
description: 'Named error: `error` names it, `detail` explains it, and the members its code declares follow.'
type: object
required:
- error
- detail
properties:
error:
const: unauthorized
type: string
detail:
description: Caller-safe sentence naming the cause and the fix
type: string
Error.internal_error:
additionalProperties: false
description: 'Named error: `error` names it, `detail` explains it, and the members its code declares follow.'
type: object
required:
- error
- detail
properties:
error:
const: internal_error
type: string
detail:
description: Caller-safe sentence naming the cause and the fix
type: string
Error.rate_limited:
additionalProperties: false
description: 'Named error: `error` names it, `detail` explains it, and the members its code declares follow.'
type: object
required:
- error
- detail
- retryAfterSeconds
properties:
error:
const: rate_limited
type: string
detail:
description: Caller-safe sentence naming the cause and the fix
type: string
retryAfterSeconds:
minimum: 1
description: Whole seconds to wait before retrying, the value of the `Retry-After` header when the response is the refusal
type: integer
securitySchemes:
apiKey:
type: apiKey
in: header
name: x-api-key
description: API key issued from your Blink PDF account, prefixed `bp_`. Send it in the `x-api-key` header on every operation whose `security` lists `apiKey`; an operation with empty `security` takes no key.