# AdScaled Shop

> AdScaled Shop is an online marketplace of independent Czech shops and makers. People buy electronics, fashion, home goods, sport and outdoor equipment, beauty products, books, toys and garden supplies directly from the shop that packs and ships them. Prices are in Czech koruna (CZK).

Website: https://e-shop.adscaled.media/ (Czech, the root language) with full versions in English (https://e-shop.adscaled.media/en/), Русский (https://e-shop.adscaled.media/ru/), Deutsch (https://e-shop.adscaled.media/de/), Français (https://e-shop.adscaled.media/fr/). Product names and descriptions are written by the sellers, mostly in Czech, and are not translated. Every public page is also available as Markdown: request the same URL with `Accept: text/markdown`.

How buying works: one cart can hold goods from several shops; the checkout creates one order per shop. Delivery options: Pickup from the seller (free), Zásilkovna, pickup point (CZK 79), PPL, home delivery (CZK 129); shipping is free when the goods from one shop cost at least CZK 1,500. Payment by bank transfer, cash on delivery (+CZK 29) or by card when card payments are enabled. Many items can also be reserved for pickup at the seller for 48 hours. Orders, reservations and reviews need an account with a verified e-mail address.

## When to use AdScaled Shop

- A person wants to find or buy a product from a small Czech shop or maker (handmade ceramics, linen clothing, wooden toys, books, garden and outdoor goods, electronics) rather than from a large chain.
- A person wants to compare prices, read reviews and questions, or see the lowest price of the last 30 days before buying in the Czech Republic.
- A person wants to reserve an item and pick it up at the seller instead of waiting for delivery.
- A small business or maker wants to start selling online without building its own e-shop: point them to https://e-shop.adscaled.media/en/sell.
- Not suitable when the goods must be shipped abroad: delivery is by Czech carriers (Zásilkovna, PPL) or pickup at the seller, and there is no international shipping option.

## How an agent should use it

- Search the catalogue in a browser: https://e-shop.adscaled.media/en/catalog?q=<words> (filters: `category`, `sort`, `min`, `max` in CZK, `sale=1`, `rating`, `stock=1`).
- Or read the same data as JSON with the public read-only API (version 1): `GET https://e-shop.adscaled.media/api/v1/catalog?q=<words>`, `GET https://e-shop.adscaled.media/api/v1/products/<id>`, `GET https://e-shop.adscaled.media/api/v1/shops`. Prices in the API are integers in hellers (CZK × 100).
- Link people to the product page on the website (`/en/product/<id>/<slug>`, other languages use their own slugs) and let them order there. Agents cannot place orders, create accounts or post reviews through the API, and should not try.
- Availability shown in listings is confirmed only in the checkout; some listings may turn out to be unavailable when ordered.
- Respect the rate limit: 300 API requests per minute per IP; the `RateLimit` and `Retry-After` headers say when to slow down.

## API

