Inloggen | Account maken



Wachtwoord vergeten?
Gratis account aanmaken

| Adverteren
MusicFromNL, Dé muzieksite van Nederland
 
 

Concertagenda API

MusicFromNL heeft een van de grootste concertdatabases van Nederland. Deze database wordt gevuld door de belangrijkste Nederlandse podia, theaters, festivals en artiesten en beheerd door een professioneel team van contentmanagers die de kwaliteit waarborgen.

Gratis onze concertgegevens gebruiken

De kracht van internet is het delen van informatie en wij vinden het dan ook zonde van de energie dat enerzijds mensen op diverse websites concertgegevens apart invoeren en anderzijds honderden websites deze gegevens verzamelen. Dat kan een stuk makkelijker en daarom bieden wij iedereen de gratis mogelijkheid om de concerten uit de MusicFromNL-concertagenda op te nemen in hun eigen websites en applicaties. Hierbij kan er gebruik gemaakt worden van een keur aan selectie-opties zoals artiesten, regio, genre, podium, zoekwoord en combinaties hiervan.

We bieden drie gratis manieren om onze concertgegevens te gebruiken en te publiceren. Via javascript, via RSS en via onze nieuwe Concertagenda API.

Onze API kan drie soorten output leveren:

  1. Beperkte javascript-versie
    Output: Javascript
    Variabelen: datum, titel, plaats, lokatie en URL
    URL: http://www.musicfrom.nl/api/concerts.php?type=js

  2. Beperkte XML-versie
    Output: XML
    Variabelen: datum, titel, plaats, lokatie en URL
    URL: http://www.musicfrom.nl/api/concerts.php?type=xml

  3. Uitgebreide XML-versie
    Output: XML
    Variabelen: zeer complete concert-, artiest,- en lokatiegegevens
    URL: http://www.musicfrom.nl/api/concerts.php?key=API_KEY *
*: In de URL van de uitgebreide XML-versie moet 'API_KEY' vervangen worden door je eigen API Key, bijvoorbeeld
http://www.musicfrom.nl/api/concerts.php?key=1f3d0b22037e3ae67e903f838c434cb4


Share Mail Print

API Key

Voor de uitgebreide XML-versie is een sleutel, de zogenaamde 'API Key', vereist. Door middel van deze key krijgt u toegang tot alle beschikbare gegevens van een concert.

Het gebruik van onze API Key is gebonden aan de volgende voorwaarden:

  1. Gegevens uit de stream mogen niet aan derden doorverkocht of geleverd worden zonder onze schriftelijke toestemming
  2. Bij gebruik van gegevens uit onze streams moet als bron MusicFromNL vermeld worden met een link naar www.musicfrom.nl
  3. De u ter beschikking gestelde key is strikt persoonlijk en mag niet aan derden ter beschikking gesteld worden
Wilt u een API Key ontvangen voor de uitgebreide XML-versie dan kunt u telefonisch contact opnemen via 010 4761318, mail: klantenservice@musicfrom.nl of door onderstaand formulier in te vullen:

Aanhef:
Voornaam:
Achternaam:
Organisatie:
E-mailadres:
Telefoon:
: Beschrijf kort waar u de concertgegevens voor wilt gebruiken
 

Selectie-opties

LET OP: In de voorbeelden gebruiken we de uitgebreide API-url. Maak je gebruik van de beperkte versies, dan dien je de beperkte API-url te gebruiken zonder de variabele 'data' en 'key'.

De evenementen die opgehaald worden kunnen geselecteerd worden aan de hand van een aantal selectie-opties.
Alle selectie-opties worden meegegeven aan de URL wanneer de XML-stream aangeroepen wordt.
Dit gebeurt op de volgende manier:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&optie=waarde

De selectie opties zullen hieronder beschreven worden.

data

