Motor occasions API

Wilt u occasions op uw site weergeven en kunnen doorzoeken? Alleen van een specifiek merk, type of bouwjaar? MotorWereld.nl geeft u die mogelijkheid. U kunt nu één van de grootste occasiondatabases van Nederland integreren op uw site, via de MotorWereld.nl API. Hieronder een voorbeeld en meer informatie over de werking.
NB. Aanvragen voor gebruik van de API worden individueel beoordeeld, u kunt via de button een verzoek indienen en ontvangt dan zo spoedig mogelijk een reactie.

Hoe werkt het?

Via de MotorWereld.nl API kunt u het totale occasionaanbod van MotorWereld.nl doorzoeken en de resultaten tonen op uw eigen website. U kunt zelf bepalen waar u naar zoekt en hoe u de resultaten weergeeft op uw website.

De MotorWereld.nl API werkt via HTTP-requests. U stuurt een HTTP-request naar onze server waarbij u de gewenste GET-variabelen meestuurt (zie de voorbeelden onderaan de pagina). De resultaten van uw aanvraag worden vervolgens weergeven in XML of JSON.

Om requests te kunnen versturen dient u in het bezit te zijn van een MotorWereld.nl API-sleutel. Deze kunt u gratis aanvragen. Motorbedrijven die gebruik maken van MotorWereld.nl hebben automatisch een API-sleutel. Deze is terug te vinden in de beheerpagina voor bedrijven.

Een request begint altijd met http://www.motorwereld.nl/api/v1/?apisleutel=...&module=....
De parameters apisleutel en module dienen verplicht meegestuurd te worden bij iedere request:

• Aan de parameter apisleutel geeft u uw eigen unieke API-sleutel mee.
• Aan de parameter module geeft u mee uit welke module u de informatie wilt halen.

Standaard worden de resultaten weergegeven in XML. U kunt ook kiezen voor een uitvoer in JSON, welke met name geschikt is voor aanvragen via JavaScript.
Hiervoor dient u het volgende mee te geven aan de HTTP request: &uitvoer=json

Onderaan deze pagina vindt u diverse voorbeelden hoe u informatie via de API kunt opvragen.

Modulen

Hieronder staan de modulen van de MotorWereld.nl API beschreven. Elke module bevat een bepaald soort informatie. U kunt deze informatie verder filteren door één of meer parameters mee te geven, welke staan beschreven in de onderstaande tabel.

Bij sommige parameters kunt u zowel een naam als een id als waarde opgeven. Bijvoorbeeld aan de parameter mrk kunt u de waarde Audi of 10 meegeven. De namen en id's van merken en modellen zijn op te vragen via de module merkmodel.

Module 'occasions'

De occasionsmodule bevat alle motor-occasions die op MotorWereld.nl te vinden zijn.

Parameter	Waarde	Beschrijving
mrk	naam of id	Merk
mdl	naam of id	Model 1
trfw	tekst	Trefwoord 1
prvan	numeriek	Prijs vanaf
prtot	numeriek	Prijs t/m
kmvan	numeriek	Kilometerstand vanaf
kmtot	numeriek	Kilometerstand t/m
bjvan	numeriek	Bouwjaar vanaf
bjtot	numeriek	Bouwjaar t/m
vrmvan	numeriek	Vermogen vanaf
vrmtot	numeriek	Vermogen t/m
klr	numeriek	Kleur 2
opt	numeriek	Optie / accesoire 2
dr	numeriek	Deuren
brstf	naam of id	Brandstof
trns	naam of id	Transmissie
id	id	Occasion specifiek
crs	naam of id	Categorie motor
plaats	tekst	Plaats
lm	numeriek	Resultaten per pagina, maximum 100.
p	numeriek	Paginanummer van de resultaten.
srtr	id	Sorteren op 3, standaard gesorteerd op meest recent toegevoegd.

¹) Een merk is voor deze filter verplicht.
²) Hieraan kunnen meerdere waarden meegestuurd worden, scheidt deze met de waarde |. Een merk is verplicht.
³) De volgende waarden kunnen uitgebreid worden met -a ( oplopend ) of -d ( aflopend ) te sorteren:

• pr sorteren op prijs
• bj sorteren op bouwjaar
• km sorteren op kilometerstand
• nm sorteren op merk, model en uitvoering

Filters

Als u de parameter &toon=filters meegeeft worden er eveneens filters meegestuurd met de resultaten. Met deze filters kunt u de gevonden resultaten verder filteren. De uitvoer is opgebouwd in keuze- en al actieve filters. Elke filter is opgebouwd uit een naam, parameter en een of meer opties. Bij een keuzefilter wordt tevens het aantal resultaten vermeld.

...
<filter>
	<naam>Opties</naam>
	<parameter>opt</parameter>
	<optie>
		<naam><![CDATA[Airbags]]></naam>
		<waarde>4</waarde>
		<keuzewaarde>12|19|4</keuzewaarde>
		<aantal>2</aantal>
	</optie>
	<optie>
		<naam><![CDATA[Stuurbekrachtiging]]></naam>
		...
	</optie>
</filter>
...

In het voorbeeld moet u voor de filter Opties de parameter opt en als waarde de tekst in <keuzewaarde>...</keuzewaarde> in de url gebruiken.
Hiermee blijven de actieve waarden 12 ( Climate Control ) en 19 ( Cruise Control ) voor de Opties filter behouden. De tekst in <waarde>...</waarde> geeft de waarde van de optie als zelfstandig weer.
Voorbeeld voor het selecteren van de optie Airbags waarbij al als actief gefilterd wordt op een Audi A6, bouwjaar 2004 met Climate Control en Cruise Control:
http://www.motorwereld.nl/api/v1/?apisleutel=...&module=occasions&mrk=Audi&mdl=A6&bjvan=2004&bjtot=2004&opt=12|19|4&toon=filters

Module 'merkmodel'

De merkmodelmodule bevat alle merken en modellen die op MotorWereld.nl te vinden zijn.

Parameter	Waarde	Beschrijving
mrk	naam of id	Merk
mdl	naam of id	Model 1

¹) Een merk is voor deze filter verplicht.

Voorbeeld aanvragen

Alle Suzuki modellen
http://www.motorwereld.nl/api/v1/?apisleutel=...&module=merkmodel&mrk=Suzuki

Alle Ducati Sport occasions tussen de € 2.000 en € 8.500
http://www.motorwereld.nl/api/v1/?apisleutel=...&module=occasions&mrk=Ducatie&mdl=Sport&prvan=2000&prtot=8500