# marklipi

PDF → Markdown conversion API, built for agents. Fast, deterministic extraction for text-layer PDFs — bank statements, ownership records, contracts, tables. No vision model, no OCR theater: if the text layer exists, marklipi extracts it cleanly and cheaply.

## Quickstart

```bash
curl -s https://api.marklipi.com/convert -F "file=@statement.pdf"
```

```json
{
  "markdown": "# Account Statement\n\n| Date | Description | Amount |\n...",
  "filename": "statement.pdf",
  "characters": 18342
}
```

No API key. No signup. One request.

## Why agents pick marklipi

- **Zero config** — no auth for basic use; upload bytes, get JSON.
- **Stateless** — files are processed in memory and discarded. Nothing stored, ever.
- **Token economics** — Markdown costs 60–90% fewer tokens than feeding the raw PDF to an LLM.
- **Machine-readable everything** — [llms.txt](https://marklipi.com/llms.txt), [docs.md](https://marklipi.com/docs.md), [OpenAPI](https://api.marklipi.com/openapi.json).
- **Uploads only** — there is no URL parameter; your client fetches, marklipi converts.

## Endpoints

| Method | Path       | Purpose                                  |
| ------ | ---------- | ---------------------------------------- |
| POST   | `/convert` | PDF in (multipart `file`), Markdown out. |
| GET    | `/health`  | Liveness + version.                      |

Base URL `https://api.marklipi.com` · max 25 MB · rate limits 10/min, 100/day per IP · errors as JSON `{"detail": "..."}`.

## Pricing

The free tier stays free — no key, no signup. Paid tiers lift the daily limit:

| Tier               | Price       | Limits                                                  |
| ------------------ | ----------- | ------------------------------------------------------- |
| Free               | $0          | 10/min, 100/day per IP. No key.                         |
| Founding Supporter | $5 one-time | 1,000 conversions/day for life. First 20 buyers only.   |
| Pro                | $19/month   | 25,000 conversions/day, priority support.               |

To buy: email [hello@dovey.com.au](mailto:hello@dovey.com.au?subject=Founding%20Supporter) with the tier name. Paid keys are issued by email within 24 hours of purchase. Details: [marklipi.com/#pricing](https://marklipi.com/#pricing).

## Scope (honest)

- **Great:** digital-native PDFs with selectable text.
- **Not for:** scans, photos, image-only PDFs — those return `422`; use an OCR pipeline instead.

## Resources

- [Free in-browser converter](https://marklipi.com/pdf-to-markdown) — try it on a PDF, no signup
- [Full API reference (Markdown)](https://marklipi.com/docs.md)
- [Full API reference (web)](https://marklipi.com/docs)
- [llms.txt](https://marklipi.com/llms.txt) · [llms-full.txt](https://marklipi.com/llms-full.txt)
- [OpenAPI 3.1 spec](https://api.marklipi.com/openapi.json)
- Contact: [hello@dovey.com.au](mailto:hello@dovey.com.au)