Omschrijving: Standaard worden enkel evenementen opgehaald die sinds gisteren bijgewerkt of toegevoegd zijn (sneller).
Door de variabele 'data' met als waarde 'full' mee te geven aan de URL worden alle evenementen opgehaald (langzamer). Voorbeeld Enkel evenementen ophalen die sinds gisteren zijn bijgewerkt of toegevoegd zijn (standaard):
http://www.musicfrom.nl/api/concerts.php?key=API_KEY

Alle evenementen ophalen:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&data=full

artistId

Omschrijving: De optie artistId kan gebruikt worden om evenementen van één of meerdere specifieke artiesten op te halen.
Het id-nummer is het nummer die de artiest heeft in de database van MusicFromNL.
Dit id-nummer is terug te vinden via de profielpagina van desbetreffende artiest.
Bijvoorbeeld: http://www.musicfrom.nl/artiesten/15129/caro-emerald.html. Het id-nummer van Caro Emerald is 15129.
Om evenementen van meerdere artiesten op te halen kunnen id-nummers komma-gescheiden meegegeven worden in de URL. Voorbeeld Alle evenementen met Caro Emerald:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&artistId=15129&data=full

Alle evenementen met Caro Emerald en Boris:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&artistId=15129,7172&data=full
Naar boven

eventType

Omschrijving: De optie eventType kan gebruikt worden om evenementen van een specifiek type te selecteren.
De optie eventType kan de volgende waardes hebben:
  • concert
  • festival
  • voorstelling
  • wedstrijd
  • dansavond
Voorbeeld Alleen festivals selecteren:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&eventType=festival&data=full

Alleen dansavonden selecteren:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&eventType=dansavond&data=full
Naar boven

genreId

Omschrijving De optie genreId kan gebruikt worden om evenementen in één of meerdere specifieke genres op te halen.
Voor een selectie van meerdere genres kunnen genreId's komma-gescheiden meegegeven worden aan de URL.
De genres hebben de volgende id-nummers (genrenaam: genreId):
  • Blues: 11
  • Cabaret: 16
  • Country / Roots / Americana: 12
  • Crossover: 22
  • Dance / Elektronisch: 9
  • Experimenteel / Alternatief: 15
  • Folk / Folklore: 23
  • Funk: 14
  • Gothic: 24
  • Hiphop / Rap: 4
  • Jazz: 10
  • Klassiek / Lichte muziek: 1
  • Metal / Hardrock: 6
  • Musical: 25
  • Pop: 7
  • Punk / Hardcore: 3
  • Reggae / Ska: 21
  • Rock: 8
  • Rock 'n Roll: 18
  • Singer / Songwriter: 17
  • Smartlappen: 26
  • Soul / R&B / Urban: 5
  • Symfonische / Progressieve rock: 27
  • Wereldmuziek: 2
Voorbeeld Alle evenementen in het genre 'Dance / Elektronisch':
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&genreId=9&data=full

Alle evenementen in het genre 'Dance / Elektronisch', 'Soul / R&B / Urban' of in het genre 'Experimenteel / Alternatief':
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&genreId=9,5,15&data=full
Naar boven

items

Omschrijving De optie items kan gebruikt worden om evenementen te selecteren vanaf een bepaald aantal en om het aantal resultaten te limiteren.
De variabele 'items' gebruikt de volgende notatie:
items=limiet
items=offset,limiet
Voorbeeld Enkel de eerste 10 evenementen worden opgehaald:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&items=10&data=full

De eerste 20 evenementen worden overgeslagen en er worden maximaal 50 evenementen geselecteerd:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&items=20,50&data=full
Naar boven

provinceId

Omschrijving provinceId kan gebruikt worden om evenementen uit één of meerdere specifieke provincies te selecteren.
Selecteer evenementen uit meerdere provincies door de provincie-id's komma-gescheiden mee te geven aan de URL.
De provincies hebben de volgende id-nummers (Provincie: provinceId):
  • Drenthe: 12
  • Flevoland: 11
  • Friesland: 8
  • Gelderland: 5
  • Groningen: 7
  • Limburg: 6
  • Noord-Brabant: 9
  • Noord-Holland: 1
  • Overijssel: 10
  • Utrecht: 4
  • Zeeland: 3
  • Zuid-Holland: 2
