Plakatt API

The Plakatt API allows anyone to build their own programs using Plakatt data. The API is implemented over standard HTTP requests, which allows Plakatt to be integrated with any web, desktop or mobile application.

Introduction

The base URL is http://api.plakatt.com/v1. Responses can be in XML or JSON format. You can choose the response format by appending .xml or .json to the API method within the URL.

To access the API you need an API key. To obtain a key, please fill out this form (you need to be logged in) with a short description of how you intend to use the API.

Plakatt API is young and evolving. If you have any ideas or requests, contact us and we will discuss it.

Searches for cities whose name matches a query.

Required parameter:

  • name - the name that city should match.

Example request: http://api.plakatt.com/v1/cities/search.xml?name=novi+sad&api_key=your_api_key

Example response: 


<?xml version="1.0" encoding="UTF-8"?>
<cities type="array">
  <city>
    <created-at type="datetime">2009-09-21T18:24:52+02:00</created-at>
    <id type="integer">3</id>
    <name>Novi Sad</name>
    <updated-at type="datetime">2009-09-21T18:24:52+02:00</updated-at>
    <locations-count>128</locations-count>

    <country-name>Srbija</country-name>
  </city>
  ...
</cities>

Searches for tags that match a query.

Required parameter:

  • q - the query that tag(s) should match.

Example request: http://api.plakatt.com/v1/tags/search.xml?q=punk&api_key=your_api_key

Example response: 


<?xml version="1.0" encoding="UTF-8"?>
<tags type="array">
  <tag>
    <id type="integer">30</id>
    <name>punk</name>
  </tag>
  ...
</tags>

/events/in_city

Finds all events in a city.

Required parameter:

  • city - ID of the city.

Optional parameters:

  • from_date - the earliest date of the event, in format "YYYY-MM-DD". Defaults to current date if omitted.
  • to_date - the last date in the range when the event should be, also in format "YYYY-MM-DD".

Example request: http://api.plakatt.com/v1/events/in_city.xml?city=3&api_key=your_api_key

Example response: 


<?xml version="1.0" encoding="UTF-8"?>
<events type="array">
  <event>
    <created-at type="datetime">2010-09-24T23:06:36+02:00</created-at>
    <id type="integer">3217</id>
    <location-id type="integer">77</location-id>
    <time-begin type="datetime">2010-11-10T20:00:00+01:00</time-begin>
    <time-end type="datetime">2010-11-10T23:00:00+01:00</time-end>
    <title>Reflections Of Internal Rain, Nine Eleven (francuska)</title>
    <updated-at type="datetime">2010-11-08T14:07:46+01:00</updated-at>
    <url></url>
    <user-id type="integer">703</user-id>
    <description>&lt;...</description>
    <image-square-small>http://plakatt.com/system/events/avatars/3217/thumb64_CK_plakat.jpg</image-square-small>
    <image-small>http://plakatt.com/system/events/avatars/3217/thumb88_CK_plakat.jpg</image-small>
    <image-large>http://plakatt.com/system/events/avatars/3217/thumb419_CK_plakat.jpg</image-large>
    <location-name>Omladinski centar CK13</location-name>
    <city-name>Novi Sad</city-name>
  </event>
  ...
</events>

Note that event description is in HTML format.

/events/tagged

Finds all events tagged with a certain tag.

Required parameter:

  • tag - ID of the tag.

Optional parameters:

  • from_date - the earliest date of the event, in format "YYYY-MM-DD". Defaults to current date if omitted.
  • to_date - the last date in the range when the event should be, also in format "YYYY-MM-DD".

Example request: http://api.plakatt.com/v1/events/tagged.xml?tag=30&from_date=2010-04-29&to_date=2010-06-29&api_key=your_api_key

Example response: 


<?xml version="1.0" encoding="UTF-8"?>
<events type="array">
  <event>
    <created-at type="datetime">2010-01-29T20:45:18+01:00</created-at>
    <id type="integer">1805</id>
    <location-id type="integer">172</location-id>
    <time-begin type="datetime">2010-05-06T22:00:00+02:00</time-begin>
    <time-end type="datetime" nil="true"></time-end>
    <title>H2O i Hitman</title>
    <updated-at type="datetime">2010-04-28T15:18:37+02:00</updated-at>
    <url></url>
    <user-id type="integer">29</user-id>
    <description>...</description>
    <image-square-small>http://plakatt.com/system/events/avatars/1805/thumb64_23261985.jpeg</image-square-small>
    <image-small>http://plakatt.com/system/events/avatars/1805/thumb88_23261985.jpeg</image-small>
    <image-large>http://plakatt.com/system/events/avatars/1805/thumb419_23261985.jpeg</image-large>
    <location-name>Livingroom SKC&#8211;a</location-name>
    <city-name>Beograd</city-name>
  </event>
  ...
</events>

Note that event description is in HTML format.