MH MediaHarvester Web Context API

Fonts

Company Fonts

Identify the typography actually referenced by the live page and its stylesheets instead of guessing from screenshots or browser developer tools.

GET /v1/web/fonts

What you get

Developer-ready output for Company Fonts

01 Font family list
02 Fallback stacks
03 Google/custom font links
04 Usage hints by element

Real workflows

Where teams use Company Fonts

These examples map to the endpoint's current inputs and outputs—not hypothetical platform features.

Match a brand in a prototype

Discover the primary web fonts before recreating a landing page or client demo.

OutcomeMore faithful typography with less manual inspection.
Audit a migration for font regressions

Compare detected families before and after a redesign to catch unintended fallbacks.

OutcomeAutomated typography QA across deployments.
Enrich a brand kit

Store font names and links alongside logos and colors for later creative workflows.

OutcomeA more complete reusable identity record.

How it works

4 concrete steps from input to result

1

Render the page

2

Read computed font styles

3

Parse font-face CSS

4

Return font families and links

API response

Fields developers usually wire first

Detect font families and stylesheet links used by a company site so redesigns, audits and generated brand assets can match typography more closely.

fonts[].font fonts[].fallbacks fonts[].percent_words fontLinks
curl.exe -H "X-API-Key: YOUR_API_KEY" "http://127.0.0.1:8013/v1/web/fonts"

Developer FAQ

Common questions about Company Fonts

12 answers
Why use rendered font detection?

Computed styles show what the browser actually applies after CSS cascades, fallbacks and responsive rules are resolved.

Can it return font file URLs?

Yes when @font-face or Google Fonts CSS is reachable. Some sites hide or self-host fonts behind blocked assets.

Does it count font usage?

The endpoint can report element and word usage so you can separate display fonts from body fonts.

What endpoint should I call for Company Fonts?

Use GET /v1/web/fonts. Local development accepts the X-API-Key header with YOUR_API_KEY, and production clients can use the same shape with their own key.

Can I call it from CLI, SDK, MCP and no-code tools?

Yes. The same endpoint can be called with curl, the TypeScript SDK, Python SDK, MCP server, Zapier, Make, n8n, Google Sheets or Excel workflows where appropriate.

How does caching with maxAgeMs work?

When maxAgeMs is supported, a cached response can be reused if it is younger than the requested freshness window. Set maxAgeMs to 0 when you need a fresh scrape or extraction.

What happens when a page is blocked or requires login?

The API returns clear states such as blocked, verification_required, login_required, robots_disallowed or permission_required. It does not promise to bypass access controls.

Which response fields should I store?

Most integrations store fonts[].font, fonts[].fallbacks, fonts[].percent_words, fontLinks, plus source URL, status, confidence and timestamp fields when present. Keep source metadata so users can audit values later.

Can I batch this endpoint?

For local or small workflows, loop over a list of URLs or domains. For larger jobs, use crawl, batch workflow endpoints or a queue so failures and retries are tracked cleanly.

How should I handle errors in production?

Check success, HTTP status, error.type and retryable flags. Retry timeouts and temporary network failures, but do not retry robots, login or permission errors without changing input or authorization.

Does the API work with JavaScript-heavy sites?

The engine router starts with fast fetching and escalates when content quality is low. Browser-style rendering is used where available, while access-control barriers are reported explicitly.

Is this safe to use with customer data?

Send only domains, URLs or fields your workflow needs. Use retention controls for generated artifacts and avoid storing unnecessary raw HTML, screenshots or extracted personal data.

Related data APIs

Build the next step in the workflow