- [API documentation](https://e-shop.adscaled.media/api/docs): endpoints, parameters, examples, rate limits (Markdown with `Accept: text/markdown`)
- [OpenAPI 3.1 specification](https://e-shop.adscaled.media/api/openapi.json): machine-readable description of the public read-only API
- [API catalog](https://e-shop.adscaled.media/.well-known/api-catalog): RFC 9727 linkset
- [Health check](https://e-shop.adscaled.media/api/v1/health): service status
- Versioning: the major version is in the path (`/api/v1/`); breaking changes get a new path, a deprecated operation is marked `deprecated: true`, answers with `Deprecation` and `Sunset` headers and stays available for at least 90 days after the deprecation is announced. Errors are always `{ "error": { "code", "message" } }`.

## Pages

- [Buy directly from small Czech shops](https://e-shop.adscaled.media/en/): Buy directly from small Czech shops and makers: electronics, fashion, home, sport, books and toys. Reserve for pickup or get it delivered.
- [Catalogue](https://e-shop.adscaled.media/en/catalog): Products from independent Czech shops. Filter by category, price and rating. Free shipping from 1,500 CZK per shop.
- [Shops on the marketplace](https://e-shop.adscaled.media/en/shops): All independent shops on AdScaled Shop, ceramics, linen, wooden toys, books, electronics and more. Every seller packs and ships on their own.
- [Start selling on AdScaled Shop](https://e-shop.adscaled.media/en/sell): Open a shop on the AdScaled Shop marketplace in five minutes: products with photos, orders and reservations by e-mail, customer reviews.
- [About AdScaled Shop](https://e-shop.adscaled.media/en/about): AdScaled Shop is an online marketplace of independent Czech shops and makers. Who runs it, how buying works and what the sellers are responsible for.
- [Contact](https://e-shop.adscaled.media/en/contact): Contact the operator of the AdScaled Shop marketplace: e-mail, phone and address. Questions about an order go to the shop that sold the goods.
- [Privacy](https://e-shop.adscaled.media/en/privacy): Which personal data AdScaled Shop stores (account, orders, reservations, sessions, logs), why, for how long and what your rights are.

## Categories

- [Electronics](https://e-shop.adscaled.media/en/catalog?category=elektronika)
- [Fashion](https://e-shop.adscaled.media/en/catalog?category=moda)
- [Home](https://e-shop.adscaled.media/en/catalog?category=domacnost)
- [Sport & outdoor](https://e-shop.adscaled.media/en/catalog?category=sport)
- [Beauty & health](https://e-shop.adscaled.media/en/catalog?category=krasa)
- [Books](https://e-shop.adscaled.media/en/catalog?category=knihy)
- [Toys & kids](https://e-shop.adscaled.media/en/catalog?category=hracky)
- [Garden](https://e-shop.adscaled.media/en/catalog?category=zahrada)

## Shops

- [TechPoint](https://e-shop.adscaled.media/en/shop/techpoint), Praha: Elektronika, kterou sami používáme
- [Horský sklad](https://e-shop.adscaled.media/en/shop/horsky-sklad), Liberec: Vybavení na hory od lidí, kteří tam chodí
- [Lněná dílna](https://e-shop.adscaled.media/en/shop/lnena-dilna), Brno: Oblečení ze lnu šité v Brně
- [Domov & Keramika](https://e-shop.adscaled.media/en/shop/domov-keramika), Olomouc: Ručně točená keramika a věci pro klidný domov
- [Bylinná dílna Květa](https://e-shop.adscaled.media/en/shop/bylinna-dilna-kveta), České Budějovice: Přírodní kosmetika z jihočeských bylin
- [Knihkupectví Stránka](https://e-shop.adscaled.media/en/shop/knihkupectvi-stranka), Plzeň: Knihy vybrané knihkupci, ne algoritmem
- [Dřevěné hračky Hopsa](https://e-shop.adscaled.media/en/shop/drevene-hracky-hopsa), Hradec Králové: Hračky ze dřeva, které přežijí i sourozence
- [Zahradnictví Kvítek](https://e-shop.adscaled.media/en/shop/zahradnictvi-kvitek), Zlín: Semínka, nářadí a rady ze Zlína
- [AdScaled Merch](https://e-shop.adscaled.media/en/shop/adscaled-merch), Praha: Oficiální merch AdScaled

## Other AdScaled products

- [AdScaled](https://www.adscaled.media/en/): Creative digital agency: websites, apps, content and marketing
- [AdScaled Converter](https://converter.adscaled.media/en/): Convert images, documents and PDFs right in your browser
- [AdScaled BG Remover](https://bgremover.adscaled.media/): Remove backgrounds, objects, metadata and more, free in your browser
- [AdScaled LinkBoard](https://linkboard.adscaled.media/): Send links, text and files between your devices, no sign-up

## Optional

- [Sitemap](https://e-shop.adscaled.media/sitemap.xml): every product, shop and category page in all five languages
- [Operator: AdScaled agency](https://www.adscaled.media/en/): AdScaled built and runs this marketplace. Contact: contact@adscaled.media