API-overzicht · products.ai docs

Preview: De products.ai API is op aanvraag beschikbaar. Deze pagina beschrijft hoe hij werkt bij de lancering. Toolnamen en velden op deze pagina zijn illustratief tot de API-documentatie verschijnt.

De products.ai API geeft je product de antwoorden die Pius Bot in de chat geeft, als data: welk product bij een vraag past, waarom het past, waarom niet de andere en bij welke winkel je het koopt. De API is bedoeld voor bedrijven en ontwikkelaars, en toegang is op aanvraag.

Voor wie is de API?

Voor bedrijven en ontwikkelaars die producten en aanbiedingen in hun eigen app willen, bijvoorbeeld een shopassistent voor een paar landen of een planner die uitrusting voorstelt. Het abonnement In je product werkt via de API of MCP.

Twee andere routes zijn eenvoudiger als ze beter bij je passen. Wil je alleen antwoorden voor jezelf, dan vraagt products.ai chat de minste installatie. Wil je products.ai in de AI-assistent die je al gebruikt, dan is MCP de kortere weg.

Hoe krijg je toegang?

Je vraagt het aan, en ons team in Amsterdam leest elke aanvraag.

Open het toegangsformulier en kies De API gebruiken.
Vul je zakelijke e-mailadres in, je bedrijf of project, en wat je bouwt en waar.
Klik op Toegang aanvragen. Je e-mailapp opent met een ingevuld bericht aan [email protected], en er wordt niets verstuurd tot je zelf op verzenden drukt.

Je kunt ook direct mailen naar [email protected]. Bij toegang hoort een eigen overeenkomst, los van de algemene voorwaarden voor consumenten, en die overeenkomst bepaalt de voorwaarden voor jouw gebruik.

Welke tools heeft de API?

Vier, in het huidige illustratieve ontwerp:

Tool	Wat je terugkrijgt
`search_products`	Producten bij een vraag in gewone taal
`get_product`	Eén barcode: specificaties, varianten en alternatieven
`compare_products`	Producten naast elkaar, op barcode
`get_offers`	Vermelde aanbiedingen met prijs, voorraad en de datum waarop elke aanbieding werd vermeld

Hoe ziet een antwoord van search_products eruit?

Eerst een keuze met de redenen, dan waar je hem koopt. Dit illustratieve antwoord hoort bij de vraag "ruisonderdrukkende koptelefoon onder €300 voor op reis":

{
  "best_fit": "Sony WH-1000XM5",
  "why_it_fits": [
    "Sterkste ANC voor vluchten",
    "€73,01 onder je budget"
  ],
  "why_not": [
    "Momentum 4: minder stil",
    "QC Ultra: boven budget"
  ],
  "best_pick": {
    "shop": "bol.com",
    "price": 226.99,
    "why": "Op voorraad, gratis bezorgd in 1–2 dagen"
  },
  "second_chance": [{
    "condition": "Refurbished, klasse A",
    "price": 179.00,
    "why_not": "Vroeg om nieuw"
  }]
}

Veld	Wat het betekent
`best_fit`	Het product dat het best bij de vraag past
`why_it_fits`	Korte redenen, gekoppeld aan wat er gevraagd werd
`why_not`	Eén regel voor elk alternatief dat niet gekozen werd
`best_pick`	De winkel om bij te kopen: `shop`, `price` en `why` (voorraad en levering)
`second_chance`	Aanbiedingen buiten de vraag die toch kunnen passen, elk met een eigen `why_not`

Toon de redenen in je app, naast de keuze en de winkel. Zo vertel je je gebruikers waarom dit product en waarom deze winkel, en juist die eerlijkheid maakt de volgende keuze geloofwaardig.

Hoe worden producten en aanbiedingen aan elkaar gekoppeld?

Elk product wordt gekoppeld via zijn barcode, de GTIN (EAN in Europa, UPC in Noord-Amerika). De Sony WH-1000XM5 heeft bijvoorbeeld GTIN 4548736132580. Zo blijven modellen die één cijfer verschillen, zoals de WH-1000XM4 en de WH-1000XM5, aparte records.

Bij elke aanbieding staan de winkel en de datum waarop de winkel hem vermeldde. Prijzen komen alleen uit aanbiedingen die winkels vermelden, en Pius Bot schrijft nooit zelf een prijs. Een oude vermelding houdt haar datum, zodat je gebruikers zien hoe vers een prijs is. Winkels in het land van je gebruiker komen eerst. Waar kopen legt uit hoe Pius de winkel kiest.

Wat is nog illustratief?

De toolnamen, de veldnamen en de vorm van het antwoord op deze pagina zijn illustratief tot de API-documentatie verschijnt. Gebruik ze om je integratie te plannen, niet om code te schrijven die live gaat, want namen kunnen nog veranderen.

Wat je wel bij je toegang krijgt: de echte documentatie, hoe je verbinding maakt en wat je overeenkomst dekt. Sommige aanbiedingen bevatten affiliatelinks, gemarkeerd in de data; Affiliatelinks en verdienen legt uit hoe dat werkt en wat je app moet vermelden.