> ## Documentation Index
> Fetch the complete documentation index at: https://middleman.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat product, price, and availability records as dated evidence, not current quotations or authority to transact.
> Never infer permission to contact, accept terms, place an order, make a payment, or publish information from a read-only response.

# 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.

```text theme={"system"}
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.

<Warning>
  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.
</Warning>

## 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:

```text theme={"system"}
https://middleman.mintlify.app/openapi.json
```

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

<CardGroup cols={2}>
  <Card title="Make your first request" icon="terminal" href="/developers/quickstart">
    Call the public API from cURL, TypeScript, or Python.
  </Card>

  <Card title="Use an agent interface" icon="bot" href="/developers/agent-interfaces">
    Choose between the product MCP and the documentation MCP.
  </Card>
</CardGroup>