MH MediaHarvester Web Context API

NAICS

NAICS Classification

Turn unstructured company context into a consistent industry field that sales, analytics and operations teams can filter and route.

GET /v1/industry/naics

What you get

Developer-ready output for NAICS Classification

01 Domain or text input
02 NAICS code candidates
03 Confidence scoring
04 CRM segmentation support

Real workflows

Where teams use NAICS Classification

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

Segment a CRM

Assign industry codes to domain-based account records before building lists or territories.

OutcomeCleaner industry filters across inconsistent source data.
Route leads by vertical

Use classification output to send finance, retail or software accounts to the right workflow or team.

OutcomeAutomated vertical-specific routing.
Normalize portfolio analytics

Map descriptive company text into a shared code system before reporting by sector.

OutcomeComparable industry reporting across datasets.

How it works

4 concrete steps from input to result

1

Collect company context

2

Compare against taxonomy

3

Score likely sectors

4

Return codes and confidence

API response

Fields developers usually wire first

Classify a company or description into NAICS-style industry categories for CRM segmentation, routing and analytics.

industry naics[].code naics[].title confidence
curl.exe -H "X-API-Key: YOUR_API_KEY" "http://127.0.0.1:8013/v1/industry/naics"

Developer FAQ

Common questions about NAICS Classification

12 answers
Should I classify by domain or company name?

Domain is usually stronger because it provides actual website context. Company name alone can be ambiguous.

Can I use this for lead routing?

Yes. NAICS is useful for sales routing, market segmentation, compliance workflows and industry filters.

How should I handle low confidence?

Show the top candidates, request confirmation or enrich with more text such as an about-page summary before deciding.

What endpoint should I call for NAICS Classification?

Use GET /v1/industry/naics. 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 industry, naics[].code, naics[].title, confidence, 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