Sichere API-Verbindung
Verbinde Dich über HTTPS mit Bearer-Token-Authentifizierung und erhalte strukturierte JSON-Antworten.
FÜR TECHNOLOGIEPARTNER
Monetarisiere Deine Plattform mit der Catuik API
Greife über eine zentrale API auf strukturierte Daten zu Produkten, Deals, Affiliate-Links, Bestellungen, Provisionen und Status zu. Automatisiere Updates, tracke Conversions mit SubID und Postbacks und reduziere manuellen Aufwand.
Browser-ErweiterungenCashback & LoyaltyCoupon- & Promo-Code-PlattformenVergleichs- & Shopping-ToolsWeitere API- und Datenpartner
API: sicherer Zugriff und strukturierte Daten
Greife über flexible API-Methoden und Filter auf Produkt-, Deal-, Bestell- und Provisionsdaten zu.
Tägliche Katalog-Updates
Produkt- und Deal-Daten werden täglich aktualisiert. So bleiben Storefronts, Produktauswahlen und Produktseiten ohne manuelle Änderungen aktuell.
Flexible Daten und Attribution
Nutze Produkt-, Marketplace-, Verkäufer-, Kategorie- und SubID-Daten, um Produktauswahlen zu erstellen und Ergebnisse nach Source, Produkt und Platzierung auszuwerten.
Vollständige Produkt- und Deal-Daten
Erhalte Produktpreise, Rabatte, Provisionen, Bilder, Kategorien, SKUs, Direktlinks, Affiliate-Links, Deals und Promo-Codes.
Für wen die API geeignet ist
Browser-Erweiterung monetarisieren
Verbinde Deine Erweiterung mit der Catuik API und erhalte Produktdaten, Preise, Deals, Promo-Codes und fertige Affiliate-Links.
Zeige passende Rabatte, Cashback-Angebote oder Promo-Codes direkt auf unterstützten Marketplace-Seiten. Leite Nutzer*innen über einen Affiliate-Link zur Produkt- oder Deal-Seite und tracke Ergebnisse mit SubID und Postbacks.
Cashback & Loyalty
Erhalte Bestell- und Provisionsdaten über die Publisher API, um Cashback oder Loyalty-Punkte zu berechnen. Richte Postbacks ein und erhalte Echtzeitbenachrichtigungen, wenn Provisionen erstellt werden oder sich ihr Status ändert. Provisionsstatus werden jede Nacht automatisch aktualisiert und nach Ablauf der Haltefrist finalisiert.
Nicht erfasste Bestellungen können innerhalb von 7 Tagen registriert werden. Reiche einen Kassenbeleg und einen Marketplace-Screenshot ein. Die Provision wird dann erstellt und vom Verkäufer im Standardprozess bearbeitet.
Coupon-Services und Promo-Code-Aggregatoren
Nutze fertige Produktauswahlen mit Deals oder Promo-Codes. Du kannst einfach einen Link zu einer Storefront aus dem Feld landing_link der Methode Get promotions list platzieren. Bei Bedarf rufst Du aktuelle Deals und Promo-Codes über die API ab – inklusive Code, Rabatthöhe und Gültigkeitszeitraum – und erstellst eigene Kollektionen wie „20 % Rabatt auf Elektronik“.
Wenn ein Promo-Code verfügbar ist, zeige ihn neben dem Button an und leite Nutzer*innen zur Deal-Seite oder Produktliste weiter. Blende abgelaufene oder unattraktive Angebote anhand von Ablaufdaten und Rabattschwellen aus.
Preisvergleich & Aggregatoren
Erhalte Produkt-, Preis-, Deal- und Affiliate-Link-Daten über die API. Nutze sie für Storefronts, Landingpages, Produktaggregatoren und Vergleichsseiten. Leite Nutzer*innen über einen Affiliate-Link zu einer Deal-Seite oder direkt zu einer Produktliste weiter.
Hebe Sonderangebote mit Badges in Deinen Storefronts hervor. Deals und teilnehmende Produkte werden anhand von Gültigkeitsdaten, Verfügbarkeit und Preisrelevanz automatisch aktualisiert.
Was Dir die API bietet
Automatisch aktualisierte Storefronts und Inhalte
Die Daten im System werden einmal täglich aktualisiert. Über die API erhältst Du automatisch Produkte mit aktuellen Preisen, Provisionen, Bildern und fertigen Affiliate-Links im JSON/HTTP-Format. Manuelle Änderungen an Produktkarten und Produktauswahlen entfallen.
SubID-Attribution und Postbacks
Affiliate-Links können einen SubID-Parameter enthalten. Statistiken werden automatisch nach diesem Wert, Produkt und Source gruppiert. Bei Bedarf kannst Du Postbacks in Deinem Account einrichten: Gehe zu Profil → Postback, gib URL und Methode – GET oder POST – an. Der Service sendet Conversion-Benachrichtigungen mit wichtigen Feldern wie id, date, subid, publisher_fee, total_cart, currency und status.
Detailliertes Provisionsreporting
Die Methode Get commissions list liefert Provisionsbetrag, Bestellwert, Zeitstempel wie created_at und updated_at, die Marketplace-Source und die übergebene SubID. Das reicht für einen präzisen Finanzabgleich und eine genaue Traffic-Attribution.
Deals und Promo-Codes über eine Integration
Separate Methoden liefern aktive Deals und Coupon-Angebote sowie die daran teilnehmenden Produkte. So erhältst Du eine praktische Datenquelle für stark nachgefragte Deal-Kollektionen.
So funktioniert es
1Schritt 1
Verbindung
Generiere ein Token in Deinem Account und gib die source_id in den Requests an.
2Schritt 2
Datenimport
Rufe Produkte, Deals und Promo-Codes über die Publisher API in einem einheitlichen Format ab – zusammen mit Preisen, Bildern und Affiliate-Links.
3Schritt 3
Veröffentlichung
Erstelle auf Deiner Seite Storefronts und Produktauswahlen mit Produktpreisen, Rabatten und Affiliate-Links aus der API.
4Schritt 4
Klick und Bestellung
Nutzer*innen klicken auf einen Affiliate-Link, gelangen zu einer Produktliste und geben eine Bestellung auf.
5Schritt 5
Reporting und Postback
Reports zeigen Beträge, Status und Sources. Aktiviere Postbacks, damit die Plattform Provisionsdaten in Echtzeit an Deinen Server sendet, sobald sie erstellt oder aktualisiert werden.
6Schritt 6
Provisionsbestätigung
Nach Ablauf der Haltefrist erhält die Provision ihren finalen Status: approved oder declined. Nutze den finalen Status für Reporting, Abgleich und Cashback-Berechnungen.
Postbacks: sofortige Ereignisbenachrichtigungen
Postback-Mechanik
Catuik sendet Benachrichtigungen per HTTP GET oder POST an Deinen Server, wenn über Deinen Link eine Conversion erfasst wird.
Unterstützte Ereignisse
Bestellung erfasst (pending), Bestellung genehmigt (approved) oder Bestellung abgelehnt (declined).
Inhalt der Benachrichtigung
Conversion-ID, Status, Bestellwert, Provision, Zeitpunkt, Deine SubID und weitere ausgewählte Parameter.
SubID-Attribution
Der SubID-Wert wird im Postback übermittelt und ist in der Methode Get commissions list sichtbar. So erkennst Du schnell, welche Seite, welcher Kanal oder welches Werbemittel die Bestellung generiert hat.
Sicherheitsempfehlungen
Nutze ausschließlich HTTPS, validiere Parameter, beschränke den Zugriff auf Deiner Seite gegebenenfalls per IP oder Signatur und schreibe Tokens nicht in Logs.
Verbindung
Erstelle einen HTTPS-Endpunkt und füge die Postback-URL in Deinem Catuik-Account hinzu. Ein Testversand ist verfügbar. Lege fest, welche Daten Du in der Benachrichtigung erhalten möchtest.
Wichtige API-Methoden
METHODE
Produkte mit Affiliate-Links
Für Produktkarten und Storefronts: Preis, Provision, Bilder, Kategorie, Marketplace/Shop, SKU sowie zwei Links: external_link für den Direktlink und tracking_link für den Affiliate-Link.
Methode: Get products list with links.
METHODE
Deals und Promo-Codes
Deal-Typ: global_sale, sale oder coupon; Rabatthöhe; start_date und end_date; coupon, sofern verfügbar; landing_link der Deal-Seite.
Methode: Get promotions list.
METHODE
Produkte innerhalb eines Deals
Rabatte, price_discount und discount_percent, Provision, tracking_link, Kategorie, Shop und Marketplace.
Methode: Get promotion products.
METHODE
Kategorieverzeichnis
Zuordnung zwischen Kategorie-ID und Titel für Filter und Content-Kategorisierung.
Methode: Get product categories list.
METHODE
Provisionen und Bestellstatus
Status: pending, approved oder declined; commission_amount; cart_amount; Datumsangaben; Marketplace; SubID; Analysefelder auf Produktebene, sofern verfügbar.
Methode: Get commissions list.
METHODE
Sources und ihre Status
Erhalte source_id und Moderationsstatus: verification, approved oder declined. Die source_id ist für Requests zu Produkten, Deals und Produkten innerhalb von Deals erforderlich.
Methode: Get source list.
Typische Integrationsszenarien
Szenario
Tägliche Deals
Zeige einen Feed nach ausgewähltem Marketplace und Kategorie. Sortiere nach Rabatthöhe und Ablaufdatum. Blende abgelaufene Angebote anhand der Datumsangaben aus der Antwort aus. Lege Preis- und Rabattschwellen auf Deiner Seite anhand der erhaltenen Felder fest.
Szenario
SKU-Suche
Analysiere SKUs, Links, Keywords und UGC-Content auf Deiner Plattform, gleiche sie mit API-Daten ab und füge automatisch Affiliate-Links oder thematische Storefronts hinzu.
Szenario
Personalisierte Produktauswahlen
Erstelle Feeds für einzelne Nutzer*innen. Gib Marketplace und Kategorie in Requests an und wende anhand der Antwortdaten lokale Preis- und Rabattfilter an.
Szenario
Browser-Erweiterung
Die Erweiterung gleicht die aktuelle Seite mit Deinen Daten ab und zeigt ein Rabatt- oder Cashback-Symbol. Beim Klick leitest Du Nutzer*innen zur Deal-Seite oder direkt zur Produktliste weiter.
Szenario
Top-3-Widget
Füge einen kleinen Block mit zwei oder drei Top-Angeboten passend zum Artikelthema ein. Wähle Angebote nach Rabatt, Ablaufdatum und Kategorie aus und leite Klicks über Affiliate-Links weiter.
Szenario
Vergleichsseiten und Storefronts
Erstelle „Heute am besten“-Seiten mit Sortierung nach Preis und Rabatt. Nutze für Storefronts mit Fokus auf einen bestimmten Marketplace die Marketplace- und Shop-Daten.
TECHNOLOGIE UND KOMFORT
- Einfacher IntegrationsstartHTTP/JSON und Bearer-Token-Authentifizierung.
- API-AntwortparameterStrukturierte Produkt-, Deal-, Provisions-, Source- und Statusdaten in API-Antworten.
- API-MethodenkatalogNutze eigene Methoden für Produkte, Deals, Kategorien, Provisionen, Sources und Status.
- MassenaktualisierungenAktualisiere Storefronts, Produktauswahlen und Produktseiten in großem Umfang über regelmäßige Datenimporte.
- Präzises TrackingNutze SubID, source_id, Tracking-Links, Postbacks und Provisionsreports für eine korrekte Traffic-Attribution.
- Produktfeeds, CSV/YMLNutze Produktfeeds für umfangreiche Importe und automatisierte Updates.
- Website und AppNutze API-Daten auf Websites, in mobilen Apps, Erweiterungen, Dashboards oder internen Partner-Tools.
PUBLISHER API
Catuik API verbinden
Eine Integration für Storefronts und Promo-Codes: einheitliches Datenformat, fertige Affiliate-Links, SubID-Attribution und Status-Postbacks. Starte die Monetarisierung ohne manuelle Routinearbeit.
