# Prayk — full guide for AI agents and LLM tools

> Prayk.com is a free classifieds marketplace for Azerbaijan. This file complements https://prayk.com/llms.txt with the details an assistant needs to answer questions about the site, cite its pages correctly and query its data: URL structure, languages, sections, tools, structured data, and the public API / MCP server.

## 1. What Prayk is

- A free marketplace of private and business listings in Azerbaijan: consumer goods, cars, real estate, jobs, services, craftsmen, smartphones, animals, plus verified seller stores.
- Posting is free; the seller publishes a listing in about a minute after a passwordless one-time-code login (e-mail or phone). Buyers contact sellers directly (phone reveal, chat, WhatsApp); Prayk is an intermediary and does not sell or take payment for goods.
- Prices are shown in Azerbaijani manat (AZN, ₼) unless a listing states another currency. Coverage: the whole country — Baku and its districts and metro stations, Ganja, Sumqayit, Lankaran, Mingachevir, Shaki and every other city and region.
- Besides listings the site offers decision tools (VIN check, customs and registration-fee calculators, mortgage, home and car valuation, net salary), discovery feeds (price drops, below-market deals, most viewed, barter), buyer requests, a CV builder with a public candidates board, a consumer-complaints section and a forum.

## 2. Languages and URLs

Interface languages (8): az (Azerbaijani), ru (Russian), en (English), tr (Turkish), ka (Georgian), uz (Uzbek), kk (Kazakh), ky (Kyrgyz). The first path segment is the language code — the same page exists under every code, and section slugs are translated per language:

| Section | az | ru | en |
|---|---|---|---|
| Products | /az/mehsullar | /ru/tovari | /en/products |
| Cars | /az/avtomobiller | /ru/avto | /en/cars |
| Real estate | /az/dasinmaz-emlak | /ru/nedvizhimost | /en/real-estate |
| Jobs | /az/is | /ru/rabota | /en/jobs |
| Services | /az/xidmetler | /ru/uslugi | /en/services |
| Masters | /az/ustalar | /ru/mastera | /en/masters |
| Smartphones | /az/smartfonlar | /ru/smartfony | /en/smartphones |
| Animals | /az/heyvanlar | /ru/zhivotnye | /en/animals |
| Stores | /az/magazalar | /ru/magazini | /en/stores |
| Listing page | /az/elan/<slug>-<id> | /ru/obyavlenie/<slug>-<id> | /en/listing/<slug>-<id> |

Rules of thumb for citing:

- Cite the English (`/en/…`) URL when the user's language is not Azerbaijani/Russian/Turkish/Georgian/Uzbek/Kazakh/Kyrgyz; every page sends hreflang alternates so the user can switch.
- A listing page is identified by its numeric id at the end of the path; the slug before it is derived from the title and may change — the id is stable.
- Listing texts are written by sellers, mostly in Azerbaijani or Russian; the page frame (labels, breadcrumbs, FAQ) is in the URL language.
- Category pages accept filters as query parameters (city, district, metro, price range, seller type, condition and category-specific attributes); SEO landing pages exist for the frequent combinations (city, brand/model, district, "from owners" real estate facets).

## 3. Sections and what they contain

