API overview

Use Middleman’s public, read-only product and content API.

The Middleman Public API provides product identity and published content for websites, internal tools, and agents.

https://middlemantechnologies.com

The current OpenAPI version is 1.1.0.

Public resources

Endpoint	Purpose
GET /api/v1/site	Read the product overview and public capability boundary
GET /api/v1/insights	List published, source-backed Insights
GET /api/v1/insights/{slug}	Read one published Insight and its evidence register
GET /api/v1/products/{manufacturer}/{mpn}	Resolve a supplier-independent product identity

The endpoints on this page are anonymous and read-only.

Public responses are read-only. They do not contact a supplier, reserve stock, accept terms, place an order, make a payment, or grant authority to act.

Response format

Single resources use a data object. Collections use data with meta. Treat non-2xx responses as failures and preserve any evidence date or verification state returned with a record.

Generated reference

Mintlify builds the endpoint reference, request playgrounds, response schemas, and cURL, TypeScript, and Python examples from a reviewed OpenAPI 3.1 document:

https://middleman.mintlify.app/openapi.json

Only the four anonymous read routes above are included in the documentation contract.

Make your first request

Call the public API from cURL, TypeScript, or Python.

Use an agent interface

Choose between the product MCP and the documentation MCP.