Event API Methods

Description for event related api calls.

event/search

http://api.play.fm/event/search/[your_api_key]

Parameter

• title (optional) - the event title in question
• country (optional) - the country US / AT / DE ...
• city (optional) - the exact city name
• style (optional) - the style in question (techno, house, ...)
• club (optional) - the club in question (name or slug)
• artist (optional) - the artist in question (name or slug)
• page (optional)
• itemsPerPage (optional, max/default 50)

Examples

All Events
http://api.play.fm/event/search/1be42c016037b4d3182c:52c69e3a57

All Events with "hell" in name
http://api.play.fm/event/search/1be42c016037b4d3182c:52c69e3a57/name/hell/itemsPerPage/10/page/1

All Events with style "techno"
http://api.play.fm/event/search/1be42c016037b4d3182c:52c69e3a57/style/techno

Response

<results>
  <opensearch:Query role="request" searchTerms="" startPage="5"/>
  <opensearch:totalResults>5111</opensearch:totalResults>
  <opensearch:startIndex>8</opensearch:startIndex>
  <opensearch:itemsPerPagex>2</opensearch:itemsPerPagex>
 
  <matches results="2">
    <event slug="franklorber" id="12393">
      <title>Frank Lorber</title>
      <full_title>Frank Lorber @ Romy S (Stuttgart,DE) - 2009-09-26</full_title>
      <date>2009-09-26</date> 
      <club slug="romys" id="8929" url="http://www.play.fm/club/romys">
        <title>Romy S</title>
        <country>DE</country>
        <city>Stuttgart</city>
        <street>Langestr.7</street>
        <postal_code>70176</postal_code>
      </club>
      <lineup>
        <artist slug="franklorber" id="2511">Frank Lorber</artist>
        <artist slug="tomhumljan" id="170657">Tom Humljan</artist>
      </lineup>
      <url>http://www.play.fm/event/franklorber</url>
      <recordings count="0"/>
      <image>http://static.play.fm/thumbs/big/center/middle/1_49c54ea5-0699-bd268433.jpg</image>
      <thumbnail>http://static.play.fm/thumbs/small/center/middle/1_49c54ea5-0699-bd268433.jpg</thumbnail>
    </event>
    <event slug="doeasyrecordslabelnight1" id="12453">
      <title>DoEasyRecords LABELNIGHT</title>
      <full_title>DoEasyRecords LABELNIGHT @ SASS Music Club (Vienna,AT) - 2009-09-26</full_title>
      <date>2009-09-26</date>
      <club slug="sassmusicclub" id="8740" url="http://www.play.fm/club/sassmusicclub">
        <title>SASS Music Club</title>
        <country>AT</country>
        <city>Vienna</city>
        <street>Karlsplatz 1</street>
        <postal_code>1010</postal_code>
      </club>
      <lineup>
        <artist slug="matthiasmeyer" id="3557">Matthias Meyer</artist>
        <artist slug="johanneslehner" id="5869">Johannes Lehner</artist>
        <artist slug="christophergroove" id="5610">Christopher Groove</artist>
        <artist slug="andycatana" id="5030">Andy Catana</artist>
      </lineup>
      <url>http://www.play.fm/event/doeasyrecordslabelnight1</url>
      <recordings count="1">
        <rss_popular>http://www.play.fm/recordings/rss/event/doeasyrecordslabelnight1/total</rss_popular>
        <rss_recent>http://www.play.fm/recordings/rss/event/doeasyrecordslabelnight1</rss_recent>
      </recordings>
      <image>http://static.play.fm/thumbs/big/center/middle/1_49c54eb2-4529-71b9c7e0.jpg</image>
      <thumbnail>http://static.play.fm/thumbs/small/center/middle/1_49c54eb2-4529-71b9c7e0.jpg</thumbnail>
    </event>
  </matches>
</results>