Rabatten API – reapriser och specialerbjudanden

Rabatten.se visar specialerbjudanden från en mängd fysiska butiker (e-handlar gör sig inte besvär), målet är att du ska kunna hitta alla reapriser på ett ställe i stället för att hoppa runt till alla butikers egna webbsajter. Användarna kan söka efter rabatter i lokala butiker eller köpcentrum, än så länge så har rabatten.se endast butiker i Stockholm men de planerar att expandera till hela Sverige. Nu kan man komma åt all denna information via deras API.

Filtrera på butik, köpcentrum eller geografi
Det finns två format man kan få data i, antingen via ett RSS2.0 feed som innehåller något begränsad information om varje erbjudande eller via rabatten.ses eget format RabattenAdRSS som innehåller fullständig information om erbjudanden. Oavsett vilket format som man vill ha informationen i så krävs endast ett HTTP-anrop, inga API-nycklar eller annan identifikation behövs. Varje anrop kräver parametern “mode” som anger hur man identifierar vilka butiker man vill ha information om, “mode” har följande möjliga värden:

• store eller snabbkod_store – endast erbjudanden från en angiven butik som sedan idenfieras med parametrarna storeid eller snabbkod
• mall – endast erbjudanden från butiker i ett givet köpcentrum som identifieras med parametern mallid
• county – endast annonser från butiker i ett visst län som identifieras med parametern countyid
• locality – endast annonser från butiker i en given postort som anges med parametern localityid
• geoip_county – endast annonser från butiker i det län som IP-adressen som anges med parametern ip är registrerad i
• geoip_location – endast annonser från butiker i en postort som IP-adressen i parametern ip är registrerad i

Via http://www.rabatten.se/rss.aspx?format=mall så får man tag på  alla köpcentrum som rabatten.se har registrerade. Än så finns inget enkelt sätt att få tag på storeid, men det jobbar Rabatten.se på för fullt så det kommer nog inom några dagar.

Exempel API-anrop
För att ta reda på vilka rabatter som Kjell & Co i Gallerian, Stockholm så gör man anropet:
http://www.rabatten.se/rss.aspx?format=rss&mode=store&storeId=1001

För att få reda på alla specialerbjudanden i Stockholm så gör anropet:
http://www.rabatten.se/rss.aspx?format=rabattenadrss&mode=county&countyid=12

I det sista anropet så kommer informationen tillbaka i RabattenAdRSS formatet, dvs XML med så mycket data som möjligt:

...
<ad>
	<adid>374</adid>
	<category>Hälsa & skönhet - Smink & parfym</category>
	<title>BIOTHERM</title>
	<description>club15 BIOTHERM ...</description>
	<ordinaryprice>320.00</ordinaryprice>
	<ordinarypriceunit>st</ordinarypriceunit>
	<rebateprice>0.00</rebateprice>
	<rebatepriceunit>st</rebatepriceunit>
	<compareprice></compareprice>
	<comparepriceunit></comparepriceunit>
	<rentalprice></rentalprice>
	<rentalmonths></rentalmonths>
	<priceisinpicture>False</priceisinpicture>
	<link>http://www.rabatten.se/default.aspx?adid=374&channelid=2</link>
	<image1>http://data.rabatten.se/ads/....jpg</image1>
	<image2>http://data.rabatten.se/ads/....jpg</image2>
	<image3>http://data.rabatten.se/ads/....jpg</image3>
	<store>
		<storeid>1821</storeid>
		<storename>Kicks</storename>
		<storelogo>http://data.rabatten.se/logo....png</storelogo>
		<storestreetaddress>Aniaraplatsen 2</storestreetaddress>
		<storepostaladdress>19147 SOLLENTUNA</storepostaladdress>
		<storecounty>Stockholm</storecounty>
		<storelocationx>59.4272291</storelocationx>
		<storelocationy>17.9525737</storelocationy>
	</store>
	...
</ad>
...

För mer information så ta en titt på Rabatten.ses egen API dokumentation och kodexempel.

Ett API med stor potential
Jag tycker att rabatten.se har ett mycket intressant API där man kan komma åt värdefull data på ett enkelt sätt. Speciellt gillar jag att man kan få fram lokala annonser genom att endast ange IP-adresser i API-anropet. Värdet på APIet är än så länge begränsat om man inte bygger tjänster för de som bara shoppar i Stockholms innerstad, men när Rabatten.se täcker hela Sverige så har detta API potentialen att bli ett av landets mest intressanta.