Voorbeeld Evenementen uit de provincie Zuid-Holland:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&provinceId=2&data=full

Evenementen uit de provincies Flevoland en Drenthe:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&provinceId=11,12&data=full
Naar boven

searchquery

Omschrijving Gebruik de URL-variabele searchquery om te zoeken in de naam van het podium, in de titel van het evenement en in de namen van de artiesten van een evenement. Voorbeeld Zoeken naar evenementen in De Melkweg:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&searchquery=melkweg&data=full

Zoeken naar evenementen waarvan de titel 'piraten festijn' bevat:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&searchquery=piraten festijn&data=full

Zoeken naar evenementen waar Anouk optreedt:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&searchquery=anouk&data=full
Naar boven

regionId

Omschrijving regionId wordt gebruikt om evenementen uit één of meerdere specifieke regio's te selecteren.
Meerdere regio's kunnen meegegeven worden door de regio-id's komma-gescheiden aan de URL mee te gegeven.
De regio's hebben de volgende id-nummers (Regio: regionId):
  • Alkmaar: 2
  • Almere: 39
  • Amersfoort: 21
  • Amsterdam: 4
  • Apeldoorn: 24
  • Arnhem: 23
  • Assen: 33
  • Belgie: 50
  • Breda: 13
  • Delfzijl: 37
  • Den Bosch: 15
  • Den Haag: 6
  • Den Helder: 1
  • Deventer: 25
  • Doetinchem: 26
  • Dordrecht: 8
  • Drachten: 44
  • Eindhoven: 16
  • Emmeloord: 41
  • Emmen: 32
  • Goes: 10
  • Gouda: 53
  • Groningen: 36
  • Haarlem: 3
  • Heerenveen: 35
  • Hilversum: 47
  • Hoogeveen: 31
  • Leeuwarden: 34
  • Leiden: 5
  • Lelystad: 40
  • Maastricht: 18
  • Meppel: 30
  • Middelburg: 9
  • Nijmegen: 22
  • Parkstad: 19
  • Roermond: 43
  • Roosendaal: 12
  • Rotterdam: 7
  • Sittard-Geleen: 48
  • Sneek: 45
  • Terneuzen: 11
  • Tiel: 46
  • Tilburg: 14
  • Twente: 51
  • Utrecht: 20
  • Veendam: 38
  • Venlo: 17
  • Vlissingen: 42
  • Zaanstad: 49
  • Zierikzee: 52
  • Zwolle: 29
Voorbeeld Alle evenementen uit de regio Rotterdam:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&regionId=7&data=full

Alle evenementen uit de regio's Goes en Vlissingen:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&provinceId=10,42&data=full
Naar boven

venueId

Omschrijving Variabele die gebruikt kan worden om evenementen in één of meerdere specifieke podia te selecteren. Het id-nummer is het nummer dat het podium heeft in de database van MusicFromNL, terug te vinden via de profielpagina van het podium. Bijvoorbeeld http://www.musicfrom.nl/muziekgids/podia/1410/paradiso.html Het id-nummer van Paradiso is 1410.

Voorbeeld Alle evenementen in Paradiso:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&venueId=1410&data=full

Alle evenementen in Paradiso en Tivoli:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&venueId=1410,1496&data=full
Naar boven

Voorbeelden

Alle evenementen die sinds gisteren zijn toegevoegd of zijn bijgewerkt:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY

Alle evenementen:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&data=full

20 evenementen waarbij de eerste 10 overgeslagen worden:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&data=full&items=10,20

Laatste 50 evenementen:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&data=full&items=50

Laatste 10 evenementen van Anouk:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&data=full&items=10&artistId=359

