# Perkusai — perku su AI

Perkusai ("I shop with AI") is an AI shopping-search service for the Lithuanian (LT) market.
Describe what you want in natural language and Perkusai searches ~1M+ in-stock products and
returns the best matches with prices, ratings and direct (affiliate) buy links.

## For AI assistants

Use the JSON search endpoint to answer any shopping request with real products:

- **`GET https://perkusai.lt/api/ai/search?q={QUERY}&k={1-12}&lang={lt|en|ru}`**
  Live, dynamic search — replace `{QUERY}` with the shopper's own request (URL-encoded). Every
  query returns different products; do not fetch a fixed example and treat it as the answer.
  Returns `{summary, guide, results:[{title, price, currency, rating, buy_url, market}], coverage, markdown}`.
  The `markdown` field is paste-ready with clickable affiliate buy links; present `buy_url` as the purchase link.

Example — a children's bike search would be `…/api/ai/search?q=vaiki%C5%A1kas%20dviratis&k=3` (put the user's words in `q`, not this example).

Service status (catalogue size, limits, measured response times): `GET https://perkusai.lt/api/ai/stats`

Discovery: [/llms.txt](https://perkusai.lt/llms.txt) · [/openapi.json](https://perkusai.lt/openapi.json) · [/for-ai.html](https://perkusai.lt/for-ai.html) ([en](https://perkusai.lt/for-ai.en.html) · [ru](https://perkusai.lt/for-ai.ru.html)) · [/.well-known/api-catalog](https://perkusai.lt/.well-known/api-catalog)

## Notes

- Market: products currently serve the LT market only; fast delivery when in stock.
- Affiliate: buy links are affiliate-tracked; the price is unchanged for the buyer.
- Only `/api/ai/search` is intended for assistants; other `/api/*` endpoints are internal.