Sichere API-Verbindung
Stellen Sie die Verbindung über HTTPS mit Bearer-Token-Autorisierung her und erhalten Sie strukturierte JSON-Antworten.
FÜR TECHNOLOGIEPARTNER
Monetarisieren Sie Ihre Plattform mit der Catuik API
Greifen Sie über eine einzige API auf strukturierte Daten zu Produkten, Aktionen, Affiliate-Links, Bestellungen, Provisionen und Status zu. Automatisieren Sie Aktualisierungen, verfolgen Sie Conversions mit SubID und Postbacks und reduzieren Sie manuelle Arbeit.
Browser-ErweiterungenCashback & LoyaltyCoupon- & Promo-Code-PlattformenVergleichs- & Shopping-ToolsWeitere API- und Datenpartner
API: Sicherer Zugriff und strukturierte Daten
Greifen Sie über flexible API-Methoden und Filter auf Produkt-, Aktions-, Bestell- und Provisionsdaten zu.
Tägliche Katalogaktualisierungen
Produkt- und Aktionsdaten werden täglich aktualisiert. So bleiben Ihre Storefronts, Auswahlen und Produktseiten ohne manuelle Änderungen auf dem neuesten Stand.
Flexible Daten und Attribution
Nutzen Sie Produkt-, Marketplace-, Verkäufer-, Kategorie- und SubID-Daten, um Auswahlen zu erstellen und Ergebnisse nach Source, Produkt und Platzierung zu analysieren.
Vollständige Produkt- und Aktionsdaten
Erhalten Sie Produktpreise, Rabatte, Provisionen, Bilder, Kategorien, SKUs, direkte Links, Affiliate-Links, Aktionen und Promo-Codes.
Für wen die API geeignet ist
Monetarisieren Sie Ihre Browser-Erweiterung
Verbinden Sie Ihre Erweiterung mit der Catuik API und erhalten Sie Produktdaten, Preise, Aktionen, Promo-Codes und fertige Affiliate-Links.
Zeigen Sie relevante Rabatte, Cashback-Angebote oder Promo-Codes direkt auf unterstützten Marketplace-Seiten an. Leiten Sie Nutzer über einen Affiliate-Link zur Produkt- oder Aktionsseite weiter und verfolgen Sie die Ergebnisse mit SubID und Postbacks.
Cashback & Loyalty
Ihr Provisionsstatus wird jede Nacht aktualisiert. Erhalten Sie Bestell- und Provisionsdaten über die Publisher API und berechnen Sie Cashback oder Loyalty-Punkte. Konfigurieren Sie Postbacks passend zu Ihrem Prozess und erhalten Sie Echtzeitbenachrichtigungen, wenn Provisionen erstellt werden oder sich ihr Status ändert. Nach Ablauf des Hold-Zeitraums werden die Provisionsstatus automatisch aktualisiert.
Nicht erfasste Bestellungen können innerhalb von 7 Tagen gemeldet werden. Stellen Sie einen Beleg und einen Marketplace-Screenshot bereit. Anschließend wird die Provision erstellt und vom Verkäufer im regulären Prozess bearbeitet.
Coupon-Services und Promo-Code-Aggregatoren
Nutzen Sie fertige Produktauswahlen mit Aktionen oder Promo-Codes. Sie können einfach einen Link zu einer Storefront aus dem Feld landing_link der Methode Get promotions list verwenden. Bei Bedarf können Sie aktuelle Aktionen und Promo-Codes inklusive Code, Rabatthöhe und Gültigkeitszeitraum über die API abrufen und eigene Kollektionen wie „20 % Rabatt auf Elektronik“ erstellen.
Wenn ein Promo-Code verfügbar ist, zeigen Sie ihn neben dem Button an und leiten Sie den Nutzer zur Aktionsseite oder zum Produktlisting weiter. Blenden Sie abgelaufene oder unattraktive Angebote anhand des Ablaufdatums und definierter Rabattschwellen aus.
Preisvergleich & Aggregatoren
Erhalten Sie Produkt-, Preis-, Aktions- und Affiliate-Link-Daten über die API. Nutzen Sie diese Daten für Storefronts, Landingpages, Produktaggregatoren und Vergleichsseiten. Leiten Sie Nutzer über einen Affiliate-Link auf eine Aktionsseite oder direkt zu einem Produktlisting weiter.
Heben Sie Sonderangebote in Ihren Storefronts mit Badges hervor. Aktionen und teilnehmende Produkte werden automatisch auf Grundlage von Gültigkeitsdaten, Lagerverfügbarkeit und Preisrelevanz aktualisiert.
Was Ihnen die API bietet
Automatisch aktualisierte Storefronts und Inhalte
Die Daten im System werden einmal täglich aktualisiert. Über die API erhalten Sie automatisch Produkte mit aktuellen Preisen, Provisionen, Bildern und fertigen Affiliate-Links im JSON/HTTP-Format. Dadurch müssen Produktkarten und Auswahlen nicht mehr manuell aktualisiert werden.
SubID-Attribution und Postbacks
Affiliate-Links können einen SubID-Parameter enthalten. Statistiken werden automatisch nach diesem Wert, Produkt und Source gruppiert. Bei Bedarf können Sie Postbacks in Ihrem Konto einrichten: Gehen Sie zu Profil → Postback, geben Sie die URL und die Methode GET oder POST an. Der Service sendet anschließend Conversion-Benachrichtigungen mit wichtigen Feldern wie id, date, subid, publisher_fee, total_cart, currency und status.
Detailliertes Provisionsreporting
Die Methode Get commissions list liefert den Provisionsbetrag, den Bestellbetrag, Zeitstempel wie created_at und updated_at, die Marketplace-Source und die von Ihnen übergebene SubID. Diese Daten reichen für eine präzise finanzielle Abstimmung und Traffic-Attribution aus.
Aktionen und Promo-Codes über eine Integration
Separate Methoden liefern aktive Aktionen und Coupon-Angebote sowie die daran teilnehmenden Produkte. Damit steht Ihnen eine praktische Datenquelle für stark nachgefragte Deal-Kollektionen zur Verfügung.
So funktioniert es
1Schritt 1
Anbindung
Generieren Sie einen Token in Ihrem Konto und geben Sie die Source-ID in den Anfragen an.
2Schritt 2
Datenimport
Erhalten Sie Produkte, Aktionen und Promo-Codes über die Publisher API in einem einheitlichen Format zusammen mit Preisen, Bildern und Affiliate-Links.
3Schritt 3
Veröffentlichung
Erstellen Sie auf Ihrer Seite Storefronts und Auswahlen mit Produktpreisen, Rabatten und Affiliate-Links aus der API.
4Schritt 4
Klick und Bestellung
Der Nutzer klickt auf einen Affiliate-Link, gelangt zu einem Produktlisting und gibt eine Bestellung auf.
5Schritt 5
Reporting und Postback
Reports zeigen Beträge, Status und Sources. Aktivieren Sie Postback, damit die Plattform Provisionsdaten in Echtzeit an Ihren Server sendet, sobald eine Provision erstellt oder aktualisiert wird.
6Schritt 6
Provisionsbestätigung
Nach Ablauf des Hold-Zeitraums erhält die Provision ihren finalen Status: approved oder declined. Verwenden Sie den finalen Status für Reporting, Abstimmung und Cashback-Berechnungen.
Postbacks: sofortige Ereignisbenachrichtigungen
Postback-Mechanik
Catuik sendet Benachrichtigungen über HTTP GET oder POST an Ihren Server, sobald eine Conversion über Ihren Link erfasst wird.
Unterstützte Ereignisse
Bestellung erfasst (pending), Bestellung genehmigt (approved) oder Bestellung abgelehnt (declined).
Inhalt der Benachrichtigung
Conversion-ID, Status, Bestellbetrag, Provision, Zeitpunkt, Ihre SubID und weitere ausgewählte Parameter.
SubID-Attribution
Der SubID-Wert ist im Postback enthalten und in Get commissions list sichtbar. So können Sie eindeutig erkennen, welche Seite, welcher Kanal oder welches Creative die Bestellung generiert hat.
Sicherheitsempfehlungen
Akzeptieren Sie ausschließlich HTTPS, validieren Sie Parameter, beschränken Sie den Zugriff auf Ihrer Seite gegebenenfalls per IP oder Signatur und schreiben Sie keine Tokens in Logs.
Anbindung
Erstellen Sie einen HTTPS-Endpunkt und hinterlegen Sie die Postback-URL in Ihrem Catuik-Konto. Ein Testversand ist verfügbar. Konfigurieren Sie, welche Daten Sie in der Benachrichtigung erhalten möchten.
Wichtigste API-Methoden
METHODE
Produkte mit Affiliate-Links
Für Produktkarten und Storefronts: Preis, Provision, Bilder, Kategorie, Marketplace/Shop, SKU sowie zwei Links: external_link als direkter Link und tracking_link als Affiliate-Link.
Methode: Get products list with links.
METHODE
Aktionen und Promo-Codes
Aktionstyp global_sale, sale oder coupon; Rabatthöhe; start_date und end_date; coupon, sofern verfügbar; landing_link zur Aktionsseite.
Methode: Get promotions list.
METHODE
Produkte innerhalb einer Aktion
Rabatte, price_discount und discount_percent, Provision, tracking_link, category, store und marketplace.
Methode: Get promotion products.
METHODE
Kategorienverzeichnis
Zuordnung zwischen Kategorie-ID und Titel für Filter und die Kategorisierung von Inhalten.
Methode: Get product categories list.
METHODE
Provisionen und Bestellstatus
Status pending, approved oder declined; commission_amount; cart_amount; Datumsangaben; Marketplace; SubID sowie Analytics-Felder auf Produktebene, sofern verfügbar.
Methode: Get commissions list.
METHODE
Sources und ihre Status
Erhalten Sie source_id und den Moderationsstatus verification, approved oder declined. Die source_id ist für Anfragen zu Produkten, Aktionen und Produkten innerhalb von Aktionen erforderlich.
Methode: Get source list.
Typische Integrationsszenarien
Szenario
Tägliche Deals
Zeigen Sie einen Feed für den ausgewählten Marketplace und die ausgewählte Kategorie an. Sortieren Sie nach Rabatthöhe und Ablaufdatum. Blenden Sie abgelaufene Angebote anhand der Datumsangaben aus der API-Antwort aus. Legen Sie auf Ihrer Seite Preis- und Rabattschwellen anhand der erhaltenen Felder fest.
Szenario
SKU-Suche
Analysieren Sie SKUs, Links, Keywords und UGC-Content auf Ihrer Plattform, gleichen Sie diese Daten mit den API-Daten ab und ergänzen Sie automatisch Affiliate-Links oder thematische Storefronts.
Szenario
Personalisierte Auswahlen
Erstellen Sie individuelle Feeds für jeden Nutzer. Geben Sie Marketplace und Kategorie in den Anfragen an und wenden Sie anhand der Antwortdaten lokale Filter nach Preis und Rabatt an.
Szenario
Browser-Erweiterung
Die Erweiterung gleicht die aktuelle Seite mit Ihren Daten ab und zeigt ein Rabatt- oder Cashback-Symbol an. Nach einem Klick wird der Nutzer zur Aktionsseite oder direkt zum Produktlisting weitergeleitet.
Szenario
Top-3-Widget
Fügen Sie einen kleinen Block mit zwei oder drei der besten Angebote passend zum Thema des Artikels ein. Wählen Sie Angebote nach Rabatt, Ablaufdatum und Kategorie aus und leiten Sie Klicks über Affiliate-Links weiter.
Szenario
Vergleichsseiten und Storefronts
Erstellen Sie Seiten wie „Beste Angebote heute“ mit Sortierung nach Preis und Rabatt. Verwenden Sie für Storefronts, die auf einen bestimmten Marketplace ausgerichtet sind, Marketplace- und Shop-Daten.
TECHNOLOGIE UND KOMFORT
- Einfacher IntegrationsstartHTTP/JSON, Token-Autorisierung mit Bearer.
- Parameter der API-AntwortenStrukturierte Produkt-, Aktions-, Provisions-, Source- und Statusdaten in den API-Antworten.
- API-MethodenkatalogNutzen Sie dedizierte Methoden für Produkte, Aktionen, Kategorien, Provisionen, Sources und Status.
- MassenaktualisierungenAktualisieren Sie Storefronts, Auswahlen und Produktseiten in großem Umfang durch regelmäßige Datenimporte.
- Präzises TrackingNutzen Sie SubID, source_id, Tracking-Links, Postbacks und Provisionsreports für eine korrekte Traffic-Attribution.
- Produktfeeds, CSV/YMLNutzen Sie Produktfeeds für umfangreiche Importe und automatisierte Aktualisierungen.
- Website und AppNutzen Sie API-Daten auf Websites, in mobilen Apps, Erweiterungen, Dashboards oder internen Partnertools.
PUBLISHER API
Catuik API anbinden
Eine Integration für Storefronts und Promo-Codes: einheitliches Datenformat, fertige Affiliate-Links, SubID-Attribution und Status-Postbacks. Starten Sie die Monetarisierung ohne manuelle Routinearbeit.