Evenementen in Noord-Holland waar Golden Earing optreedt:
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&data=full&regionId=1&artistId=807

Evenementen zoeken in Emmen van Gerard Joling (zonder artistId):
http://www.musicfrom.nl/api/concerts.php?key=API_KEY&data=full&regionId=32&searchquery=Gerard Joling
Naar boven

Output


Deze documentatie is alleen bedoeld voor de uitgebreide XML-versie van onze API.

concert

Omschrijving bevat alle informatie betreffende het evenement. Attributen id: het id-nummer van het concert. Waarde Alle waardes die hierna omschreven worden. Voorbeeld
<concert id="92551">
   [...]
</concert>
Naar boven

lastUpdate

Omschrijving Datum waarop het evenement voor het laatst is bijgewerkt. Attributen unixtime: Unix timestamp waarop het evenement voor het laatst is bijgewerkt. Waarde RFC 2822-compatibele datum waarop het evenement voor het laastst is bijgewerkt. Voorbeeld
<lastUpdate unixtime="1265370085">Fri, 05 Feb 2010 12:41:25 +0100</lastUpdate>
Naar boven

type

Omschrijving Het type van het evenement. Attributen Geen. Waarde Een van de volgende waardes:
  • concert;
  • festival;
  • voorstelling;
  • wedstrijd;
  • dansavond;
Voorbeeld
<type>concert</type>
Naar boven

date

Omschrijving Datum waarop het evenement plaatsvindt. Attributen unixtime: Unix timestamp waarop het evenement plaatsvindt. Waarde RFC 2822-compatibele datum waarop het evenement plaatsvindt. Voorbeeld
<date unixtime="1278194400">Sun, 04 Jul 2010 00:00:00 +0200</date>
Naar boven

title

Omschrijving De titel van het evenement. Attributen Geen. Waarde De titel van het evenement. Voorbeeld
<title>Anouk - Live at Westerpark</title>
Naar boven

description

Omschrijving De omschrijving van het evenement. Attributen Geen. Waarde De omschrijving van het evenement. Voorbeeld
<description> Vorig jaar speelde de rockdiva four days in a row de Ahoy plat. [...] Nee, Anouk is Nederland nog lang niet zat. En Nederland haar ook niet! </description>
Naar boven

genre

Omschrijving Informatie over het genre van het evenement. Attributen id: Het id-nummer van het genre. Waarde De naam van het genre. Voorbeeld
<genre id="8">Rock</genre>
Naar boven

additionalGenres

Omschrijving Secundaire genres van het evenement. Attributen Geen Waarde Voor elk secundair genre eenzelfde node als genre. Voorbeeld
<additionalGenres>
    <genre id="7">Pop</genre>
    <genre id="8">Rock</genre>
</additionalGenres>
Naar boven

flyerUrl

Omschrijving URL naar de afbeelding van de flyer (indien aanwezig). Attributen Geen Waarde URL naar de afbeelding. Voorbeeld
<flyerUrl>
    http://media.musicfrom.nl/file.php/-tmp-phpbOvfWf.jpg?id=61927,85wxg48
</flyerUrl>
Naar boven

doorsOpenTime

Omschrijving Tijd dat de deuren van het podium open gaan. Attributen Geen Waarde De tijd in het formaat hh:mm:ss. Voorbeeld
<doorsOpenTime>
    12:00:00
</doorsOpenTime>
Naar boven

startTime

Omschrijving Tijd waarop het evenement begint. Attributen Geen Waarde De tijd in het formaat hh:mm:ss. Voorbeeld
<startTime>
    21:30:00
</startTime>
Naar boven

endTime

Omschrijving Tijd waarop het evenement eindigt. Attributen Geen Waarde De tijd in het formaat hh:mm:ss. Voorbeeld
<endTime>
    23:30:00
</endTime>
Naar boven

detailUrl

