MH MediaHarvester Web Context API

Description

Company Description

Replace empty or hand-written company blurbs with a source-derived summary that can travel with the rest of the domain enrichment payload.

GET /v1/company/description

What you get

Developer-ready output for Company Description

01 Title and meta description
02 Open Graph fallback
03 Homepage summary
04 Source-aware profile text

Real workflows

Where teams use Company Description

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

Populate CRM company summaries

Generate a short description when a new account arrives with only a domain.

OutcomeSales teams get immediate context before opening the website.
Improve internal search results

Index company name and description alongside account metadata so users can search by what a company does.

OutcomeMore discoverable account records.
Prime an AI research workflow

Use the description as an initial company context signal before deeper crawl or classification steps.

OutcomeBetter routing for downstream enrichment.

How it works

4 concrete steps from input to result

1

Fetch homepage metadata

2

Inspect about and key pages

3

Normalize description text

4

Return concise company context

API response

Fields developers usually wire first

Build a concise company summary from public title, meta, Open Graph and homepage signals for account research and profile enrichment.

title description slogan primary_language
curl.exe -H "X-API-Key: YOUR_API_KEY" "http://127.0.0.1:8013/v1/company/description"

Developer FAQ

Common questions about Company Description

12 answers
Where does the description come from?

It uses title, meta, Open Graph, schema and readable homepage content. The best results come from official website copy.

Can I show the description in a CRM?

Yes. Keep source URLs so users can verify or edit the text when a company changes positioning.

Can I force a language?

Use language hints when your workflow needs a specific output language or when sites have localized versions.

What endpoint should I call for Company Description?

Use GET /v1/company/description. 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 title, description, slogan, primary_language, 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