Public API v1.0

Piqqr API Documentatie

Doorzoek 190.000+ Nederlandse auto-advertenties via onze publieke API. Gratis, geen authenticatie vereist.

Overzicht

De Piqqr Public API geeft toegang tot ons auto-aanbod voor externe toepassingen, AI-assistenten en ontwikkelaars. De API is gratis en vereist geen API-sleutel.

Rate limit: 60 verzoeken per minuut per IP-adres. Responses worden 5 minuten gecachet.

Endpoints

GET /api/public/search

Zoek in het auto-aanbod met optionele filters. Retourneert max. 50 resultaten per verzoek.

Parameters

ParameterTypeOmschrijving
makestringAutomerk (bijv. "volkswagen", "toyota")
modelstringModel (bijv. "golf", "yaris")
typestringType: private_lease, zakelijk_lease, occasion, koop
maxPricenumberMaximale prijs in EUR (maandbedrag voor lease, aankoopprijs voor koop)
fuelstringBrandstof: electric, petrol, diesel, hybrid, plugin_hybrid
limitintegerAantal resultaten (standaard: 20, max: 50)

Voorbeeld verzoek

GET https://piqqr.nl/api/public/search?make=volkswagen&type=private_lease&maxPrice=400&fuel=electric&limit=5

Voorbeeld response

{
  "results": [
    {
      "id": "abc123",
      "make": "Volkswagen",
      "model": "ID.3",
      "variant": "Pure Performance",
      "year": 2023,
      "mileage_km": 0,
      "fuel_type": "electric",
      "listing_type": "private_lease",
      "price_eur": 389,
      "photo_url": "https://...",
      "source_url": "https://justlease.nl/...",
      "piqqr_url": "https://piqqr.nl/aanbod/abc123"
    }
  ],
  "total": 47,
  "filters_applied": {
    "make": "volkswagen",
    "type": "private_lease",
    "maxPrice": 400,
    "fuel": "electric"
  }
}

OpenAPI Specificatie

De volledige OpenAPI 3.0 specificatie is beschikbaar via: /api/public/openapi.json

AI-plugin manifest: /.well-known/ai-plugin.json

Gebruik

De API mag vrij worden gebruikt voor:

Voor commercieel gebruik of hogere limieten: info@piqqr.nl