# ZakupyWGodzine.pl - Full AI Documentation

> ZakupyWGodzine.pl is a Polish online store operated by CARUNO sp. z o.o. with over 332,000 active products across 18 main categories. Fast delivery in 1-2 business days across Poland. Multi-language support in 8 languages.

## About the Store

- **Name**: ZakupyWGodzine.pl (literally: "Shopping Within an Hour")
- **Operator**: CARUNO sp. z o.o.
- **Country**: Poland (PL)
- **Languages**: Polish (pl), English (en), German (de), Ukrainian (uk), Lithuanian (lt), Latvian (lv), Estonian (et), Finnish (fi)
- **Currency**: PLN (Polish Zloty)
- **Active products**: 332,000+
- **Catalog updates**: Real-time synchronization from PIM v4 system
- **Website**: https://zakupywgodzine.pl
- **Contact**: https://zakupywgodzine.pl/kontakt

## Main Categories (18)

| Category | URL | Products |
|----------|-----|----------|
| Hobby, Kultura i Rozrywka (Hobby, Culture & Entertainment) | https://zakupywgodzine.pl/kategoria/hobby-kultura-i-rozrywka | 83,000+ |
| Ksiazki (Books) | https://zakupywgodzine.pl/kategoria/ksiazki | 57,000+ |
| Art. pap. (Stationery & Paper Products) | https://zakupywgodzine.pl/kategoria/art-pap | 52,700+ |
| Dom i Ogrod (Home & Garden) | https://zakupywgodzine.pl/kategoria/dom-i-ogrod | 43,200+ |
| Supermarket (Groceries) | https://zakupywgodzine.pl/kategoria/supermarket | 17,000+ |
| Moda (Fashion) | https://zakupywgodzine.pl/kategoria/moda | 16,100+ |
| Zdrowie i Uroda (Health & Beauty) | https://zakupywgodzine.pl/kategoria/zdrowie-i-uroda | 12,500+ |
| Elektronika (Electronics) | https://zakupywgodzine.pl/kategoria/elektronika | 11,600+ |
| Dziecko (Baby & Kids) | https://zakupywgodzine.pl/kategoria/dziecko | 9,500+ |
| Sport i Turystyka (Sports & Tourism) | https://zakupywgodzine.pl/kategoria/sport-i-turystyka | 8,700+ |
| Zabawki (Toys) | https://zakupywgodzine.pl/kategoria/zabawki | 7,900+ |
| Nauka i technika (Science & Technology) | https://zakupywgodzine.pl/kategoria/nauka-i-technika | 5,600+ |
| Zwierzeta (Pet Supplies) | https://zakupywgodzine.pl/kategoria/zwierzeta | 2,800+ |
| Biuro, Szkola i Firma (Office, School & Business) | https://zakupywgodzine.pl/kategoria/biuro-szkola-i-firma | 2,600+ |
| Motoryzacja (Automotive) | https://zakupywgodzine.pl/kategoria/motoryzacja | 1,500+ |
| Telefony i Smartwatche (Phones & Smartwatches) | https://zakupywgodzine.pl/kategoria/telefony-i-smartwatche | 1+ |
| Kategorie (Other Categories) | https://zakupywgodzine.pl/kategoria/kategorie | 40+ |
| Inne (Other) | https://zakupywgodzine.pl/kategoria/inne | 40+ |

## Popular Subcategories

