v1.0

Piqqr voor AI & Developers

Integreer 300.000+ Nederlandse autolistings in je AI-assistent, chatbot of applicatie. Via onze MCP server of REST API.

MCP Server

Gebruik onze Model Context Protocol server met Claude Desktop, Claude Code, of elke MCP-compatible client.

Setup guide

REST API

Zoek, filter en haal autodata op via onze REST API. Momenteel in beta — vraag een API key aan voor toegang.

API docs

MCP Server

De Piqqr MCP server biedt 3 tools waarmee AI-assistenten auto's kunnen zoeken, vergelijken en persoonlijk mobiliteitsadvies kunnen geven.

Quick Start — Claude Desktop

Voeg het volgende toe aan je Claude Desktop configuratie (claude_desktop_config.json):

claude_desktop_config.json
{
  "mcpServers": {
    "piqqr": {
      "command": "npx",
      "args": ["-y", "piqqr-mcp-server"],
      "env": {}
    }
  }
}

Of via SSE (remote)

SSE endpoint
GET https://piqqr.nl/mcp/sse

// De SSE transport kan gebruikt worden door elke
// MCP-compatible client die SSE ondersteunt.
// Rate limit: 60 requests per minuut.

Beschikbare Tools

search_cars

Zoek en vergelijk auto's in Nederland — koop, occasion, private lease en zakelijke lease. Doorzoekt 300.000+ listings.

Parameters

makestringAutomerk, bijv. "Volkswagen"
modelstringModel, bijv. "Golf"
typeenum"occasion" | "new" | "private_lease" | "business_lease"
max_pricenumberMax prijs (koop) of maandbedrag (lease)
fuel_typeenum"petrol" | "diesel" | "electric" | "hybrid"
min_yearnumberBouwjaar vanaf
max_mileagenumberMax kilometerstand
citystringStad of regio
limitnumberAantal resultaten (1-20, default 10)

Voorbeeld

// "Zoek een elektrische auto op lease onder €400/mnd"
{
  "name": "search_cars",
  "arguments": {
    "fuel_type": "electric",
    "type": "private_lease",
    "max_price": 400,
    "limit": 5
  }
}

autoscan_advice

Persoonlijk advies of lease of kopen beter past. Gebaseerd op de Piqqr Autoscan.

Parameters

situationenumrequired"particulier" | "zzp" | "zakelijk"
monthly_budgetnumberrequiredMaandbudget in euro (200-2000)
annual_kmenumrequired"10000" | "15000" | "20000" | "25000"
car_typeenumrequired"stadsauto" | "gezinsauto" | "suv" | "sportief" | "geen_voorkeur"
fuel_preferenceenumrequired"benzine" | "diesel" | "elektrisch" | "hybride" | "geen_voorkeur"
durationenumrequired"1-2_jaar" | "3-4_jaar" | "5+_jaar" | "weet_niet"

Voorbeeld

// "Ik ben ZZP'er, budget €500/mnd, rij 20k km/jaar,
//  zoek een SUV, hybride, voor 3-4 jaar"
{
  "name": "autoscan_advice",
  "arguments": {
    "situation": "zzp",
    "monthly_budget": 500,
    "annual_km": "20000",
    "car_type": "suv",
    "fuel_preference": "hybride",
    "duration": "3-4_jaar"
  }
}

get_car_details

Haal volledige details op van een auto, inclusief RDW-data en lease-voorwaarden.

Parameters

listing_idstringrequiredHet Piqqr listing ID (UUID)

Voorbeeld

// Haal details op van een specifieke listing
{
  "name": "get_car_details",
  "arguments": {
    "listing_id": "a1b2c3d4-e5f6-..."
  }
}

// Retourneert: merk, model, variant, prijs, specs,
// foto's, dealer info, RDW data, lease voorwaarden

REST API

Doorzoek 300.000+ Nederlandse autolistings via onze REST API.

De Piqqr API is momenteel in beta

Vraag een API key aan om toegang te krijgen. Dit voorkomt misbruik en geeft ons inzicht in hoe de API gebruikt wordt. We sturen je de key zo snel mogelijk toe.

Endpoint

GET
GET https://piqqr.nl/api/public/search

Parameters (query string):
  make      - Automerk (bijv. "volkswagen")
  model     - Model (bijv. "golf")
  type      - "private_lease" | "zakelijk_lease" | "occasion" | "koop"
  maxPrice  - Maximum prijs in euro
  fuel      - "petrol" | "diesel" | "electric" | "hybrid"
  limit     - Max resultaten (default 20, max 50)

Rate limit: 60 requests per minuut per IP
Cache: 5 minuten