Omschrijving URL naar de pagina waar meer informatie over het evenement te vinden is. Attributen Geen Waarde De URL. Voorbeeld
<detailUrl>
    http://www.podiumdekelder.nl/programma/details/desperados_bfdm_releaseparty/
</detailUrl>
Naar boven

venueName

Omschrijving De naam van het podium waar het evenement plaatsvindt. Attributen Geen Waarde De naam van het podium. Voorbeeld
<venueName>
    Rotown
</venueName>
Naar boven

city

Omschrijving De naam van de plaats waar het podium gevestigd is. Attributen Geen Waarde De plaatsnaam. Voorbeeld
<city>
    Rotterdam
</city>
Naar boven

entry

Omschrijving De entreeprijs van het evenement in euro's. Attributen Geen Waarde De entreeprijs van het evenement in euro's. Voorbeeld
<entry>€ 7,50</entry>
Naar boven

startPresale

Omschrijving Datum waarop de voorverkoop van tickets voor het evenement begint. Attributen unixTime: Unix timestamp waarop de voorverkoop van tickets voor het evenement begint. Waarde De datum in het formaat yyyy:mm:dd. Voorbeeld
<startPresale unixtime="1259362800">
    2009-11-28
</startPresale>
Naar boven

artists

Omschrijving Bevat alle beschikbare informatie over de artiesten die optreden op het evenement. Attributen Geen Waarde Per gevonden artiest een node met informatie. Voorbeeld
<artists>
    <artist id="7172">
        <name>Boris</name>
         <genre id="5">Soul / R&B / Urban</genre>
         <imageUrl> http://media.musicfrom.nl/file.php/Boris.jpg?id=34786,a0x2436;</imageUrl>
        <website>http://www.musicfrom.nl/artiesten/7172/boris.html</website>
     </artist>
</artists>
Naar boven

artist

Omschrijving Alle informatie betreffende een artiest die optreed op het evenement. Attributen Enkel als de artiest ingeschreven is bij MusicFromNL
id: Het id-nummer van de artiest in de MusicFromNL database. Waarde
  • name;
Enkel als de artiest ingeschreven is bij MusicFromNL
  • genre;
  • imageUrl;
  • website;
Voorbeeld Een optredende artiest die ingeschreven is bij MusicFromNL:
<artist id="7172">
    <name>Boris</name>
    <genre id="5">Soul / R&B / Urban</genre>
    <imageUrl>http://media.musicfrom.nl/file.php/Boris.jpg?id=34786,a0x2436</imageUrl>
    <website>http://www.musicfrom.nl/artiesten/7172/boris.html</website>
</artist>

Een optredende artiest die niet ingeschreven is bij MusicFromNL:
<artist>
    <name>Lotte Horlings</name>
</artist>
Naar boven

name

Omschrijving De naam van de optredende artiest. Attributen Geen Waarde De naam van de artiest. Voorbeeld
<name>Guido Weijers</name>
Naar boven

genre

Omschrijving Enkel als de artiest ingeschreven is bij MusicFromNL
Het genre van de artiest. Attributen id: Het genre-id van de artiest. Waarde De naam van het genre. Voorbeeld
<genre id="4">Hiphop / Rap</genre>
Naar boven

imageUrl

Omschrijving Enkel als de artiest ingeschreven is bij MusicFromNL
URL naar een afbeelding van de artiest. Attributen Geen Waarde De URL. Voorbeeld
<imageUrl>
     http://media.musicfrom.nl/file.php/Boef%20en%20de%20Gelogeerde%20Aap.jpg?id=55078,2vwsq25
</imageUrl>
Naar boven

website

Omschrijving Enkel als de artiest ingeschreven is bij MusicFromNL
URL naar de profielpagina van de artiest op MusicFromNL. Attributen Geen Waarde De URL. Voorbeeld
<website>
    http://www.musicfrom.nl/artiesten/15467/boef-en-de-gelogeerde-aap.html
