REST API

Bouw met de KoopSlimmer API

Integreer AI-productanalyses in je eigen applicatie. Twee endpoints, volledige review intelligence, binnen minuten operationeel.

Quickstart API Reference

Quickstart

In 3 stappen van URL naar volledige productanalyse

URL kiezen

Zoek een product-URL op elke webshop. Bol.com, Amazon, Coolblue — alles werkt.

Analyse starten

Stuur een POST met de product-URL. Je krijgt een analyse-ID terug.

Resultaat ophalen

Poll het report endpoint tot status "done" is. Gemiddeld < 60 seconden.

curl

# Start een analyse
curl -X POST https://koopslimmer.nl/api/v1/analyze \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.bol.com/nl/p/samsung-galaxy-s25/123456789"}'

# Haal het resultaat op
curl https://koopslimmer.nl/api/v1/report/abc-123

python

import requests
import time

BASE = "https://koopslimmer.nl/api/v1"

# Start analyse
resp = requests.post(f"{BASE}/analyze", json={
    "url": "https://www.bol.com/nl/p/samsung-galaxy-s25/123456789"
})
analysis_id = resp.json()["id"]

# Poll tot klaar
while True:
    result = requests.get(f"{BASE}/report/{analysis_id}").json()
    if result["status"] in ("done", "failed"):
        break
    time.sleep(2)

print(result["report"]["verdict"])  # "Goede koop"

javascript

const BASE = "https://koopslimmer.nl/api/v1";

// Start analyse
const { id } = await fetch(`${BASE}/analyze`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    url: "https://www.bol.com/nl/p/samsung-galaxy-s25/123456789",
  }),
}).then(r => r.json());

// Poll tot klaar
let result;
do {
  await new Promise(r => setTimeout(r, 2000));
  result = await fetch(`${BASE}/report/${id}`)
    .then(r => r.json());
} while (result.status !== "done" && result.status !== "failed");

console.log(result.report.verdict); // "Goede koop"

API Reference

Twee endpoints, dat is alles wat je nodig hebt

POST/api/v1/analyze

Start een nieuwe productanalyse. Retourneert een analyse-ID waarmee je het resultaat kunt ophalen.

Parameters

Naam	Type	Vereist	Beschrijving
url	string	ja	Volledige product-URL (elke webshop)
fingerprint	string	nee	Client fingerprint voor rate limiting

Response voorbeeld

{
  "id": "abc-123",
  "status": "pending",
  "platform": "bol"
}

GET/api/v1/report/{id}

Haal het resultaat op van een analyse. Poll dit endpoint tot status "done" of "failed" is.

Parameters

Naam	Type	Vereist	Beschrijving
id	string	ja	Analyse-ID uit het /analyze response

Response voorbeeld

{
  "id": "abc-123",
  "status": "done",
  "product_name": "Samsung Galaxy S25",
  "review_count": 847,
  "average_rating": 4.3,
  "report": {
    "verdict": "Goede koop",
    "score": 8.2,
    "pros": ["..."],
    "cons": ["..."],
    "fake_score": 12,
    "summary": "..."
  }
}

Authenticatie

De API is gratis en open — geen API key nodig

Content-Type: application/json

Stuur gewoon een POST request met de product-URL. Geen API key, geen registratie.

HTTP Status Codes

200	Succes
400	Ongeldige request (bijv. geen geldige URL)
403	Toegang geweigerd
404	Analyse niet gevonden
429	Rate limit bereikt
500	Server error

Rate Limits

Gratis en onbeperkt — geen API key nodig

Plan	Limiet	Burst	Auth
Gratis	Onbeperkt	60/uur	Geen

Start met bouwen

Twee endpoints. Volledige review intelligence. Van URL naar koopadvies in < 60 seconden.

Probeer de API Documentatie