Zoeken op de website
De standaardmodus: typ wat je zoekt in gewone woorden en krijg advertenties en veilingkavels terug.
- Typ in de zoekbalk, bijvoorbeeld:
gezellige fauteuil voor onder de €100
- Verfijn met Filters: bron (Tweedehands of Veiling), minimum- en maximumprijs, en postcode met straal voor dingen in de buurt.
- Tip: klik op het foto-icoontje om met een afbeelding te zoeken in plaats van woorden.
- Wissel tussen Resultaten (lijst) en Kaarten, en blader met Vorige en Volgende.
- Zie je iets interessants? Klik erop — de advertentie opent in een nieuw tabblad. Met vergelijkbaar bij een resultaat vind je meer van hetzelfde. Klik op het bladwijzer-icoontje om een koopje te bewaren (account nodig) — alles terug te vinden onder Bewaard bovenaan de resultaten.
GET /v1/search
Semantisch + keyword zoeken over de hele index. Auth: Authorization: Bearer kk_…. Limiet: 60/minuut, 2.000/dag.
| Parameter | Uitleg |
|---|---|
q * | Zoekopdracht (Nederlands werkt het best) |
source | tweedehands of veiling |
listing_type | tweedehands of veiling — zelfde binaire filter |
type | auto, neural of keyword |
price_min / price_max | Euro's |
no_price | 0 verbergt advertenties zonder prijs |
limit | 1–24, standaard 12 |
curl -s "https://koopje.ai/v1/search?q=vintage+stoel&price_max=200&limit=5" \ -H "Authorization: Bearer $KOOPJE_API_KEY"
Verdieping nodig? GET /v1/similar?url=… vindt gelijkende advertenties, GET /v1/contents?urls=… (max 20) haalt volledige details op. Volledige referentie: API-referentie.
Antwoord op de website
Kies bovenaan de zoekbalk de modus Antwoord en stel je vraag in gewone taal. Je krijgt geen lijst, maar een onderbouwd advies — met bronvermelding.
- Het antwoord verwijst met cijfertjes zoals [1] [2] naar echte advertenties.
- Klik op een cijfertje om de advertentie erachter meteen te openen.
GET /v1/answer
Nederlandstalig antwoord met citaten naar echte listings (RAG over de index). Limiet: 20/minuut, 200/dag.
| Parameter | Uitleg |
|---|---|
q * | De vraag in gewone woorden |
source | tweedehands of veiling |
curl -s "https://koopje.ai/v1/answer?q=beste+e-bike+onder+800+euro" \ -H "Authorization: Bearer $KOOPJE_API_KEY"
Agent op de website
Kies de modus Agent (slotje: hiervoor heb je een gratis account nodig). De agent zoekt niet één keer, maar werkt je vraag stap voor stap af — en je ziet live wat hij doet.
- Stel je vraag en kijk mee terwijl de agent meerdere zoekslagen uitvoert.
- Vraag gerust door in hetzelfde gesprek — hij onthoudt waar jullie het over hadden.
- Klaar voor iets nieuws? Klik op Gesprek wissen en begin opnieuw.
Combineer de bouwstenen zelf
POST /v1/agent (streaming)
De website-agent als API: hij voert zelf meerdere zoekslagen uit en stuurt het antwoord als Server-Sent Events stream. Stuur JSON met message (verplicht), plus conversation (lijst met eerdere berichten voor vervolgvragen) en source (tweedehands of veiling). Limiet: 10/minuut, 100/dag.
curl -N -X POST "https://koopje.ai/v1/agent" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $KOOPJE_API_KEY" \
-d '{"message": "zoek een racefiets voor een beginner, max 500 euro"}'
Liever zelf de keten bouwen? Combineer /v1/search → /v1/contents → /v1/answer — precies wat onze skill doet (Eigen AI koppelen).
Verder op de site: onder Bronnen zie je welke tweedehands sites en veilinghuizen worden doorzocht. Na aanmelden vind je onder API keys rechtsboven je keys. Iets geks gezien? Gebruik de feedbackbalk onderaan de pagina — die lezen we echt.