API-Übersicht · products.ai Docs

Vorschau: Die products.ai API gibt es auf Anfrage. Diese Seite beschreibt, wie sie zum Start funktioniert. Tool-Namen und Felder auf dieser Seite sind nur Beispiele, bis die API-Docs erscheinen.

Die products.ai API liefert deinem Produkt die Antworten, die Pius Bot im Chat gibt, als Daten: welches Produkt zu einer Frage passt, warum es passt, warum nicht die anderen und bei welchem Shop du es kaufst. Sie ist für Unternehmen und Entwickler gedacht, und Zugang gibt es auf Anfrage.

Für wen ist die API gedacht?

Für Unternehmen und Entwickler, die Produkte und Angebote in ihre eigene App holen wollen, zum Beispiel für einen Shopping-Assistenten in ein paar Ländern oder einen Planer, der Ausrüstung vorschlägt. Der Tarif „In deinem Produkt“ läuft über die API oder MCP.

Zwei andere Wege sind einfacher, wenn sie besser zu dir passen. Willst du nur Antworten für dich selbst, braucht products.ai chat die wenigste Einrichtung. Willst du products.ai in dem KI-Assistenten nutzen, den du schon hast, ist MCP der kürzere Weg.

Wie bekommst du Zugang?

Du fragst ihn an, und jede Anfrage liest ein Mensch in Amsterdam.

Öffne das Zugangsformular und wähl Die API nutzen.
Trag deine geschäftliche E-Mail-Adresse ein, deine Firma oder dein Projekt, und was du baust und wo.
Klick auf Zugang anfragen. Dein E-Mail-Programm öffnet sich mit einer vorausgefüllten Nachricht an [email protected], und gesendet wird erst, wenn du selbst auf Senden klickst.

Du kannst auch direkt an [email protected] schreiben. Zum Zugang gehört eine eigene Vereinbarung, getrennt von den AGB für Verbraucher, und diese Vereinbarung regelt die Bedingungen für deine Nutzung.

Welche Tools hat die API?

Vier, im aktuellen Beispielentwurf:

Tool	Was es liefert
`search_products`	Produkte zu einer Frage in normaler Sprache
`get_product`	Ein Produkt per Barcode: technische Daten, Varianten und Alternativen
`compare_products`	Produkte nebeneinander, per Barcode
`get_offers`	Gelistete Angebote mit Preis, Lagerbestand und dem Datum, an dem jedes gelistet wurde

Wie sieht eine search_products-Antwort aus?

Zuerst eine Empfehlung mit ihren Gründen, danach, wo du sie kaufst. Diese Beispielantwort gehört zur Frage „Kopfhörer mit Noise Cancelling unter €300 für Reisen“:

{
  "best_fit": "Sony WH-1000XM5",
  "why_it_fits": [
    "Stärkstes ANC für Flüge",
    "€73,01 unter deinem Budget"
  ],
  "why_not": [
    "Momentum 4: weniger leise",
    "QC Ultra: über dem Budget"
  ],
  "best_pick": {
    "shop": "bol.com",
    "price": 226.99,
    "why": "Auf Lager, kostenlose Lieferung in 1–2 Tagen"
  },
  "second_chance": [{
    "condition": "Refurbished, Zustand A",
    "price": 179.00,
    "why_not": "Neuware gewünscht"
  }]
}

Feld	Bedeutung
`best_fit`	Das Produkt, das am besten zur Frage passt
`why_it_fits`	Kurze Gründe, bezogen auf das, was gefragt wurde
`why_not`	Eine Zeile für jede Alternative, die nicht gewählt wurde
`best_pick`	Der Shop, bei dem du kaufst: `shop`, `price` und `why` (Lagerbestand und Lieferung)
`second_chance`	Angebote außerhalb der Frage, die trotzdem passen können, jeweils mit eigenem `why_not`

Zeig die Gründe in deiner App, neben der Empfehlung und dem Shop. Sie sagen deinen Nutzern, warum dieses Produkt und warum dieser Shop, und genau diese Ehrlichkeit macht die nächste Empfehlung glaubwürdig.

Wie werden Produkte und Angebote zugeordnet?

Jedes Produkt wird über seinen Barcode zugeordnet, die GTIN (in Europa EAN, in Nordamerika UPC). Der Sony WH-1000XM5 hat zum Beispiel die GTIN 4548736132580. So bleiben Modelle, die sich nur um eine Ziffer unterscheiden, wie der WH-1000XM4 und der WH-1000XM5, getrennte Datensätze.

Jedes Angebot trägt seinen Shop und das Datum, an dem der Shop es gelistet hat. Preise kommen nur aus Angeboten, die Shops listen, und Pius Bot schreibt nie selbst einen Preis. Ein altes Angebot behält sein Datum, damit deine Nutzer sehen, wie aktuell ein Preis ist. Shops im Land deiner Nutzer kommen zuerst. Wo kaufen erklärt, wie Pius den Shop auswählt.

Was ist auf dieser Seite nur ein Beispiel?

Die Tool-Namen, die Feldnamen und die Struktur der Antwort auf dieser Seite sind Beispiele, bis die API-Docs erscheinen. Nutz sie, um deine Integration zu planen, aber bau noch keinen Produktivcode darauf auf, denn die Namen können sich noch ändern.

Was du stattdessen mit dem Zugang bekommst: die echten Docs, wie du dich verbindest und was deine Vereinbarung abdeckt. Manche Angebote tragen Affiliate-Links, die in den Daten gekennzeichnet sind; Affiliate-Links und Provision erklärt, wie das funktioniert und was deine App offenlegen muss.