MH MediaHarvester Web Context API

Colors

Company Colors

Start from the colors the company actually uses instead of guessing from a screenshot, then carry those tokens into interfaces, decks and automated creative workflows.

GET /v1/company/colors

What you get

Developer-ready output for Company Colors

01 Palette extraction
02 Accent/background/text roles
03 Logo and CSS color candidates
04 Preview-ready color swatches

Real workflows

Where teams use Company Colors

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

Theme a sales proposal automatically

Use extracted brand colors to style a generated deck or report for the prospect’s domain.

OutcomePersonalized output without a designer sampling colors by hand.
Seed a design-system migration

Collect color candidates before recreating a legacy site in a new component system.

OutcomeA factual starting palette for designers and developers.
Validate brand consistency

Compare detected website colors across domains or redesigns to catch large visual drift.

OutcomeRepeatable brand QA instead of subjective screenshots.

How it works

4 concrete steps from input to result

1

Fetch brand and page assets

2

Collect CSS and image colors

3

Score frequently used colors

4

Return palette and roles

API response

Fields developers usually wire first

Extract a practical brand palette from verified logo assets and page styling for theming, design-system seeding and branded document generation.

colors.palette[] colors.accent colors.background colors.text
curl.exe -H "X-API-Key: YOUR_API_KEY" "http://127.0.0.1:8013/v1/company/colors"

Developer FAQ

Common questions about Company Colors

12 answers
Are colors taken from the logo or the site?

Both can contribute. Logo colors are useful for identity; CSS and visible UI colors are useful for product theming.

Can I use the colors directly in UI?

Yes, but preview them first. The response is a strong starting point; your product can still allow manual overrides.

Does it include contrast checks?

Styleguide workflows include accessibility-oriented hints so you can avoid applying low-contrast combinations blindly.

What endpoint should I call for Company Colors?

Use GET /v1/company/colors. 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 colors.palette[], colors.accent, colors.background, colors.text, 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