public-api
Publiczne REST API v1: odczyt danych przez X-API-Key (limit zapytań zależny od pakietu)
Podsumowanie widoczności AI
Share of Voice, sentyment i pozycja per platforma za ostatnie N dni.
Ostatnie sprawdzenia widoczności
Lista ostatnich wyników sprawdzeń widoczności (wzmianki o marce, sentyment, pozycja).
Dzienny trend Share of Voice
Dzienny Share of Voice (%) po pytaniach generycznych, z podziałem per platforma.
Ranking pytań (SoV)
Ranking Share of Voice per pytanie po generycznych pytaniach mapy brandowej: najmocniejsze pytania i luki.
Mapa tematyczna
Lista śledzonych pytań z mapy tematycznej ze statusem luki AI.
Lista opublikowanych treści
Lista treści GEO z ocenami i statusem publikacji.
Podsumowanie wizyt botów AI
Zagregowane statystyki wizyt crawlerów AI (GPTBot, ClaudeBot, PerplexityBot itd.).
Dzienne wizyty botów AI
Dzienna liczba wizyt crawlerów AI z podziałem per bot (GPTBot, ClaudeBot, PerplexityBot itd.).
Podsumowanie ruchu z AI
Ruch z platform AI (ChatGPT, Perplexity itd.) przez GA4 lub Plausible.
Dzienny ruch z AI
Dzienne rekordy ruchu z AI per źródło (sesje, użytkownicy, odsłony).
Katalog śledzonych produktów
Stronicowana kursorem lista śledzonych produktów. Przekaż `meta.next_cursor` jako `?cursor=`, aby pobrać kolejną stronę.
Podsumowanie widoczności produktów
Agregat na poziomie katalogu: wskaźnik wzmianek (Share of Voice), problemy cenowe, halucynacje, statystyki per produkt.
Share of Shelf
Share of Shelf w zakupowych odpowiedziach AI — łącznie + per kategoria + per platforma, każde z trendem okres-do-okresu.
Widoczność per SKU
Dzienny trend widoczności per SKU (pozycja/konkurenci, atrybuowany z zakupowych pytań kategorii) plus historia poprawności cen.
Przychód atrybuowany do AI
Przychód netto per kategoria lub per SKU, z poziomami dowodu AI (twardy / deklarowany / prawdopodobny) raportowanymi osobno — nigdy nie sumowanymi.
ROI kanału AI
ROI kanału AI: koszt (subskrypcja + treści + opcjonalne zużycie AI) vs przychód twardy i szacowany, raportowane osobno (§2).
Dzienny trend atrybucji
Dzienne sesje i sesje ze źródeł AI z pixela atrybucji.
Wykryte halucynacje
Lista sprawdzeń halucynacji AI o marce, z poziomem istotności i statusem takedown.
Podsumowanie Brand Safety
Agregat: wskaźnik halucynacji, podział per istotność i platformę, liczba nierozwiązanych krytycznych.
Upsert jednego zamówienia
Kanoniczny ingest zamówień. Idempotentny upsert po external_id (source_platform='api'); wyślij to samo external_id ponownie, aby zaktualizować status (np. zwroty/anulacje). Wymaga scope orders:write.
Lista zsynchronizowanych zamówień
Minimalna lista do debugowania integracji (bez pozycji zamówień). Wymaga scope orders:read.
Upsert paczki zamówień
Do 500 zamówień na żądanie. Częściowe sukcesy — nieudane zamówienia trafiają do `errors` z ich indeksem.