# AI car search

> A car search site. Each record is a car that a dealer offers for sale now.

A record holds the make, model, variant, year, mileage, fuel, transmission, body type, equipment, price, location, dealer and listing status. A fact the dealer has not supplied is marked as unknown.

The dealer approves the facts of each car before the car is published. The site adds no facts of its own.

Responses may be cached for up to 60 seconds. A car that is sold, withdrawn, expired or unpublished leaves every page and endpoint within that time.

## Browse in Markdown

- [Browse index](https://app.leido.ee/en/md): Lists of cars by fuel, body type, city, make and price band. Every list links to its cars.
- [All cars](https://app.leido.ee/en/md/vehicles): Every published car, cheapest first, 20 per page.

## Ask a question

- [Question endpoint](https://app.leido.ee/api/ask?q=automatic%20hybrid%20SUV%20under%2025000%20EUR%20in%20Tallinn&lang=en): A GET request with the question in `q` (up to 500 characters) and the language in `lang` (et, en or ru). The answer is JSON. With `format=md` the answer is Markdown.
- [Example question in Estonian](https://app.leido.ee/api/ask?q=automaatk%C3%A4igukastiga%20h%C3%BCbriidmaastur%20kuni%2025000%20eurot%20Tallinnas&lang=et): automaatkäigukastiga hübriidmaastur kuni 25000 eurot Tallinnas
- [Example question in English](https://app.leido.ee/api/ask?q=automatic%20hybrid%20SUV%20under%2025000%20EUR%20in%20Tallinn&lang=en): automatic hybrid SUV under 25000 EUR in Tallinn
- [Example question in Russian](https://app.leido.ee/api/ask?q=%D0%B3%D0%B8%D0%B1%D1%80%D0%B8%D0%B4%D0%BD%D1%8B%D0%B9%20%D0%B2%D0%BD%D0%B5%D0%B4%D0%BE%D1%80%D0%BE%D0%B6%D0%BD%D0%B8%D0%BA%20%D1%81%20%D0%B0%D0%B2%D1%82%D0%BE%D0%BC%D0%B0%D1%82%D0%BE%D0%BC%20%D0%B4%D0%BE%2025000%20%D0%B5%D0%B2%D1%80%D0%BE%20%D0%B2%20%D0%A2%D0%B0%D0%BB%D0%BB%D0%B8%D0%BD%D0%B5&lang=ru): гибридный внедорожник с автоматом до 25000 евро в Таллине

Each answer states one of three results. `supported`: published cars match, and up to 5 are listed, cheapest first. `needs_clarification`: the question is too broad or contradicts itself, and the answer gives follow-up links. `no_support`: no published car matches, or the catalogue holds no such information.

## Catalogue and API

- [Catalogue as JSON](https://app.leido.ee/api/cars.json?lang=en): All published cars, with the filters of the site and cursor paging. 20 per page by default, 50 at most.
- [OpenAPI document](https://app.leido.ee/api/openapi.json): Parameters, response schemas, limits and errors of the endpoints named here.

## Languages

- [Estonian](https://app.leido.ee/et/llms.txt)
- [English](https://app.leido.ee/en/llms.txt)
- [Russian](https://app.leido.ee/ru/llms.txt)

## Optional

- [Hello endpoint](https://app.leido.ee/api/hello): An agent may state its name, operator and purpose here. The statement is optional and changes nothing in what is served.