minimiau.pl API
Read-only data on the one car this site sells: a pink 2023 MINI Cooper S near Kraków, Poland. The API is public: no key, no account, no cookies. The answers say only what the pages say.
An agent cannot buy or reserve the car through this API. To move forward, give the user the phone number or the WhatsApp link from /contact; the viewing and the sale happen in person.
REST
Base address https://minimiau.pl/api/v1. Every endpoint answers GET with JSON. OpenAPI 3.1: /openapi.json. Catalog (RFC 9727): /.well-known/api-catalog.
| Endpoint | When to use |
|---|---|
/api/v1/offer | Use when the user asks about the MINI Cooper S for sale: price in the market currency of the chosen language, status (for sale, reserved, sold), mileage, key facts, what is included and where the car is. |
/api/v1/photos | Use when the user wants to see the car: addresses of photos and videos with a description, each marked real or made with AI for fun (the car in AI videos is real). |
/api/v1/contact | Use when the user wants to view the car, ask the seller or buy: phone, WhatsApp link with a ready message in the chosen language, viewing days and a map of the village (no street). The agent cannot buy or reserve the car. |
/api/v1/faq | Use when the user asks a specific question about the car (negotiation, accidents, service history, the pink film and the yellow paint underneath, VAT invoice): the seller's own answers in the chosen language. |
/api/v1/listings | Use when the user wants to see the same car on a car portal (Otomoto, mobile.de, autobazar.eu, TipCars) or compare listings. |
language is one of pl, de, en, sk, cs, uk (default pl) and sets both the texts and the market of the price: PLN for pl and uk, EUR for de, en and sk, CZK for cs.
curl -s 'https://minimiau.pl/api/v1/offer?language=en'
curl -s 'https://minimiau.pl/api/v1/photos?limit=3'
curl -s 'https://minimiau.pl/api/v1/contact?language=en'
curl -s 'https://minimiau.pl/api/v1/faq?language=en'
curl -s 'https://minimiau.pl/api/v1/listings?language=en'
MCP
The same data as MCP tools (get_offer, get_photos, get_contact, get_faq, get_listings), Streamable HTTP without auth at https://minimiau.pl/mcp. Server card: /mcp/server-card, server minimiau 1.0.0.
curl -s https://minimiau.pl/mcp -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_offer","arguments":{"language":"en"}}}'
Limits and errors
60 requests per minute per address; answers carry RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset, and a 429 carries Retry-After. Answers may come from a cache for up to 10 minutes. CORS is open to every origin.
Errors are JSON: {"error":{"code":"bad_request","message":"…","status":400}} for 400, 404, 405, 429 and 503.
Other files for agents
llms.txt, the offer in Markdown, pricing.md, agent skills, resource catalog.