Voorbeeld

curl
curl "https://piqqr.nl/api/public/search?make=tesla&type=private_lease&maxPrice=500"

# Response:
{
  "results": [
    {
      "id": "abc-123",
      "make": "Tesla",
      "model": "Model 3",
      "price_eur": 449,
      "year": 2024,
      "fuel_type": "electric",
      "listing_type": "private_lease",
      "piqqr_url": "https://piqqr.nl/aanbod/abc-123"
    }
  ],
  "total": 42,
  "filters_applied": {
    "make": "tesla",
    "type": "private_lease",
    "maxPrice": 500
  }
}
Interactieve API DocsOpenAPI Spec

Autoscan API

Vraag persoonlijk lease-vs-koop advies op — dezelfde logica als de Piqqr Autoscan wizard, maar via één API-call. Handig voor AI-assistenten die een gebruiker willen helpen met de beste mobiliteitsoptie.

Endpoint

POST
POST https://piqqr.nl/api/public/autoscan
Content-Type: application/json

Body (JSON):
  monthly_budget   number   VERPLICHT — maandbudget in EUR
  situation        string   "particulier" | "zzp" | "zakelijk"  (default: "particulier")
  annual_km        string   "10000" | "15000" | "20000" | "25000"  (default: "15000")
  car_type         string   "stadsauto" | "gezinsauto" | "suv" | "sportief" | "geen_voorkeur"
  fuel_preference  string   "benzine" | "diesel" | "elektrisch" | "hybride" | "geen_voorkeur"
  duration         string   "1-2_jaar" | "3-4_jaar" | "5+_jaar" | "weet_niet"  (default: "weet_niet")
  capital          number   startkapitaal in EUR  (default: 0)

Rate limit: 30 requests per minuut per IP

Voorbeeld request

curl
curl -X POST https://piqqr.nl/api/public/autoscan \
  -H "Content-Type: application/json" \
  -d '{
    "situation": "particulier",
    "monthly_budget": 400,
    "annual_km": "15000",
    "car_type": "gezinsauto",
    "fuel_preference": "benzine",
    "duration": "3-4_jaar",
    "capital": 5000
  }'

Voorbeeld response

response.json
{
  "advice": "lease",
  "confidence": "moderate",
  "explanation": "Op basis van je situatie als particulier en je voorkeur voor een middellange termijn, adviseren wij private lease...",
  "factors": [
    { "label": "Particulier", "impact": "koop", "explanation": "geen fiscaal voordeel bij lease" },
    { "label": "Middellange termijn", "impact": "lease", "explanation": "past goed bij standaard leasecontracten" },
    { "label": "Gezinsauto", "impact": "lease", "explanation": "nieuw model via lease" }
  ],
  "lease_matches": [
    {
      "id": "abc-123",
      "make": "Toyota",
      "model": "Corolla",
      "price_eur": 389,
      "year": 2024,
      "fuel_type": "petrol",
      "listing_type": "private_lease",
      "piqqr_url": "https://piqqr.nl/aanbod/abc-123"
    }
  ],
  "buy_matches": [
    {
      "id": "def-456",
      "make": "Volkswagen",
      "model": "Golf",
      "price_eur": 22500,
      "year": 2021,
      "mileage_km": 45000,
      "fuel_type": "petrol",
      "piqqr_url": "https://piqqr.nl/aanbod/def-456"
    }
  ],
  "monthly_cost_comparison": {
    "lease_average": 389,
    "buy_estimated": 425,
    "explanation": "Lease is ~€36/mnd goedkoper voor vergelijkbare auto's"
  }
}

💡 Gebruik via MCP

De MCP tool autoscan_advice roept dit endpoint intern aan. Als je de MCP server gebruikt, heb je geen directe API-call nodig — de tool handelt alles af.

AI Plugin Manifest

Voor AI-systemen die het OpenAI plugin-formaat ondersteunen, bieden we een manifest aan:

/.well-known/ai-plugin.json
{
  "schema_version": "v1",
  "name_for_human": "Piqqr Auto Zoeken",
  "name_for_model": "piqqr_auto_search",
  "description_for_model": "Search Dutch car listings including buy,
    occasion, private lease and business lease. Filter by make,
    model, price, fuel type. Returns structured car data.",
  "api": {
    "type": "openapi",
    "url": "https://piqqr.nl/api/public/openapi.json"
  },
  "auth": { "type": "none" }
}

Klaar om te bouwen?

Begin direct met onze MCP server of REST API. Heb je vragen? Neem contact met ons op.

Probeer de AutoscanContact opnemen