Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. By signing up you are subscribing to the APIs.io and API Evangelist
newsletters — you can unsubscribe from any issue. See our
Privacy Policy and Terms.
openapi: 3.2.0
info:
title: MFG Calcs Manufacturing Data and Calculation Landed Cost API
version: 1.0.0
description: 'The whole mfgcalcs.com platform over HTTP, keyless. 34 data endpoints serve live U.S. manufacturing intelligence: the effective calculated-duty index and estimate, per-family effective-rate gap and statutory duty-free line coverage, sourcing shifts and concentration, customs unit-value movers, the cost-pressure index and its diffusion, manufacturing PMI, state cost indices, the wage board, six-month forecasts with their own accuracy ledger, reshoring readiness and indexed break-even comparisons, and an exact linear-programming sourcing optimizer. Alongside them: 5,384 deterministic manufacturing calculators, one search across everything the site knows, and an answer endpoint that returns a scoped, source-dated answer or a structured clarification request for a natural-language question.
Everything is computed from committed public data (USITC, BLS, EIA, Census, BEA) rather than a model, so identical inputs always return identical output. The trust surfaces are part of the API, not a footnote: /api/vintages recovers what any series said on a past date, /api/revisions records every restatement, /api/provenance publishes artifact hashes, and /api/receipts carries Ed25519 signatures. Free with attribution (CC BY 4.0) and no key, ever. An MCP server exposing the same engines as tools for AI agents is at https://www.mfgcalcs.com/api/mcp.
VERSIONING: every path below is also served under /api/v1/ — e.g. https://www.mfgcalcs.com/api/v1/manufacturing-pmi. Prefer the /api/v1 form in code you intend to keep: v1''s response shapes are frozen (fields keep their name, type and meaning; new fields may be added, so ignore unknown ones), and any breaking change ships as /api/v2 instead of altering v1. The unversioned paths are permanent aliases and will not be removed. Responses carry an X-API-Version header. See https://www.mfgcalcs.com/developers and docs/methodology/API_VERSIONING.md.'
contact:
url: https://www.mfgcalcs.com/contact-us
servers:
- url: https://www.mfgcalcs.com
tags:
- name: Landed Cost
paths:
/api/landed-cost:
get:
operationId: rankLandedCost
summary: Compare source-country landed costs where country prices exist
description: For a manufacturing family, compares per-country effective calculated-duty and international-freight burdens using uplift = 1 + duty + freight. A country receives a landed-unit-cost rank only when its own reported unit value, duty, and freight are all available; missing prices remain unknown. Also returns source concentration and an FX direction. A sourcing indicator, not a customs quote. Full pages at /landed-cost.
parameters:
- name: family
in: query
required: false
schema:
type: string
description: Family key, e.g. 'steel-flat-rolled', 'bearings', 'aluminum-semis'. Omit to list all families, including explicit price-availability status.
- name: limit
in: query
required: false
schema:
type: string
description: For the unfiltered family directory, return 'all' (default) or at most this positive number of families.
responses:
'200':
description: Country lanes with duty, freight, additive burden, optional modeled landed customs unit value, a rank only when at least two lanes are complete, import share, FX, concentration, and downloads.
'400':
description: Unknown family key.
'429':
description: Best-effort function-instance rate limit exceeded; Retry-After is returned.
tags:
- Landed Cost
externalDocs:
url: https://www.mfgcalcs.com/developers
description: Human documentation and MCP setup
x-mfgcalcs-preview:
status: preview-not-published
notice: MCP 2.0 preview documentation. These tools require an explicitly enabled preview deployment; this inventory does not activate them or prove that a hosted endpoint supports them. Read that endpoint's discovery response before calling.
metadata: /mcp-preview.json
schemaReference: /openapi-mcp-preview.json
examples: /mcp-preview-examples.json