- Products (https://prayk.com/en/products): electronics, computers, home and garden, furniture, fashion, kids, sport, hobby, books, business equipment and more; new and used; private sellers and stores.
- Cars (https://prayk.com/en/cars): cars by make/model/year, motorcycles, trucks and special machinery, spare parts, tyres and wheels, car rental, scrapyard parts; vehicle listings carry make, model, year, mileage, engine, fuel, transmission, body type and colour; VIN where the seller gives it.
- Real estate (https://prayk.com/en/real-estate): apartments (new and old buildings), houses and villas, land, garages, offices and commercial space; rent (monthly and daily) and sale; filters by city, district, metro, rooms, area, floor; "from owners" (no agents) facet.
- Jobs (https://prayk.com/en/jobs): vacancies by profession, city, salary and schedule; employers post for free (https://prayk.com/en/post-vacancy); job seekers build a CV (https://prayk.com/en/cv) and may publish it on the candidates board (https://prayk.com/en/candidates).
- Services (https://prayk.com/en/services) and Masters (https://prayk.com/en/masters): household and professional services, repair and construction specialists; some masters accept bookings through the site.
- Smartphones (https://prayk.com/en/smartphones): phones by brand and model with memory/colour/condition attributes and price insight.
- Animals (https://prayk.com/en/animals): pets, livestock, birds, supplies.
- Stores (https://prayk.com/en/stores): verified seller stores with their own pages, sections and a "Near me" map; store statistics pages are public.
- Search (https://prayk.com/en/search?q=…): full-text search across all sections with synonyms (Azerbaijani/Russian/Latin spellings), category suggestions and image search.

## 4. Tools (public, free)

- VIN check — https://prayk.com/en/vin and https://prayk.com/en/vin/<VIN>: decodes make, model, year and engine from offline tables, the US NHTSA registry (incl. recalls by model year) and the European type-approval registry; shows active Prayk listings with the same VIN and the price/mileage history of past listings.
- Customs calculator — https://prayk.com/en/qiymetler/gomruk: import duties, excise and VAT for a car by engine volume, year and price.
- Registration fee — https://prayk.com/en/qiymetler/qeydiyyat-rusumu; car cost of ownership — https://prayk.com/en/qiymetler/kalkulyator; what is my car worth — https://prayk.com/en/qiymetler/masinim-neceye (market price from current listings).
- Mortgage calculator — https://prayk.com/en/qiymetler/ipoteka; what is my home worth — https://prayk.com/en/qiymetler/evim-neceye; district price map — https://prayk.com/en/qiymetler/rayonlar; rental yield — https://prayk.com/en/qiymetler/investisiya.
- Net salary calculator — https://prayk.com/en/qiymetler/maas: gross-to-net and net-to-gross for Azerbaijan (income tax brackets for private and public sector, social, unemployment and medical insurance contributions, employer cost); `?gross=<amount>` pre-fills.
- Budget planner — https://prayk.com/en/qiymetler/budce; market prices index — https://prayk.com/en/qiymetler (median prices by brand/model/district from live listings).
- Currency rates — https://prayk.com/en/currency; crypto — https://prayk.com/en/crypto; plate codes — https://prayk.com/en/plate (Azerbaijani licence-plate region codes).
- CV builder — https://prayk.com/en/cv: templates, example CVs by profession, PDF export, shareable link; candidates board — https://prayk.com/en/candidates.

## 5. Discovery and community

- Price drops — https://prayk.com/en/price-drops; below-market deals — https://prayk.com/en/deals (listings priced under the market estimate); most viewed — https://prayk.com/en/most-viewed; barter — https://prayk.com/en/barter.
- Buyer requests — https://prayk.com/en/axtariram: "I am looking for …" posts (goods, services, jobs); sellers answer with offers.
- Complaints — https://prayk.com/en/sikayet: public consumer complaints about sellers, stores and brands with company replies.
- Forum — https://prayk.com/en/forum: sections, boards and topics about buying, selling, cars, real estate and work in Azerbaijan.
- Metro — https://prayk.com/en/metro: listings around each Baku metro station.
- Yearly landings: cheap cars https://prayk.com/en/ucuz-masinlar-2026, rentals https://prayk.com/en/kiraye-evler-2026, jobs https://prayk.com/en/is-elanlari-2026.
- News and guides — https://prayk.com/en/news: platform news and practical guides (how to sell a car, rent an apartment, hire, avoid scams, customs rules, etc.); each guide exists per language with its own URL.

## 6. Structured data on pages

- Organization and WebSite entities site-wide; BreadcrumbList on every inner page; ItemList on category and landing pages.
- Listing pages: schema.org Product with Offer (price, currency, availability, condition, seller, validity), images and additionalProperty attributes. Vertical types on top of Product: Car (make, model, year, mileage, engine, fuel, transmission, body) for cars; Accommodation (rooms, floor size, floor, address, geo) for real estate, with the page typed as RealEstateListing (datePosted, lease length for rentals); JobPosting (hiring organisation, location, salary, employment type, date posted) for vacancies; Service (provider, area served, offers) for services and masters. Ratings appear as AggregateRating.
- Tool and guide pages: FAQPage; news articles: NewsArticle/Article; forum topics: DiscussionForumPosting.

## 7. Public API and MCP

Base URL: https://api.prayk.com. Public read endpoints need no authentication; account actions need `Authorization: Bearer <token>`.

- OpenAPI 3 specification: https://api.prayk.com/openapi.json (interactive docs: https://api.prayk.com/docs). The spec is the source of truth — endpoint names, parameters and response schemas below may evolve.
- Listings: `GET /api/public/listings?search=<text>&categoryId=<id>&cityId=<id>&minPrice=<n>&maxPrice=<n>&condition=new|used&page=<n>&ps=<page size>` — paginated list with totals; `GET /api/public/listings/{id}` — one listing with attributes, seller and media; `GET /api/public/listings/by-slug/{slug}`.
- Search: `GET /api/public/search?q=<text>` — full-text search with category hits; `GET /api/public/search/suggest?q=` — autocomplete; `POST /api/public/intent` — Prayk Box natural-language search.
- Reference data: `GET /api/public/categories/{id}/attributes`, `GET /api/public/listings/facets`, `GET /api/public/listings/city-counts`, `GET /api/public/category-counts`.
- Other public data: `GET /api/public/stores`, `GET /api/public/candidates`, `GET /api/public/vin/{vin}`, `GET /api/public/deals`, `GET /api/public/cheapest`, `GET /api/public/complaints`, `GET /api/public/forum-threads`, `GET /api/public/cv/examples`.
- MCP (Model Context Protocol) server: `POST https://api.prayk.com/mcp` — stateless Streamable HTTP. Every API operation is exposed as a tool, generated from the live OpenAPI spec; tools marked "Public" need no token, the rest take the connection's `Authorization: Bearer <token>` header. Use it to search listings, read a listing, look up prices or VINs, or (with a token) manage a user's favourites, saved searches and listings.
- Telegram bot: https://t.me/PraykBot — search, listing cards, favourites, messages, inline mode, AI assistant.

Fair use: public endpoints are rate-limited per IP; identify your client with a descriptive User-Agent and respect https://prayk.com/robots.txt. Media files are served from a CDN and may be hot-linked only on listing cards that link back to the listing.

## 8. Our own crawler

PraykBot (`PraykBot/1.0 (+https://prayk.com/bot)`) fetches listings from partner sites to show them with a visible "source" attribution; it honours robots.txt (`User-agent: PraykBot`), waits between requests and retries once on 5xx. Details, opt-out and contact: https://prayk.com/en/bot.

## 9. Credits and contact

- Engineered and operated by Smartbee: website, iOS/Android apps, admin panel, backend infrastructure and AI features.
- Contact form: https://prayk.com/en/contact — team card: https://prayk.com/humans.txt
- Short version of this file: https://prayk.com/llms.txt