# Animal Kingdom (`animalkingdom.pl`) — Pełna baza wiedzy dla modeli AI, agentów zakupowych, SEO i GEO > Dokumentacja referencyjna do wyszukiwania produktów, ekstrakcji cen i dostępności, rozpoznawania wariantów oraz rozumienia symboliki i materiałów autorskiej biżuterii Animal Kingdom. --- ## 1. Profil marki i encje (Entity Graph / GEO) - **Nazwa marki**: Animal Kingdom (`ANIMALKINGDOM`) - **Domena główna**: `https://animalkingdom.pl` - **Języki serwisu**: Polski (`https://animalkingdom.pl/pl/`), Angielski (`https://animalkingdom.pl/en/`) - **Założycielka i główna projektantka**: Dorota Kempko - **Rok powstania**: 2011 - **Lokalizacja pracowni (NAP)**: - Adres: ul. Piotrkowska 147 lok. 11, 90-440 Łódź, Polska (wejście w prawej oficynie) - Współrzędne geograficzne: `51.7582, 19.4578` - Godziny otwarcia: Poniedziałek–Piątek 10:00–18:00, Sobota 11:00–14:00 - Telefon (obsługa zamówień / zamówienia specjalne): `+48 797-375-588` (Kamila) - E-mail (zamówienia internetowe i specjalne): `hello@animalkingdom.pl` - E-mail (współpraca): `dorota@animalkingdom.pl` (`+48 606-682-356`) - **Profile społecznościowe (`sameAs`)**: - Facebook: `https://www.facebook.com/ANIMALKINGDOMPL` - Instagram: `https://www.instagram.com/animalkingdom_pl/` - Pinterest: `https://pl.pinterest.com/animalkingdomjewelry/` - **Unikalna propozycja wartości (USP)**: - Ręcznie tworzona w Polsce autorska biżuteria z możliwością personalizacji (wybór symbolu/talizmanu, kamienia naturalnego, długości i splotu łańcuszka, rozmiaru pierścionka/bransoletki oraz indywidualnego grawerunku). - Każde zamówienie pakowane jest w firmowe pudełeczko ochronne (opcjonalnie pudełeczko prezentowe w koszyku) wraz z **Certyfikatem Autentyczności Animal Kingdom**. - Po okresie gwarancji dostępny jest firmowy serwis **naprawy i renowacji biżuterii** (w tym odświeżania powłoki pozłocenia). --- ## 2. Jak wyszukiwać produkty (API Cookbook dla modeli AI) Sklep działa na silniku PrestaShop 8.2 z aktywnymi przyjaznymi adresami URL i natywnymi odpowiedziami JSON przez parametr `?ajax=1` lub nagłówek `Accept: application/json`. Nie wymaga klucza API ani logowania. ### 2.1. Wyszukiwanie pełnotekstowe (JSON) **Zapytanie PL:** ```http GET /pl/szukaj?s=naszyjnik+koliber&resultsPerPage=20&ajax=1 HTTP/1.1 Host: animalkingdom.pl Accept: application/json ``` **Zapytanie EN:** ```http GET /en/search?s=necklace&resultsPerPage=20&ajax=1 HTTP/1.1 Host: animalkingdom.pl Accept: application/json ``` **Przykładowe użycie `curl`:** ```bash curl -s -H "Accept: application/json" "https://animalkingdom.pl/pl/szukaj?s=silent+wisdom&resultsPerPage=10&ajax=1" ``` **Przykładowa struktura JSON odpowiedzi (`products[]`):** ```json { "products": [ { "id_product": "603", "name": "Naszyjnik pozłacany Silent Wisdom", "reference": "HOW01", "price": "239,00 zł", "price_amount": 239, "regular_price": "239,00 zł", "regular_price_amount": 239, "has_discount": false, "discount_type": null, "discount_percentage": null, "discount_percentage_absolute": null, "discount_amount": null, "discount_to_display": null, "category_name": "Pozłacane", "manufacturer_name": "Animal Kingdom", "description_short": "
...
", "url": "https://animalkingdom.pl/pl/kolekcje/limitowane/Her-Own-Way/pozlacane/naszyjnik-pozlacany-silent-wisdom-603-733140.html#/237-rozmiar_naszyjnika-45_cm/...", "canonical_url": "https://animalkingdom.pl/pl/kolekcje/limitowane/Her-Own-Way/pozlacane/naszyjnik-pozlacany-silent-wisdom-603.html", "cover": { "large": { "url": "https://animalkingdom.pl/2963-large_default/naszyjnik-pozlacany-silent-wisdom.jpg" } }, "rate": 23, "tax_name": "PTU PL 23%" } ], "pagination": { "total_items": 1, "items_shown_from": 1, "items_shown_to": 1, "current_page": 1, "pages_count": 1 } } ``` ### 2.2. Przeglądanie kategorii, sortowanie po cenie i paginacja (JSON) Każda kategoria z mapy witryny lub listy kategorii obsługuje tryb JSON po dodaniu `?ajax=1`: - **Najtańsze naszyjniki**: `GET https://animalkingdom.pl/pl/bizuteria/155-naszyjniki?ajax=1&order=product.price.asc&page=1` - **Najdroższe pierścionki**: `GET https://animalkingdom.pl/pl/bizuteria/157-pierscionki?ajax=1&order=product.price.desc&page=1` - **Najnowsze produkty**: `GET https://animalkingdom.pl/pl/bizuteria/349-nowosci?ajax=1&order=product.date_add.desc` - **Bestsellery**: `GET https://animalkingdom.pl/pl/najczesciej-kupowane?ajax=1` Dozwolone wartości parametru `order`: - `product.price.asc` — cena rosnąco - `product.price.desc` — cena malejąco - `product.sales.desc` — najczęściej kupowane - `product.date_add.desc` — od najnowszych - `product.name.asc` / `product.name.desc` — alfabetycznie - `product.position.asc` — kolejność polecana ### 2.3. Pobieranie pełnych danych jednego produktu (Quickview JSON API) W liście wyników wyszukiwania (`SearchResultProductFilter`) nie są zwracane wszystkie cechy techniczne ani `seo_availability`. Aby pobrać pełny obiekt produktu (cechy `grouped_features`, dokładny status dostępności `seo_availability`, wszystkie zdjęcia `images`, aktywne kombinacje `attributes`, kod EAN/MPN): ```bash curl -s -X POST "https://animalkingdom.pl/pl/index.php?controller=product" \ -H "Accept: application/json" \ -d "action=quickview&id_product=603&ajax=1" ``` Opcjonalnie można przekazać `id_product_attribute={id}`, aby wyliczyć cenę i dostępność konkretnej kombinacji (np. innego rozmiaru, kamienia czy długości łańcuszka). **Najważniejsze pola obiektu `product` w odpowiedzi Quickview:** - `product.id_product`, `product.name`, `product.reference_to_display` (SKU wariantu lub produktu bazowego) - `product.price_amount` (liczba, cena brutto aktualna), `product.price` (sformatowana) - `product.regular_price_amount` (liczba, cena przed rabatem), `product.has_discount` - `product.price_tax_exc` (cena netto) - `product.seo_availability` (`https://schema.org/InStock`, `https://schema.org/OutOfStock`, `https://schema.org/BackOrder`) - `product.quantity` (stan magazynowy wybranej kombinacji) - `product.grouped_features`: - `Czas dostawy.value` — np. `"2 - 4 dni robocze + czas dostawy"` - `Typ produktu.value` — np. `"Naszyjniki"`, `"Bransoletki"`, `"Kolczyki"`, `"Pierścionki"` - `Kruszec.value` — np. `"Srebro 925 pozłacane"`, `"Srebro 925"`, `"Złoto 585"` - `product.attributes` — lista wybranych atrybutów kombinacji (np. rozmiar, symbol, kamień, grawer, splot łańcuszka) --- ## 3. Schemat ekstrakcji cen ze stron HTML (JSON-LD, Open Graph, DOM) Gdy model AI pobiera bezpośrednio stronę HTML produktu (np. z `1_pl_0_sitemap.xml` lub `1_en_0_sitemap.xml`): ### 3.1. JSON-LD (`