Bezpieczne połączenie API
Łącz się przez HTTPS z uwierzytelnianiem za pomocą tokena Bearer i otrzymuj uporządkowane odpowiedzi w formacie JSON.
DLA PARTNERÓW TECHNOLOGICZNYCH
Monetyzuj swoją platformę dzięki API Catuik
Uzyskaj dostęp przez jedno API do uporządkowanych danych o produktach, promocjach, linkach afiliacyjnych, zamówieniach, prowizjach i statusach. Automatyzuj aktualizacje, śledź konwersje za pomocą SubID i postbacków oraz ogranicz ręczną pracę.
Rozszerzenia przeglądarkiPlatformy cashbackowe i programy lojalnościowePlatformy kuponowe i serwisy z kodami promocyjnymiPorównywarki i narzędzia zakupoweInni partnerzy korzystający z API i danych
API: bezpieczny dostęp i uporządkowane dane
Korzystaj z elastycznych metod API i filtrów, aby pobierać dane o produktach, promocjach, zamówieniach i prowizjach.
Katalog aktualizuje się codziennie
Dane o produktach i promocjach są odświeżane każdego dnia, dzięki czemu witryny produktowe, zestawienia i strony produktów pozostają aktualne bez ręcznych zmian.
Elastyczne dane i atrybucja
Wykorzystuj dane o produkcie, marketplace’ie, sprzedawcy, kategorii i SubID do tworzenia zestawień oraz analizowania wyników według źródła, produktu i publikacji.
Pełne dane o produktach i promocjach
Pobieraj ceny produktów, rabaty, prowizje, obrazy, kategorie, SKU, linki bezpośrednie i afiliacyjne, promocje oraz kody promocyjne.
Dla kogo
Monetyzuj rozszerzenie przeglądarki
Połącz rozszerzenie z Catuik API i pobieraj dane o produktach, cenach, promocjach i kodach promocyjnych oraz gotowe linki afiliacyjne.
Wyświetlaj dopasowane rabaty, oferty cashbackowe i kody promocyjne bezpośrednio na obsługiwanych stronach marketplace’ów. Kieruj użytkowników na stronę produktu lub promocji przez link afiliacyjny i śledź wyniki za pomocą SubID i postbacków.
Cashback i programy lojalnościowe
Pobieraj przez Publisher API dane o zamówieniach i prowizjach, aby naliczać cashback lub punkty lojalnościowe. Skonfiguruj postbacki, aby otrzymywać w czasie rzeczywistym powiadomienia o utworzeniu prowizji lub zmianie jej statusu. Statusy prowizji są automatycznie aktualizowane każdej nocy, a po zakończeniu okresu hold otrzymują status końcowy.
Zagubione zamówienie możesz zgłosić w ciągu 7 dni. Dołącz paragon i zrzut ekranu z marketplace’u, a prowizja zostanie utworzona i przekazana sprzedawcy do standardowego przetworzenia.
Serwisy kuponowe i agregatory kodów promocyjnych
Korzystaj z gotowych zestawień produktów objętych promocjami lub kodami promocyjnymi. Możesz umieścić link do witryny produktowej z pola landing_link zwracanego przez metodę Get promotions list. W razie potrzeby pobieraj z API aktualne promocje i kody promocyjne wraz z kodem, wysokością rabatu i okresem ważności, a następnie twórz własne kolekcje, np. „20% taniej na elektronikę”.
Jeśli kod promocyjny jest dostępny, wyświetl go obok przycisku i skieruj użytkownika na stronę promocji lub listę produktów. Ukrywaj wygasłe lub mniej atrakcyjne oferty na podstawie daty ważności i ustawionych progów rabatu.
Porównywarki cen i agregatory
Pobieraj przez API dane o produktach, cenach, promocjach i linkach afiliacyjnych. Wykorzystuj je do tworzenia witryn produktowych, stron docelowych, agregatorów produktów i stron porównawczych. Kieruj użytkowników na stronę promocji lub bezpośrednio do produktu przez link afiliacyjny.
Wyróżniaj oferty specjalne za pomocą badge’y w witrynach produktowych. Promocje i objęte nimi produkty są aktualizowane automatycznie na podstawie dat ważności, dostępności i aktualnych cen.
Co daje Ci API
Witryny produktowe i treści aktualizują się automatycznie
Dane są odświeżane raz dziennie. Przez API automatycznie pobierasz produkty z aktualnymi cenami, prowizjami, obrazami i gotowymi linkami afiliacyjnymi w formacie JSON przez HTTP, bez ręcznej aktualizacji kart i witryn.
Atrybucja SubID i postbacki
Linki afiliacyjne mogą zawierać parametr SubID. Statystyki są automatycznie grupowane według jego wartości, produktu i źródła. W razie potrzeby skonfiguruj postbacki na koncie: przejdź do Profil → Postback, podaj URL oraz metodę GET lub POST. Serwis będzie wysyłać powiadomienia o konwersjach z kluczowymi polami, takimi jak id, date, subid, publisher_fee, total_cart, currency i status.
Szczegółowe raportowanie prowizji
Metoda Get commissions list zwraca kwotę prowizji, wartość zamówienia, znaczniki czasu, takie jak created_at i updated_at, marketplace oraz przekazany SubID. Dane te pozwalają dokładnie uzgadniać rozliczenia i przypisywać ruch do źródeł.
Promocje i kody promocyjne w jednej integracji
Oddzielne metody zwracają aktywne promocje i kody promocyjne oraz objęte nimi produkty. Na tej podstawie możesz łatwo tworzyć atrakcyjne kolekcje promocyjne.
Jak to działa
1Krok 1
Połączenie
Wygeneruj token na koncie i przekazuj ID źródła w wymaganych zapytaniach.
2Krok 2
Import danych
Pobieraj z Publisher API produkty, promocje i kody promocyjne w ujednoliconym formacie wraz z cenami, obrazami i linkami afiliacyjnymi.
3Krok 3
Publikacja
Twórz po swojej stronie witryny produktowe i zestawienia na podstawie cen, rabatów i linków afiliacyjnych z API.
4Krok 4
Kliknięcie i zamówienie
Użytkownik klika link afiliacyjny, przechodzi na stronę produktu i składa zamówienie.
5Krok 5
Raportowanie i postbacki
Raporty pokazują kwoty, statusy i źródła. Włącz postbacki, aby platforma przesyłała na Twój serwer w czasie rzeczywistym dane o utworzeniu prowizji lub zmianie jej statusu.
6Krok 6
Potwierdzenie prowizji
Po zakończeniu okresu hold prowizja otrzymuje status końcowy: zaakceptowana lub odrzucona. Wykorzystuj ten status w raportowaniu, rozliczeniach i obliczaniu cashbacku.
Postbacki: natychmiastowe powiadomienia o zdarzeniach
Jak działają postbacki
Catuik wysyła powiadomienia na Twój serwer przez HTTP GET lub POST, gdy zostanie zarejestrowana konwersja pochodząca z Twojego linku.
Obsługiwane zdarzenia
Zarejestrowanie zamówienia (pending), jego zaakceptowanie (approved) lub odrzucenie (declined).
Zawartość powiadomienia
ID konwersji, status, wartość zamówienia, prowizja, czas, Twój SubID i inne wybrane parametry.
Atrybucja SubID
Wartość SubID jest przekazywana w postbacku i widoczna w metodzie Get commissions list, dzięki czemu łatwo ustalisz, która strona, kanał lub kreacja wygenerowały zamówienie.
Zalecenia dotyczące bezpieczeństwa
Używaj wyłącznie HTTPS, waliduj parametry, a jeśli to możliwe, ograniczaj dostęp po adresie IP lub za pomocą podpisu po swojej stronie. Nie zapisuj tokenów w logach.
Połączenie
Utwórz endpoint HTTPS i dodaj adres URL postbacku na koncie Catuik. Możesz wysłać powiadomienie testowe i skonfigurować dane, które chcesz otrzymywać.
Główne metody API
METODA
Produkty z linkami afiliacyjnymi
Dane do kart produktów i witryn: cena, prowizja, obrazy, kategoria, marketplace/sklep, SKU oraz dwa linki: external_link jako link bezpośredni i tracking_link jako link afiliacyjny.
Metoda: Get products list with links.
METODA
Promocje i kody promocyjne
Typ promocji: global_sale, sale lub coupon; wysokość rabatu; start_date i end_date; coupon, jeśli dostępny; landing_link do strony promocji.
Metoda: Get promotions list.
METODA
Produkty w promocji
Rabaty, price_discount i discount_percent, prowizja, tracking_link, kategoria, sklep i marketplace.
Metoda: Get promotion products.
METODA
Słownik kategorii
Mapowanie ID kategorii na nazwy wykorzystywane w filtrach i kategoryzacji treści.
Metoda: Get product categories list.
METODA
Prowizje i ich statusy
Status: pending, approved lub declined; commission_amount; cart_amount; daty; marketplace; SubID; pola analityczne na poziomie produktu, jeśli dostępne.
Metoda: Get commissions list.
METODA
Źródła i ich statusy
Pobieraj source_id i status moderacji: verification, approved lub declined. source_id jest wymagany w zapytaniach o produkty, promocje i produkty objęte promocjami.
Metoda: Get source list.
Typowe scenariusze integracji
Scenariusz
Codzienne promocje
Wyświetlaj feed dla wybranego marketplace’u i kategorii. Sortuj oferty według wysokości rabatu i daty wygaśnięcia. Ukrywaj wygasłe oferty na podstawie dat z odpowiedzi API. Po swojej stronie ustawiaj progi cenowe i rabatowe na podstawie otrzymanych danych.
Scenariusz
Wyszukiwanie SKU
Analizuj SKU, linki, słowa kluczowe i treści UGC na swojej platformie, dopasowuj je do danych z API i automatycznie dodawaj linki afiliacyjne lub tematyczne witryny produktowe.
Scenariusz
Spersonalizowane zestawienia
Twórz feedy dopasowane do użytkowników. Przekazuj marketplace i kategorię w zapytaniach, a następnie stosuj po swojej stronie filtry cen i rabatów na podstawie danych z odpowiedzi.
Scenariusz
Rozszerzenie przeglądarki
Rozszerzenie porównuje aktualnie otwartą stronę z Twoimi danymi i wyświetla ikonę rabatu lub cashbacku. Po kliknięciu kieruj użytkownika na stronę promocji lub bezpośrednio do produktu.
Scenariusz
Widget Top 3
Dodaj niewielki blok z dwiema lub trzema najlepszymi ofertami powiązanymi z tematem artykułu. Dobieraj je według wysokości rabatu, daty wygaśnięcia i kategorii, a kliknięcia kieruj przez linki afiliacyjne.
Scenariusz
Strony porównawcze i witryny produktowe
Twórz strony „Najlepsze dziś” z sortowaniem według ceny i rabatu. W witrynach poświęconych konkretnemu marketplace’owi wykorzystuj dane marketplace i store.
TECHNOLOGIA I WYGODA
- Prosty start integracjiHTTP/JSON i uwierzytelnianie za pomocą tokena Bearer.
- Dane w odpowiedzi APIUporządkowane informacje o produktach, promocjach, prowizjach, źródłach i statusach.
- Katalog metod APIKorzystaj z dedykowanych metod do pobierania produktów, promocji, kategorii, prowizji, źródeł i statusów.
- Aktualizacje masoweAktualizuj na dużą skalę witryny produktowe, zestawienia i strony produktów dzięki regularnemu importowi danych.
- Dokładny trackingUżywaj SubID, source_id, linków trackingowych, postbacków i raportów prowizji, aby dokładnie przypisywać ruch do źródeł.
- Feedy produktowe, CSV/YMLKorzystaj z feedów produktowych do masowego importu danych i automatycznych aktualizacji.
- Strony i aplikacjeWykorzystuj dane API na stronach internetowych, w aplikacjach mobilnych, rozszerzeniach, dashboardach i wewnętrznych narzędziach partnerskich.
PUBLISHER API
Połącz się z Catuik API
Jedna integracja dla witryn produktowych i kodów promocyjnych: ujednolicony format danych, gotowe linki afiliacyjne, atrybucja SubID i postbacki dotyczące zmian statusów. Uruchom monetyzację bez ręcznej obsługi.
