MH MediaHarvester Web Context API

Logos

Company Logos

Turn a plain company domain into a usable visual identity record so interfaces and reports do not have to ship with empty logo boxes.

GET /logo-link

What you get

Developer-ready output for Company Logos

01 Favicon and manifest candidates
02 Header and Open Graph logo candidates
03 Monogram fallback
04 Logo Link embed support

Real workflows

Where teams use Company Logos

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

Add logos to CRM account rows

Resolve a domain once and show the hosted logo beside the company name in account lists and profiles.

OutcomeMore recognizable account data without manual asset collection.
Brand generated reports

Insert the detected company mark into proposals, audit PDFs or slide workflows created from a domain input.

OutcomeAutomated deliverables look client-specific.
Enrich merchant and transaction views

Attach a recognizable brand image after a merchant descriptor is mapped to a company domain.

OutcomeCleaner finance and expense interfaces.

How it works

4 concrete steps from input to result

1

Pass a domain

2

Scan metadata and visible assets

3

Rank usable logo candidates

4

Return logo URLs and fallback

API response

Fields developers usually wire first

Resolve company logo candidates from a domain and expose logo-ready URLs for CRMs, spreadsheets, dashboards and generated documents.

logos[].url logos[].type logos[].width logos[].colors
curl.exe -H "X-API-Key: YOUR_API_KEY" "http://127.0.0.1:8013/logo-link"

Developer FAQ

Common questions about Company Logos

12 answers
Can I use this in an image tag?

Yes. Use Logo Link when you want a direct image URL that can be embedded in an img tag, CRM cell, dashboard row or spreadsheet formula.

What happens if no logo is found?

The service can return a deterministic monogram fallback so your UI does not show broken images.

Can I choose light or dark logo variants?

When variant hints are available, store the mode and choose the logo that matches your container background.

What endpoint should I call for Company Logos?

Use GET /logo-link. 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 logos[].url, logos[].type, logos[].width, logos[].colors, 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