</website>
Naar boven

location

Omschrijving In dit deel van de XML-stream staan alle beschikbare gegevens met betrekking tot het podium of locatie van het evenement.
Informatie over de locatie van het evenement wordt enkel getoond wanneer het podium of locatie ingeschreven is bij MusicFromNL Attributen id: Het id-nummer dat het podium of locatie heeft in de MusicFromNL database. Waarde
  • name;
  • stage;
  • imageUrl;
  • province;
  • region;
  • city;
  • address;
  • zipcode;
  • telephone;
  • fax;
  • email;
  • website;
Voorbeeld
<location id="1598">
    <name>Mezz</name>
    <stage>Zaal</stage>
     <imageUrl> http://media.musicfrom.nl/file.php/1598.gif?id=18608,1uypbd4 </imageUrl>
     <province id="9">Noord-Brabant</province>
    <region id="13">Breda</region>
    <city>Breda</city>
    <address>Keizerstraat 101</address>
    <zipcode>4811 HL</zipcode>
    <telephone>076-5156677</telephone>
    <fax>076-5200237</fax>
    <email>info@mezz.nl</email>
    <website>http://www.mezz.nl</website>
</location>
Naar boven

name

Omschrijving De naam van het podium of locatie waar het evenement plaatsvindt. Attributen Geen Waarde De naam. Voorbeeld
<name>Bibelot</name>
Naar boven

stage

Omschrijving De zaal binnen het podium waar het evenement plaatsvindt. Attributen Geen Waarde Naam van de zaal. Voorbeeld
<stage>Grote zaal</stage>
Naar boven

imageUrl

Omschrijving URL naar een afbeelding van het podium of locatie, indien beschikbaar. Attributen Geen Waarde De URL. Voorbeeld
<imageUrl>
    http://media.musicfrom.nl/file.php/1517.jpg?id=19019,20y2kcd
</imageUrl>
Naar boven

province

Omschrijving De provincie waarin het podium of locatie van het evenement zich bevindt. Attributen id: Het id-nummer die de provincie heeft in de MusicFromNL database. Waarde De naam van de provincie. Voorbeeld
<province id="2">Zuid-Holland</province>
Naar boven

region

Omschrijving De regio waarin het podium of locatie van het evenement zich bevindt. Attributen id: Het id-nummer die de regio heeft in de MusicFromNL database. Waarde De naam van de regio. Voorbeeld
<region id="8">Dordrecht</region>
Naar boven

city

Omschrijving De plaats waarin het podium of locatie van het evenement zich bevindt. Attributen Geen Waarde De naam van de plaats. Voorbeeld
<city>Dordrecht</city>
Naar boven

address

Omschrijving Het adres van het podium of locatie. Attributen Geen Waarde Het adres. Voorbeeld
<address>Hoofdstraat 131</address>
Naar boven

zipcode

Omschrijving De postcode van het podium of locatie. Attributen Geen Waarde De postcode. Voorbeeld
<zipcode>1234 AB</zipcode>
Naar boven

telephone

Omschrijving Het telefoonnummer van het podium of locatie waar het evenement plaatsvindt. Attributen Geen Waarde Het telefoonnummer. Voorbeeld
<telephone>010 4761318</telephone>
Naar boven

fax

Omschrijving Het faxnummer van het podium of locatie waar het evenement plaatsvindt. Attributen Geen Waarde Het faxnummer. Voorbeeld
<fax>010 8920923</fax>
Naar boven

email

Omschrijving Het e-mailadres van het podium of locatie waar het evenement plaatsvindt. Attributen Geen Waarde Het e-mailadres. Voorbeeld
<email>info@musicfrom.nl</email>
Naar boven

website

Omschrijving URL naar de website van het podium of locatie waar het evenement plaatsvindt. Attributen Geen Waarde De URL naar de website Voorbeeld
<website>http://www.musicfrom.nl</website>
Naar boven