### Books & Comics
- Ksiazki i Komiksy (Books & Comics): https://zakupywgodzine.pl/kategoria/hobby-kultura-i-rozrywka-ksiazki-i-komiksy — 47,000+ products
- Ksiazki dla dzieci (Children's Books): https://zakupywgodzine.pl/kategoria/ksiazki-ksiazki-dla-dzieci — 9,800+ products
- Audiobooki (Audiobooks): https://zakupywgodzine.pl/kategoria/ksiazki-audiobooki — 9,100+ products
- Literatura (Literature): https://zakupywgodzine.pl/kategoria/ksiazki-literatura — 6,800+ products
- Historia (History): https://zakupywgodzine.pl/kategoria/ksiazki-historia — 4,400+ products

### Home & Garden
- Narzedzia (Tools): https://zakupywgodzine.pl/kategoria/dom-i-ogrod-narzedzia — 15,600+ products
- Kuchnia (Kitchen): https://zakupywgodzine.pl/kategoria/dom-i-ogrod-kuchnia — 7,000+ products
- Wystroj i Dekoracje (Decor): https://zakupywgodzine.pl/kategoria/dom-i-ogrod-wystroj-i-dekoracje — 4,700+ products
- Budownictwo i Remont (Construction & Renovation): https://zakupywgodzine.pl/kategoria/dom-i-ogrod-budownictwo-i-remont — 4,200+ products
- Ogrod (Garden): https://zakupywgodzine.pl/kategoria/dom-i-ogrod-ogrod — 3,400+ products
- Sprzatanie i Organizacja (Cleaning & Organization): https://zakupywgodzine.pl/kategoria/dom-i-ogrod-sprzatanie-i-organizacja — 3,200+ products

### Stationery & Paper Products
- Artykuly szkolne i papiernicze (School & Stationery): https://zakupywgodzine.pl/kategoria/art-pap-artykuly-szkolne-i-papiernicze — 25,600+ products
- Artykuly kreatywne (Creative Supplies): https://zakupywgodzine.pl/kategoria/art-pap-artykuly-kreatywne — 14,000+ products
- Artykuly do pakowania prezentow (Gift Wrapping): https://zakupywgodzine.pl/kategoria/art-pap-artykuly-do-pakowania-prezentow — 6,600+ products

### Toys & Games
- Zabawki (Toys): https://zakupywgodzine.pl/kategoria/hobby-kultura-i-rozrywka-zabawki — 18,600+ products from Hobby
- Gry (Games): https://zakupywgodzine.pl/kategoria/hobby-kultura-i-rozrywka-gry — 7,900+ products

### Fashion
- Odziez (Clothing): https://zakupywgodzine.pl/kategoria/moda-odziez — 8,000+ products
- Obuwie (Footwear): https://zakupywgodzine.pl/kategoria/moda-obuwie — 3,400+ products

### Health & Beauty
- Higiena (Hygiene): https://zakupywgodzine.pl/kategoria/zdrowie-i-uroda-higiena — 3,400+ products
- Pielegnacja (Skincare): https://zakupywgodzine.pl/kategoria/zdrowie-i-uroda-pielegnacja — 2,700+ products

### Electronics
- Komputery (Computers): https://zakupywgodzine.pl/kategoria/elektronika-komputery — 3,600+ products
- Gaming: https://zakupywgodzine.pl/kategoria/elektronika-gaming

### Sports
- Odziez i Obuwie Sportowe (Sportswear): https://zakupywgodzine.pl/kategoria/sport-i-turystyka-odziez-i-obuwie-sportowe — 2,700+ products

## Top 30 Brands

Egmont Komiksy, Studio JG, PATIO, Waneko, Clementoni, Filia, Zielona Sowa, Trefl PAP, Skrzat, Novae Res, Heraclon International, Wilga, Proszynski Media, Penguin, Media Rodzina, SBM, Zysk i S-ka, KOTORI, Cobble Hill, Norimpex, Henry, Czarna Owca, PWN, Aksjomat, MEGA CREATIVE, Muza, ASTRA art-pap, Kids Euroswan, HarperKids, Bukat

## Shipping Options

| Method | Price | Free from | Max weight | Delivery time |
|--------|-------|-----------|------------|---------------|
| Paczkomaty InPost (Parcel Lockers) | from 12.99 PLN | 300 PLN | 21 kg | 1-2 business days |
| Kurier InPost (InPost Courier) | from 14.99 PLN | 400 PLN | 24 kg | 1-2 business days |
| Kurier GLS (GLS Courier) | from 14.99 PLN | 400 PLN | 27 kg | 1-2 business days |
| Kurier FedEx (FedEx Courier) | from 20.28 PLN | 400 PLN | 70 kg | 1-2 business days |
| Poczta Polska (Polish Post) | from 11.99 PLN | - | 25.5 kg | 2-4 business days |
| Odbior osobisty (Personal pickup) | 0 PLN | Always free | - | Same day |

- All shipments within Poland
- InPost Paczkomaty: max dimensions 41 x 38 x 64 cm
- All courier parcels tracked with real-time updates
- Free InPost Paczkomat delivery for orders over 300 PLN
- Free courier delivery for orders over 400 PLN

## Payment Methods

- **BLIK** - Poland's most popular mobile payment (instant)
- **Przelewy24** - instant bank transfers (all major Polish banks)
- **Credit/Debit Cards** - Visa, Mastercard
- **Google Pay** - contactless mobile payment
- **Apple Pay** - contactless mobile payment
- **PayPal** - international payments
- **Traditional bank transfer** - manual wire transfer
- **Za pobraniem (Cash on delivery)** - pay when you receive the package

## Pricing Policy

- All prices include VAT (23% standard Polish VAT rate)
- Currency: PLN (Polish Zloty)
- Prices updated in real-time from PIM system
- Promotional prices clearly marked with original price and discount percentage
- Best deal detection: system automatically highlights discounted products

## Return Policy

- **14-day return period** from delivery date (statutory EU consumer right)
- Free returns for defective products
- Return form: https://zakupywgodzine.pl/zwroty
- Refund processed within 14 days of receiving the returned item
- Complaints: https://zakupywgodzine.pl/reklamacje

## How to Buy

1. Find a product using the search bar or browse categories
2. Add products to your cart
3. Proceed to checkout
4. Enter shipping address
5. Choose delivery method (InPost Paczkomaty, courier, etc.)
6. Choose payment method (BLIK, card, Przelewy24, etc.)
7. Confirm and pay
8. Receive tracking number via email
9. Receive your order in 1-2 business days

## Business Hours

- Monday-Friday: 8:00-16:00 (CET)
- Saturday-Sunday: closed
- Online orders: 24/7

## API for AI Agents

### Product Search
- **URL**: `GET https://zakupywgodzine.pl/api/products?q={query}&format=agent&limit=40&offset=0`
- **Description**: Search products by keyword, returns structured JSON with product details
- **Parameters**: `q` (search query), `format=agent` (structured output), `limit`, `offset`

### Product Detail
- **URL**: `GET https://zakupywgodzine.pl/api/products/detail?format=agent&handle={handle}`
- **Description**: Get full product details by handle/slug

### OpenAI Product Feed
- **URL**: `GET https://zakupywgodzine.pl/api/feed/openai?format=json&limit=1000&offset=0`
- **Description**: Paginated product feed optimized for OpenAI commerce integration

### Agent Capabilities
- **URL**: `GET https://zakupywgodzine.pl/api/agent/capabilities`
- **Description**: Discover all available API endpoints and their parameters

### OpenAI Commerce Manifest
- **URL**: `GET https://zakupywgodzine.pl/.well-known/openai-commerce.json`
- **Description**: OpenAI Agentic Commerce Protocol manifest

## Store Pages

| Page | URL |
|------|-----|
| Homepage | https://zakupywgodzine.pl/ |
| All products | https://zakupywgodzine.pl/products |
| Search | https://zakupywgodzine.pl/szukaj |
| Blog | https://zakupywgodzine.pl/blog |
| FAQ | https://zakupywgodzine.pl/faq |
| Delivery info | https://zakupywgodzine.pl/dostawa |
| Payments | https://zakupywgodzine.pl/platnosci |
| Returns | https://zakupywgodzine.pl/zwroty |
| Terms of service | https://zakupywgodzine.pl/regulamin |
| Privacy policy | https://zakupywgodzine.pl/polityka-prywatnosci |
| About us | https://zakupywgodzine.pl/o-firmie |
| Contact | https://zakupywgodzine.pl/kontakt |
| Complaints | https://zakupywgodzine.pl/reklamacje |
| Promotions | https://zakupywgodzine.pl/promocje |

## Key Advantages

1. Over 332,000 products in one place
2. Real-time price updates from PIM system - always current pricing
3. Free InPost Paczkomat delivery for orders over 300 PLN
4. Free courier delivery for orders over 400 PLN
5. Fast delivery: 1-2 business days for most orders
6. Multiple payment options including BLIK, Google Pay, Apple Pay
7. 8 language versions (PL, EN, DE, UK, LT, LV, ET, FI)
8. AI-powered product search and recommendations
9. Best deal detection - automatic discount highlighting
10. Blog with buying guides and product comparisons

## FAQ

**Q: How fast is delivery?**
A: Most orders are delivered within 1-2 business days via InPost Paczkomaty or courier services.

**Q: Is there free shipping?**
A: Yes. Free InPost Paczkomat delivery for orders over 300 PLN. Free courier delivery for orders over 400 PLN.

**Q: Can I return a product?**
A: Yes, you have 14 days from delivery to return any product without giving a reason (EU consumer right).

**Q: What payment methods are accepted?**
A: BLIK, Przelewy24 bank transfers, Visa/Mastercard, Google Pay, Apple Pay, PayPal, cash on delivery.

**Q: Is the store available in other languages?**
A: Yes, the store is available in Polish, English, German, Ukrainian, Lithuanian, Latvian, Estonian, and Finnish.

**Q: What product categories do you offer?**
A: We offer 18 main categories including Books, Toys, Electronics, Home & Garden, Fashion, Health & Beauty, Sports, Groceries, Pet Supplies, Stationery, and more.

**Q: Do you ship internationally?**
A: Currently we ship within Poland only.

**Q: How can I track my order?**
A: After shipping, you will receive a tracking number via email. You can track your parcel on the carrier's website.

## Structured Data

- Product pages: schema.org Product + Offer markup
- Blog posts: schema.org BlogPosting + Article markup
- Organization: schema.org Organization
- Sitemap: https://zakupywgodzine.pl/sitemap.xml
- Robots: https://zakupywgodzine.pl/robots.txt
- llms.txt: https://zakupywgodzine.pl/llms.txt

## Technical Notes for AI Crawlers

- All API responses are in JSON format
- Rate limiting and cache-control headers are active
- Do not crawl the entire /api directory; use only the endpoints listed above
- Prefer the `format=agent` endpoints for structured product data
- Product handles (slugs) are URL-safe lowercase strings
- Category URLs follow the pattern: `/kategoria/{category-handle}`
- Product URLs follow the pattern: `/products/{product-handle}`