AutoIsto

Use this when the user asks for more about one specific car returned by search_cars (engine power, body, colour, price history, how long it has been listed). Requires the car id from search_cars; do not guess ids. Returns technical data and the AutoIsto price verdict; it does not return the seller's name, phone, description, VIN or licence plate — for contact the user opens the car's url. If the car is no longer in the offer, found is false.

get_car_details

Use this to check whether an intent created with intent_publish_intent is already confirmed by the user and active, waiting, expired or withdrawn. Requires the intentCode; returns the statement and dates only — never the user's e-mail, the hidden limit or any other personal data.

intent_get_intent

Use this when the user asks how much a car model costs in Slovakia, or whether a price for a model is reasonable. Returns the median ASKING price of the brand/model (optionally one model year) in AutoIsto's current offer, the sample size, the price range and the date. The median is omitted below 20 cars with a plain price. These are prices sellers ask, not sale prices; mileage and equipment move the price, so present it as a guide. Do not use it for valuing a specific car's condition, for new-car prices or for markets outside Slovakia.

get_model_price

Use this when the user asks what AutoIsto has found for an intent created with intent_publish_intent. These are the same cars AutoIsto e-mails to the user; this server cannot send messages into the conversation by itself. Requires the intentCode; optional since (ISO time) returns only newer matches. Returns at most 20 newest matches with the price and AutoIsto price verdict at the time of the match and a link. Before the user confirms the intent there are no matches. Matches come from listings AutoIsto aggregates from the market, so they cover only cars listed on AutoIsto and may be incomplete; a car may already be sold.

intent_list_matches

Use this when the user wants to find a used car for sale in Slovakia — by brand, model, body type, fuel, gearbox, year, price, mileage, power or town/district. Covers listings sellers published on AutoIsto directly and public listings from Slovak car portals. Pass the criteria as ONE short phrase in Slovak (Czech also works), with numbers as the user said them. Examples that are fully understood: "škoda octavia kombi diesel automat od 2017 do 15000 €", "suv automat do 25000 €", "bmw x5 diesel od 2019 do 40000 €", "kombi do 10000 € Žilina". Use at most ONE body type per call (kombi, SUV, sedan, hatchback, liftback, van, kupé, kabriolet, dodávka); for two body types make two calls. Leave out filler and wishes that are not filters (rodinné, auto, do mesta, spoľahlivé) and equipment (ťažné, panoráma) — unknown words are not applied and are listed in notUnderstood. Returns up to 10 cars with price verdicts, what was understood, which criteria were relaxed when nothing matched exactly, which words were not applied, and a link to all results. Limits: only cars currently listed on AutoIsto (Slovakia, prices in EUR); no new-car configurators, rentals, leasing offers or cars abroad; the offer changes daily, so a car may already be sold.

search_cars

Use this when the user wants AutoIsto to stop watching for an intent created with intent_publish_intent. Takes effect immediately; nothing more is e-mailed for it. Requires the intentCode.

intent_withdraw_intent

Use this when the user asks AutoIsto to keep watching Slovak car listings for them over time (e.g. "let me know until March about an estate car under 15 000 €, not diesel"). This does NOT start watching by itself and takes no e-mail address or other personal data: it returns a consentUrl on www.autoisto.sk that the user must open themselves, enter their own e-mail there and confirm by clicking the link AutoIsto e-mails them. Never ask the user for their e-mail in the conversation and never open the link for them. An unconfirmed draft is deleted after 24 hours. Matching cars are e-mailed to the user and can also be read with intent_list_matches using the returned intentCode — keep it in the conversation. hiddenLimitEur is optional: the most the user would pay, stored encrypted and never shown to sellers or returned by any tool; pass it only if the user said it. Matches come from listings AutoIsto aggregates from the Slovak market (its own sellers' listings and public listings from Slovak car portals), so they cover only cars listed on AutoIsto (Slovakia, EUR) and may be incomplete.

intent_publish_intent