Introduction

Welcome to the Teosto Open API. This documentation should help you familiarize yourself with the resources available. Read throught the Getting started section before you dive in.

The data includes all of the live events reported to Teosto by event organizers, performers and services that provide event information. This is the largest live music event database in Finland. We've also included location information on region, municipality and venue levels to help you get something more out of our data.

By using this API you agree to the Terms & Conditions of Teosto Open API.

If you come up with a great idea for using the Teosto Open API, we'd appreciate if you share it with us using the contact form!

Getting started

Authentication

Teosto Open API is completely open API. No authentication is required to request and get data. This also means that we've limited what you can do to just GET-ing the data. If you find a mistake in the data, then contact us to let us know.

Base URL

The Base URL is the root URL for all of the API. The Base URL is:

http://api.teosto.fi/2017

Year

The API includes data from 2014 to 2017. Change the year in the request string to get data from different years.

NOTE: Right now the IDs don't match between years. This means for example that a Venue will have different IDs depending on the year you request. See Legacy for more information.

Request structure

The overall structure of the API request is very simple:

http://api.teosto.fi/{year}/{resource}?{parameters}
Year

Years 2014 to 2017 are available. This value is required.

Resource

One of the various API resources described in this documentation. This value is optional but without this the response will not give you any actual information, just references to the real content.

Parameters

Each resource has different parameters that include for example identifiers, methods and pagination parameters. Parameters are usually optional and if you don't specify any parameter, you will get the default response. Some parameters on the other hand require another parameters. For example:

name / id -- Used to identify a specific resource.

method -- Method specifies what information to get from a specific resource. "Methods" can only be used with identifiers.

Methods and names are not case sensitive.

Legacy

Because we have updated the data we have also updated the IDs of venues and songs (work) to match more between years. 2016 and 2017 have matching IDs for venues and songs and we recommend using those. However 2014 and 2015 venues and songs still have their old IDs and they are shown as default. You can access the new IDs for 2014 and 2015 (these new IDs are same for 2016 and 2017) by using the parameters legacy_venue=0 for venues and legacy_work=0 for songs.

These parameters only work for 2014 and 2015 venues and songs. Using this parameter won't affect newer data which only uses the new IDs.

The default value is 1, which gives you the old IDs. If you use 0 you will get the new IDs that match between years.

Due to the merges that happened in years 2016 and 2017 for the venues and songs, we have duplicated IDs in 2014 and 2015 data (the new IDs that are going to be shown with legacy_work=0 or legacy_venue=0). When using these legacy parameters, the response is a bit different.

http://api.teosto.fi/2015/venue?id=85a0083d5d&legacy_venue=0
{ "venue" : {}, "venues" : [ { "id" : "85a0083d5d", "name" : "", ... }, { "id" : "85a0083d5d", "name" : "MIKKELI", ... } ] }

The result will always be shown under venues and for legacy support, the blank key venue will be shown too.

Also, in the above query when the legacy parameter isn't used, the venues key will be included as an empty array for a better support of modes in both years.

Responses

The response is always JSON. Responses include the data you were requesting, of course, and if you request a list of some sorts, the response will also include meta data.

If some piece of data is missing, for example a venue doesn't have a name but it still has all the other information, you will see the value <n/a> (not available). Only available data can be searched.

Response paging

If you request for a list, the response will include an object response_meta which has six meta information tags: page, limit, pages, previous, next and one that tells you the total number of objects in that list. These exists because we have limited the response to 100 objects per result set (page) as a default. We've also wanted to make it easy for you to move from one page to another, hence the previous and next tags, which will give you the url for the next or previous page requests. The previous and next URLs will change depenging on the limit and page you use in the request.

You can change the limit by using the limit method in your request string. The maximum value for limit is 1000. You can also skip pages by using the page method in your request string. For example:

http://api.teosto.fi/2017/event?limit=20&page=4
{ "events" : [{ // event information }, ... ], "response_meta" : { "page" : 4, "limit" : 20, "pages" : 2581, "events" : 51610, "previous" : "http://api.teosto.fi/2017/event/?limit=20&page=3", "next" : "http://api.teosto.fi/2017/event/?limit=20&page=5", } }

This request will give you the events 41-60. The tag name used for total number in response_meta is always the same as the list objects name (highlighted on red).

Rate limit

Upon the new regulations, there is a limit on sending HTTP requests to the API. You will be able to make 5 requests per originating IP address per second in average.

Errors

Sometimes errors occur. Here's a list of error numbers (1-9) and also HTTP status codes to help you figure out what caused the unfortunate error. Successful responses have the HTTP status code 200.

  • 1 404 -- Invalid request Your request requires a valid format and a valid resource value.
  • 2 408 -- Invalid parameter(s) Your request contains invalid parameter(s).
  • 3 400 -- Request timeout The request failed because it took too long to respond.
  • 4 400 -- Invalid method. Your method is not valid.
  • 5 400 -- Missing method parameter(s) Your request is missing method parameter(s).
  • 6 404 -- Invalid method parameter(s) value Your request contains invalid method parameter(s) value.
  • 7 400 -- Invalid page limit value Your request contains invalid page limit value.
  • 8 400 -- Invalid page number value Your request contains invalid page number value.
  • 9 400 -- Invalid page limit and page number values Your request contains invalid page limit and page number values.
  • - 500 -- Undefined error The error is not defined, please contact with the support team.

Changelog

You can find the changelog here.

Resources

Below are all of the resources in this API.

All of the resource methods have examples for requests and responses, where you can see the format. We've snipped out the response_meta from the example responses but it will always be in the same format as described above.

Root

The Root resource provides information on all available resources within the API.

Example request:
http://api.teosto.fi
Example response:
{ "region":{ "url":"http://api.teosto.fi/2017/region", "count":20 }, "municipality":{ "url":"http://api.teosto.fi/2017/municipality", "count":305 }, "place":{ "url":"http://api.teosto.fi/2017/place", "count":7627 }, "venue":{ "url":"http://api.teosto.fi/2017/venue", "count":8867 }, "event":{ "url":"http://api.teosto.fi/2017/event", "count":49589 }, "show":{ "url":"http://api.teosto.fi/2017/show", "count":71062 }, "performer":{ "url":"http://api.teosto.fi/2017/performer", "count":16087 }, "work":{ "url":"http://api.teosto.fi/2017/work", "count":70943 }, "author":{ "url":"http://api.teosto.fi/2017/author", "count":33577 }, "role":{ "url":"http://api.teosto.fi/2017/role", "count":6 }, "date":{ "url":"http://api.teosto.fi/2017/date" }, "finland":{ "url":"http://api.teosto.fi/2017/finland" } }

Finland

Finland resource is a collection of top lists from Finland.

Example request:
http://api.teosto.fi/2017/finland?method=topWorks
Example response:
{ "topWorks":[ { "work":{ "id":"86a209385bf39246", "title":"PARATIISI", "url":"http://api.teosto.fi/2017/work?id=86a209385bf39246" }, "count":1101 }, { "work":{ "id":"85a50a3f52f691", "title":"SATUMAA", "url":"http://api.teosto.fi/2017/work?id=85a50a3f52f691" }, "count":890 }, ... ], "finland":{ "url":"http://api.teosto.fi/2017/finland" }, "response_meta":{ ... } }

Methods

  • /finland

    List of all the methods available for finland resource.

    Example request:
    http://api.teosto.fi/2017/finland
    Example response:
    { "finland":{ "topWorks":{ "url":"http://api.teosto.fi/2017/finland?method=topWorks" } } }
  • /finland?method=topWorks

    List of top works played in Finland.

    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/finland?method=topWorks
    Example response:
    { "topWorks":[ { "work":{ "id":"86a209385bf39246", "title":"PARATIISI", "url":"http://api.teosto.fi/2017/work?id=86a209385bf39246" }, "count":1101 }, { "work":{ "id":"85a50a3f52f691", "title":"SATUMAA", "url":"http://api.teosto.fi/2017/work?id=85a50a3f52f691" }, "count":890 }, ... ], "finland":{ "url":"http://api.teosto.fi/2017/finland" }, "response_meta":{ ... } }

Region

A region resource is one region in Finland.

Example request:
http://api.teosto.fi/2017/region?name=PIRKANMAA
Example response:
{ "region":{ "name":"PIRKANMAA", "municipalities":{ "url":"http://api.teosto.fi/2017/region?name=PIRKANMAA&method=municipalities", "count":22 }, "places":{ "url":"http://api.teosto.fi/2017/region?name=PIRKANMAA&method=places", "count":727 }, "venues":{ "url":"http://api.teosto.fi/2017/region?name=PIRKANMAA&method=venues", "count":844 }, "events":{ "url":"http://api.teosto.fi/2017/region?name=PIRKANMAA&method=events", "count":5282 }, "topWorks":{ "url":"http://api.teosto.fi/2017/region?name=PIRKANMAA&method=topWorks" } } }

Methods

  • /region

    Get all the region resources.

    This is the default method for region resource.

    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/region
    Example response:
    { "regions":[ { "name":"AHVENANMAA", "url":"http://api.teosto.fi/2017/region?name=AHVENANMAA" }, ... ], "response_meta":{ ... } }
  • /region?name={regionName}

    Basic info and URLs for more information about specific region.

    This is the default method for specific region.

    Reguired parameters
    • name Identifies one specific region.
    Example request:
    http://api.teosto.fi/2017/region?name=PIRKANMAA
    Example response:
    { "region":{ "name":"PIRKANMAA", "municipalities":{ "url":"http://api.teosto.fi/2017/region?name=PIRKANMAA&method=municipalities", "count":22 }, "places":{ "url":"http://api.teosto.fi/2017/region?name=PIRKANMAA&method=places", "count":727 }, "venues":{ "url":"http://api.teosto.fi/2017/region?name=PIRKANMAA&method=venues", "count":844 }, "events":{ "url":"http://api.teosto.fi/2017/region?name=PIRKANMAA&method=events", "count":5282 }, "topWorks":{ "url":"http://api.teosto.fi/2017/region?name=PIRKANMAA&method=topWorks" } } }
  • /region?name={regionName}&method=municipalities

    List of all the municipalities in one specific region.

    Reguired parameters
    • name Identifies one specific region.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/region?name=PIRKANMAA&method=municipalities
    Example response:
    { "municipalities":[ { "name":"AKAA", "url":"http://api.teosto.fi/2017/municipality?name=AKAA" }, { "name":"URJALA", "url":"http://api.teosto.fi/2017/municipality?name=URJALA" }, ... ], "region":{ "name":"PIRKANMAA", "url":"http://api.teosto.fi/2017/region?name=PIRKANMAA" }, "response_meta":{ ... } }
  • /region?name={regionName}&method=places

    List of all the places in one specific region.

    Reguired parameters
    • name Identifies one specific region.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/region?name=PIRKANMAA&method=places
    Example response:
    { "places":[ { "id":"86a1", "url":"http://api.teosto.fi/2017/place?id=86a1" }, ... ], "region":{ "name":"PIRKANMAA", "url":"http://api.teosto.fi/2017/region?name=PIRKANMAA" }, "response_meta":{ ... } }
  • /region?name={regionName}&method=venues

    List of all the venues in one specific region.

    Reguired parameters
    • name Identifies one specific region.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/region?name=PIRKANMAA&method=venues
    Example response:
    { "venues":[ { "id": "85a3013f58", "name": "METSÄLINNA", "url":"http://api.teosto.fi/2017/venue?id=85a3013f58" }, ... ], "region":{ "name":"PIRKANMAA", "url":"http://api.teosto.fi/2017/region?name=PIRKANMAA" }, "response_meta":{ ... } }
  • /region?name={regionName}&method=events

    List of all the events in one specific region.

    Reguired parameters
    • name Identifies one specific region.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/region?name=PIRKANMAA&method=events
    Example response:
    { "events":[ { "id":"85a70d3c5cf590", "name": "JANNE HURME", "startDate": "2017-01-01", "endDate": "2017-01-01", "url":"http://api.teosto.fi/2017/event?id=85a70d3c5cf590" }, ... ], "region":{ "name":"PIRKANMAA", "url":"http://api.teosto.fi/2017/region?name=PIRKANMAA" }, "response_meta":{ ... } }
  • /region?name={regionName}&method=topWorks

    List of top works played in one specific region.

    Reguired parameters
    • name Identifies one specific region.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/region?name=PIRKANMAA&method=topWorks
    Example response:
    { "topWorks":[ { "work":{ "id":"86a2093f5ef49648", "title":"SININEN HUIVI", "url":"http://api.teosto.fi/2017/work?id=86a2093f5ef49648" }, "count":99 }, { "work":{ "id":"86a209385bf39246", "title":"PARATIISI", "url":"http://api.teosto.fi/2017/work?id=86a209385bf39246" }, "count":96 }, ... ], "region":{ "name":"PIRKANMAA", "url":"http://api.teosto.fi/2017/region?name=PIRKANMAA" }, "response_meta":{ ... } }

Municipality

A municipality resource is one municipality in Finland.

Example request:
http://api.teosto.fi/2017/municipality?name=TAMPERE
Example response:
{ "municipality":{ "name":"TAMPERE", "region":{ "name":"PIRKANMAA", "url":"http://api.teosto.fi/2017/region?name=PIRKANMAA" } "places":{ "url":"http://api.teosto.fi/2017/municipality?name=TAMPERE&method=places", "count":301 }, "venues":{ "url":"http://api.teosto.fi/2017/municipality?name=TAMPERE&method=venues", "count":362 }, "events":{ "url":"http://api.teosto.fi/2017/municipality?name=TAMPERE&method=events", "count":3520 }, "topWorks":{ "url":"http://api.teosto.fi/2017/municipality?name=TAMPERE&method=topWorks" } } }

Methods

  • /municipality

    Get all the municipality resources.

    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/municipality
    Example response:
    { "municipalities":[ { "name":"AKAA", "url":"http://api.teosto.fi/2017/municipality?name=AKAA" }, ... ], "response_meta":{ ... } }
  • /municipality?name={municipalityName}

    Basic info and URLs for more information about specific municipality.

    Reguired parameters
    • name Identifies one specific municipality.
    Example request:
    http://api.teosto.fi/2017/municipality?name=TAMPERE
    Example response:
    { "municipality":{ "name":"TAMPERE", "region":{ "name":"PIRKANMAA", "url":"http://api.teosto.fi/2017/region?name=PIRKANMAA" } "places":{ "url":"http://api.teosto.fi/2017/municipality?name=TAMPERE&method=places", "count":301 }, "venues":{ "url":"http://api.teosto.fi/2017/municipality?name=TAMPERE&method=venues", "count":362 }, "events":{ "url":"http://api.teosto.fi/2017/municipality?name=TAMPERE&method=events", "count":3520 }, "topWorks":{ "url":"http://api.teosto.fi/2017/municipality?name=TAMPERE&method=topWorks" } } }
  • /municipality?name={municipalityName}&method=places

    List of all the places in one specific municipality.

    Reguired parameters
    • name Identifies one specific municipality.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/municipality?name=TAMPERE&method=places
    Example response:
    { "places":[ { "id":"87a308", "url":"http://api.teosto.fi/2017/place?id=87a308" }, { "id":"80a609", "url":"http://api.teosto.fi/2017/place?id=80a609" }, ... ], "municipality":{ "name":"TAMPERE", "url":"http://api.teosto.fi/2017/municipality?name=TAMPERE" }, "response_meta":{ ... } }
  • /municipality?name={municipalityName}&method=venues

    List of all the venues in one specific municipality.

    Reguired parameters
    • name Identifies one specific municipality.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/municipality?name=TAMPERE&method=venues
    Example response:
    { "venues":[ { "id":"86a200", "name":"AHLMANIN AMMATTIOPISTO", "url":"http://api.teosto.fi/2017/venue?id=86a200" }, { "id":"86a600", "name":"AIKALISÄ SPORT & MUSIC BAR", "url":"http://api.teosto.fi/2017/venue?id=86a600" }, { "id":"86a50d", "name":"AITOLAHDEN KIRKKO", "url":"http://api.teosto.fi/2017/venue?id=86a50d" }, ... ], "municipality":{ "name":"TAMPERE", "url":"http://api.teosto.fi/2017/municipality?name=TAMPERE" }, "response_meta":{ ... } }
  • /municipality?name={municipalityName}&method=events

    List of all the events in one specific municipality.

    Reguired parameters
    • name Identifies one specific municipality.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/municipality?name=TAMPERE&method=events
    Example response:
    { "events":[ { "id":"85a7093e5ef394", "name":"Tapahtuman nimi", "startDate":"2017-01-03", "endDate":"2017-01-03", "url":"http://api.teosto.fi/2017/event?id=85a7093e5ef394" }, ... ], "municipality":{ "name":"TAMPERE", "url":"http://api.teosto.fi/2017/municipality?name=TAMPERE" }, "response_meta":{ ... } }
  • /municipality?name={municipalityName}&method=topWorks

    List of top works played in one specific municipality.

    Reguired parameters
    • name Identifies one specific municipality.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/municipality?name=TAMPERE&method=topWorks
    Example response:
    { "topWorks":[ { "work":{ "id":"82a40c395bf0", "title":"TÄYSIKUU", "url":"http://api.teosto.fi/2017/work?id=82a40c395bf0" }, "count":49 }, { "work":{ "id":"86a2083159f39c49", "title":"RAKKAUS ON PETTÄVÄÄ", "url":"http://api.teosto.fi/2017/work?id=86a2083159f39c49" }, "count":42 }, ... ], "municipality":{ "name":"TAMPERE", "url":"http://api.teosto.fi/2017/municipality?name=TAMPERE" }, "response_meta":{ ... } }

Place

A place resource is one place in Finland. Most places have an address and their geocoordinates have been defined with that address. If an address hasn't been specified, the geocoordinates are the central coordinates of the municipality.

Places don't have names since they are basically just addresses so we've used IDs to identify them in the API.

Example request:
http://api.teosto.fi/2017/place?id=85a10f385e
Example response:
{ "place":{ "id":"85a10f385e", "address":{ "streetAddress":"SILTAKATU 1 ILOSAARI", "zipCode":"80100", "postOffice":"JOENSUU" }, "geoCoordinates":{ "latitude":"62.599058", "longitude":"29.770381" }, "municipality":{ "name":"JOENSUU", "url":"http://api.teosto.fi/2017/municipality?name=JOENSUU" }, "venues":{ "url":"http://api.teosto.fi/2017/place?id=85a10f385e&method=venues", "count":3 }, "topWorks":{ "url":"http://api.teosto.fi/2017/place?id=85a10f385e&method=topWorks" } } }

Methods

  • /place

    Get all the place resources.

    Optional parameters
    • page description
    • limit description
    Example request:
    http://api.teosto.fi/2017/place
    Example response:
    { "places":[ { "id":"82a2", "url":"http://api.teosto.fi/2017/place?id=82a2" }, { "id":"82a3", "url":"http://api.teosto.fi/2017/place?id=82a3" }, ... ], "response_meta":{ ... } }
  • /place?id={placeID}

    Get the basic info and URLs for more information about specific place.

    Required parameters
    • id Identifies one specific place.
    Example request:
    http://api.teosto.fi/2017/place?id=85a10f385e
    Example response:
    { "place":{ "id":"85a10f385e", "address":{ "streetAddress":"SILTAKATU 1 ILOSAARI", "zipCode":"80100", "postOffice":"JOENSUU" }, "geoCoordinates":{ "latitude":"62.599058", "longitude":"29.770381" }, "municipality":{ "name":"JOENSUU", "url":"http://api.teosto.fi/2017/municipality?name=JOENSUU" }, "venues":{ "url":"http://api.teosto.fi/2017/place?id=85a10f385e&method=venues", "count":3 }, "topWorks":{ "url":"http://api.teosto.fi/2017/place?id=85a10f385e&method=topWorks" } } }
  • /place?id={placeID}&method=venues

    List of venues of one specific place.

    Required parameters
    • id Identifies one specific place.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/place?id=85a10f385e&method=venues
    Example response:
    { "venues":[ { "id":"83a1083f", "name":"KERUBIN KELLARI", "url":"http://api.teosto.fi/2017/venue?id=83a1083f" }, { "id":"83a10830", "name":"KERUBIN SALI", "url":"http://api.teosto.fi/2017/venue?id=83a10830" } ... ], "place":{ "id":"85a10f385e", "url":"http://api.teosto.fi/2017/place?id=85a10f385e" }, "response_meta":{ ... } }
  • /place?id={placeID}&method=topWorks

    List of top works played in one specific place.

    Required parameters
    • id Identifies one specific place.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/place?id=85a10f385e&method=topWorks
    Example response:
    { "topWorks":[ { "work":{ "id":"85ab09385bf39746", "title":"AHMAT TULEVAT", "url":"http://api.teosto.fi/2017/work?id=85ab09385bf39746" }, "count":3 }, { "work":{ "id":"87a4093d59f59548", "title":"ANTAUDUN", "url":"http://api.teosto.fi/2017/work?id=87a4093d59f59548" }, "count":3 }, ... ], "place":{ "id":"85a10f385e", "url":"http://api.teosto.fi/2017/place?id=85a10f385e" }, "response_meta":{ ... } }

Venue

A venue resource is one venue in Finland. Venue's are unique but many venues can have the same address and place.

NOTE: Right now the IDs don't match between years. This means for example that a Venue will have different IDs depending on the year you request. See Legacy for more information.

Example request:
http://api.teosto.fi/2017/venue?id=83a1083f
Example response:
{ "venue":{ "id":"83a1083f", "name":"KERUBIN KELLARI", "place":{ "id":"85a10f385e", "address":{ "streetAddress":"SILTAKATU 1 ILOSAARI", "zipCode":"80100", "postOffice":"JOENSUU" }, "geoCoordinates":{ "latitude":"62.599058", "longitude":"29.770381" }, "municipality":{ "name":"JOENSUU", "url":"http://api.teosto.fi/2017/municipality?name=JOENSUU" }, "url":"http://api.teosto.fi/2017/place?id=85a10f385e" }, "events":{ "url":"http://api.teosto.fi/2017/venue?id=83a1083f&method=events", "count":13 }, "topWorks":{ "url":"http://api.teosto.fi/2017/venue?id=83a1083f&method=topWorks" } } }

Methods

  • /venue

    Get all the venue resources.

    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/venue
    Example response:
    { "venues":[ { "id":"85a600", "name":"AAPELIN BAARI", "url":"http://api.teosto.fi/2017/venue?id=85a600" }, { "id":"85a708", "name":"AARNIVALKEAN KOULU", "url":"http://api.teosto.fi/2017/venue?id=85a708" }, ... ], "response_meta":{ ... } }
  • /venue?id={venueID}

    Get the basic info and URLs for more information about specific venue.

    Required parameters
    • id Identifies one specific venue.
    Example request:
    http://api.teosto.fi/2017/venue?id=83a1083f
    Example response:
    { "venue":{ "id":"83a1083f", "name":"KERUBIN KELLARI", "place":{ "id":"85a10f385e", "address":{ "streetAddress":"SILTAKATU 1 ILOSAARI", "zipCode":"80100", "postOffice":"JOENSUU" }, "geoCoordinates":{ "latitude":"62.599404", "longitude":"29.77166" }, "municipality":{ "name":"JOENSUU", "url":"http://api.teosto.fi/2017/municipality?name=JOENSUU" }, "url":"http://api.teosto.fi/2017/place?id=85a10f385e" }, "events":{ "url":"http://api.teosto.fi/2017/venue?id=83a1083f&method=events", "count":13 }, "topWorks":{ "url":"http://api.teosto.fi/2017/venue?id=83a1083f&method=topWorks" } } }
  • /venue?id={venueID}&method=events

    List of events in one specific venue.

    Required parameters
    • id Identifies one specific venue.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/venue?id=83a1083f&method=events
    Example response:
    { "events":[ { "id": "85a70b3c5df89d", "name": "ADI L HASLA", "startDate": "2017-03-11", "endDate": "2017-03-11", "url": "http://api.teosto.fi/2017/event?id=85a70b3c5df89d" }, ... ], "venue":{ "id":"83a1083f", "url":"http://api.teosto.fi/2017/venue?id=83a1083f" }, "response_meta":{ ... } }
  • /venue?id={venueID}&method=topWorks

    List of top works played in one specific venue.

    Required parameters
    • id Identifies one specific venue.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/venue?id=83a1083f&method=topWorks
    Example response:
    { "topWorks":[ { "work":{ "id":"86aa083d5bf99049", "title":"AKUUTTI ELÄMÄ", "url":"http://api.teosto.fi/2017/work?id=86aa083d5bf99049" }, "count":2 }, ... ], "venue":{ "id":"83a1083f", "url":"http://api.teosto.fi/2017/venue?id=83a1083f" }, "response_meta":{ ... } }
  • /venue?name={venueName}

    You can search for a venue by name using this method. Use + as a word seperator.

    Required parameters
    • name String to seach for.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/venue?name=tavastia
    Example response:
    { "venues":[ { "id":"86a3093c5e", "name":"TAVASTIA KLUBI", "url":"http://api.teosto.fi/2017/venue?id=86a3093c5e" }, { "id":"86a10c315c", "name":"VILLA TAVASTIA", "url":"http://api.teosto.fi/2017/venue?id=86a10c315c" } ], "response_meta":{ ... } }

Event

An event resource is one event. Usually events include only one show but there are of course bigger events like music festivals that include several shows.

Example request:
http://api.teosto.fi/2017/event?id=85a70b3152f997
Example response:
{ "event":{ "id":"85a70b3152f997", "name":"JENNI VARTIAINEN", "startDate": "2017-04-30", "endDate": "2017-04-30", "venue": { "id": "86a3093c5e", "name": "TAVASTIA KLUBI", "place": { "id": "85a701385b", "url": "http://api.teosto.fi/2017/place?id=85a701385b" }, "url": "http://api.teosto.fi/2017/venue?id=86a3093c5e" }, "shows":{ "url":"http://api.teosto.fi/2017/event?id=85a70b3152f997&method=shows", "count":2 } } }

Methods

  • /event

    Get all the event resources.

    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/event
    Example response:
    { "events":[ { "id":"85a709305ef392", "name":"PÄIVÄTANSSIT 01.01.2017", "startDate":"2017-01-01", "endDate":"2017-01-01", "url":"http://api.teosto.fi/2017/event?id=85a709305ef392" }, ... ], "response_meta":{ ... } }
  • /event?id={eventID}

    Get the basic info and URLs for more information about specific event.

    Required parameters
    • id Identifies one specific event.
    Example request:
    http://api.teosto.fi/2017/event?id=85a70b3152f997
    Example response:
    { "event":{ "id":"85a70b3152f997", "name":"JENNI VARTIAINEN", "startDate": "2017-04-30", "endDate": "2017-04-30", "venue": { "id": "86a3093c5e", "name": "TAVASTIA KLUBI", "place": { "id": "85a701385b", "url": "http://api.teosto.fi/2017/place?id=85a701385b" }, "url": "http://api.teosto.fi/2017/venue?id=86a3093c5e" }, "shows":{ "url":"http://api.teosto.fi/2017/event?id=85a70b3152f997&method=shows", "count":2 } } }
  • /event?id={eventID}&method=shows

    List of all the shows in one specific event.

    Required parameters
    • id Identifies one specific event.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/event?id=85a70b3152f997&method=shows
    Example response:
    { "shows":[ { "id":"8ca20b3958", "url":"http://api.teosto.fi/2017/show?id=8ca20b3958" }, { "id":"8ca20b395f", "url":"http://api.teosto.fi/2017/show?id=8ca20b395f" }, ... ], "event":{ "id":"85a70b3152f997", "url":"http://api.teosto.fi/2017/event?id=85a70b3152f997" }, "response_meta":{ ... } }

Show

A show resource is one show in an event. Most of the events have only one show but bigger events like music festivals can have many shows. We've used IDs to identify shows in the API.

Example request:
http://api.teosto.fi/2017/show?id=8ca20b3958
Example response:
{ "show":{ "id":"8ca20b3958", "event":{ "id":"85a70b3152f997", "name":"JENNI VARTIAINEN", "startDate": "2017-04-30", "endDate": "2017-04-30", "venue":{ "id":"86a3093c5e", "name":"TAVASTIA KLUBI", "place":{ "id":"85a701385b", "url":"http://api.teosto.fi/2017/place?id=85a701385b" }, "url":"http://api.teosto.fi/2017/venue?id=86a3093c5e" }, "url":"http://api.teosto.fi/2017/event?id=85a70b3152f997" }, "performer":{ "id":"8da30130", "name":"JENNI VARTIAINEN", "url":"http://api.teosto.fi/2017/performer?id=8da30130" }, "works":{ "url":"http://api.teosto.fi/2017/show?id=8ca20b3958&method=works", "count":13 } } }

Methods

  • /show

    Get all the show resources.

    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/show
    Example response:
    { "shows":[ { "id":"82a00d395f", "url":"http://api.teosto.fi/2017/show?id=82a00d395f", "performer":{ "performerID": "85ab093f58", "performerName": "OTRA", "url":"http://api.teosto.fi/2017/performer?id=85ab093f58" } }, { "id":"82a00d395e", "url":"http://api.teosto.fi/2017/show?id=82a00d395e", "performer":{ "performerID": "86a30c305a", "performerName": "SUISTAMON SÄHKÖ", "url":"http://api.teosto.fi/2017/performer?id=86a30c305a" } }, ... ], "response_meta":{ ... } }
  • /show?id={showID}

    Get the basic info and URLs for more information about specific show.

    Required parameters
    • id Identifies one specific show.
    Example request:
    http://api.teosto.fi/2017/show?id=8ca20b3958
    Example response:
    { "show":{ "id":"8ca20b3958", "event":{ "id":"85a70b3152f997", "name":"JENNI VARTIAINEN", "startDate": "2017-04-30", "endDate": "2017-04-30", "venue":{ "id":"86a3093c5e", "name":"TAVASTIA KLUBI", "place":{ "id":"85a701385b", "url":"http://api.teosto.fi/2017/place?id=85a701385b" }, "url":"http://api.teosto.fi/2017/venue?id=86a3093c5e" }, "url":"http://api.teosto.fi/2017/event?id=85a70b3152f997" }, "performer":{ "id":"8da30130", "name":"JENNI VARTIAINEN", "url":"http://api.teosto.fi/2017/performer?id=8da30130" }, "works":{ "url":"http://api.teosto.fi/2017/show?id=8ca20b3958&method=works", "count":13 } } }
  • /show?id={showID}&method=works

    List of works played in one specific show.

    Required parameters
    • id Identifies one specific show.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/show?id=8ca20b3958&method=works
    Example response:
    { "works":[ { "id": "85a60e3b5bf4944e", "title": "MUSTAA KAHVIA", "url": "http://api.teosto.fi/2017/work?id=85a60e3b5bf4944e" }, { "id": "86a009395df5914e", "title": "SELVAESTI PAEIHTYNYT", "url": "http://api.teosto.fi/2017/work?id=86a009395df5914e" }, ... ], "show":{ "id":"8ca20b3958", "url":"http://api.teosto.fi/2017/show?id=8ca20b3958" }, "response_meta":{ ... } }

Performer

A performer resource is one unique unit of performers, that has been reported to Teosto as the performer of a show. Performer can consist of one ("Suvi Teräsniska") or several ("Suvi Teräsniska, Pave Maijanen, Virve Rosti") performers. Please use the performer data with caution as the data is not totally complete.

Example request:
http://api.teosto.fi/2017/performer?id=82a20930
Example response:
{ "performer":{ "id":"82a20930", "name":"JUHA TAPIO", "shows":{ "url":"http://api.teosto.fi/2017/performer?id=82a20930&method=shows", "count":63 } } }

Methods

  • /performer

    Get all the performer resources.

    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/performer
    Example response:
    { "performers":[ { "id":"87a100385a", "name":"A COMPANION OF OWLS", "url":"http://api.teosto.fi/2017/performer?id=87a100385a" }, { "id":"87a70a3159", "name":"A GRAND FEAST FOR VULTURES", "url":"http://api.teosto.fi/2017/performer?id=87a70a3159" }, ... ], "response_meta":{ ... } }
  • /performer?id={performerID}

    Get the basic info and URLs for more information about specific performer unit.

    Required parameters
    • id Identifies one specific performer unit.
    Example request:
    http://api.teosto.fi/2017/performer?id=82a20930>
    Example response:
    { "performer":{ "id":"82a20930", "name":"JUHA TAPIO", "shows":{ "url":"http://api.teosto.fi/2017/performer?id=82a20930&method=shows", "count":63 } } }
  • /performer?id={performerID}&method=shows

    List of shows with one specific performer unit.

    Required parameters
    • id Identifies one specific performer unit.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/performer?id=82a20930&method=shows
    Example response:
    { "shows":[ { "id":"82a00d3159", "url":"http://api.teosto.fi/2017/show?id=82a00d3159" }, { "id":"82a00e3f5b", "url":"http://api.teosto.fi/2017/show?id=82a00e3f5b" } ], "performer":{ "id":"82a20930", "name":"JUHA TAPIO", "url":"http://api.teosto.fi/2017/performer?id=82a20930" }, "response_meta":{ ... } }
  • /performer?name={performerName}

    You can search for a performer by name using this method. Use + as a word seperator.

    Required parameters
    • name String to seach for.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/performer?name=apulanta
    Example response:
    { "performers": [ { "id": "87a5093a", "name": "APULANTA", "url": "http://api.teosto.fi/2017/performer?id=87a5093a" }, ... ], "response_meta": { ... } }

Work

A work resource is one work played in a show. Currently ISWC numbers are not included in the 2015 data.

NOTE: Right now the IDs don't match between years. This means for example that a Work will have different IDs depending on the year you request. See Legacy for more information.

Example request:
http://api.teosto.fi/2017/work?id=86a209385bf39246
Example response:
{ "work":{ "id":"86a209385bf39246", "title":"PARATIISI", "ISWC":"", "authors":[ { "role":{ "titleAbbr":"A", "title":"Author", "url":"http://api.teosto.fi/2017/role?titleAbbr=A" }, "author":{ "id":"85ab0d3f58f995", "firstname":"ARJA RIITTA HANNELE", "lastname":"TIAINEN", "url":"http://api.teosto.fi/2017/author?id=85ab0d3f58f995" } }, ... ], "shows":{ "url":"http://api.teosto.fi/2017/work?id=86a209385bf39246&method=shows", "count":1033 }, "topMunicipalities":{ "url":"http://api.teosto.fi/2017/work?id=86a209385bf39246&method=topMunicipalities" }, "topVenues":{ "url":"http://api.teosto.fi/2017/work?id=86a209385bf39246&method=topVenues" } } }

Methods

  • /work

    List of all work resources.

    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/work
    Example response:
    { "works":[ { "id":"85aa083f5ef69049", "title":"!LIAF CIPE", "url":"http://api.teosto.fi/2017/work?id=85aa083f5ef69049" }, { "id":"87ab093e5af39247", "title":"'79", "url":"http://api.teosto.fi/2017/work?id=87ab093e5af39247" }, ... ], "response_meta":{ ... } }
  • /work?id={workID}

    Get the basic info and URLs for more information about specific work.

    Reguired parameters
    • id Identifies one specific work.
    Example request:
    http://api.teosto.fi/2017/work?id=86a209385bf39246
    Example response:
    { "work":{ "id":"86a209385bf39246", "title":"PARATIISI", "ISWC":"", "authors":[ { "role":{ "titleAbbr":"A", "title":"Author", "url":"http://api.teosto.fi/2017/role?titleAbbr=A" }, "author":{ "id":"85ab0d3f58f995", "firstname":"ARJA RIITTA HANNELE", "lastname":"TIAINEN", "url":"http://api.teosto.fi/2017/author?id=85ab0d3f58f995" } }, ... ], "shows":{ "url":"http://api.teosto.fi/2017/work?id=86a209385bf39246&method=shows", "count":1033 }, "topMunicipalities":{ "url":"http://api.teosto.fi/2017/work?id=86a209385bf39246&method=topMunicipalities" }, "topVenues":{ "url":"http://api.teosto.fi/2017/work?id=86a209385bf39246&method=topVenues" } } }
  • /work?id={workID}&method=shows

    List of shows where one specific work was performed.

    Reguired parameters
    • id Identifies one specific work.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/work?id=86a209385bf39246&method=shows
    Example response:
    { "shows":[ { "id":"85a20d3852f5", "event":{ "id":"85a70d315ff095", "name":"KEVÄT 2017", "startDate":"2017-01-10", "endDate":"2017-06-30", "url":"http://api.teosto.fi/2017/event?id=85a70d315ff095" }, "url":"http://api.teosto.fi/2017/show?id=85a20d3852f5" }, ... ], "work":{ "id":"86a209385bf39246", "title":"PARATIISI", "url":"http://api.teosto.fi/2017/work?id=86a209385bf39246" }, "response_meta":{ ... } }
  • /work?id={workID}&method=topMunicipalities

    List of top municipalities where one specific work has been performed the most.

    Reguired parameters
    • id Identifies one specific work.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/work?id=86a209385bf39246&method=topMunicipalities
    Example response:
    { "topMunicipalities":[ { "municipality":{ "name":"LAIVAT", "url":"http://api.teosto.fi/2017/municipality?name=LAIVAT" }, "count":187 }, { "municipality":{ "name":"HELSINKI", "url":"http://api.teosto.fi/2017/municipality?name=HELSINKI" }, "count":50 }, ... ], "work":{ "id":"86a209385bf39246", "title":"PARATIISI", "url":"http://api.teosto.fi/2017/work?id=86a209385bf39246" }, "response_meta":{ ... } }
  • /work?id={workID}&method=topVenues

    List of top venues where one specific work has been performed the most.

    Reguired parameters
    • id Identifies one specific work.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/work?id=86a209385bf39246&method=topVenues
    Example response:
    { "topVenues":[ { "venue":{ "id":"85a30b3a52", "name":"M/S FINLANDIA", "url":"http://api.teosto.fi/2017/venue?id=85a30b3a52" }, "count":53 },{ "venue":{ "id":"85a2093b", "name":"M/S BALTIC PRINCESS", "url":"http://api.teosto.fi/2017/venue?id=85a2093b" }, "count":41 }, ... ], "work":{ "id":"86a209385bf39246", "title":"PARATIISI", "url":"http://api.teosto.fi/2017/work?id=86a209385bf39246" }, "response_meta":{ ... } }
  • /work?title={workName}

    You can search for a work by title using this method. Use + as a word seperator.

    Reguired parameters
    • title String to search for.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/work?title=joulu
    Example response:
    { "works":[ { "id":"86aa0d3b5ff99246", "title":"AIKUISTEN MIESTEN JOULU", "url":"http://api.teosto.fi/2017/work?id=86aa0d3b5ff99246" }, { "id":"86aa083c58f1954a", "title":"AJATON JOULU", "url":"http://api.teosto.fi/2017/work?id=86aa083c58f1954a" }, ... ], "response_meta":{ ... } }

Author

An author resource is one person who has participated in producing a work.

Example request:
http://api.teosto.fi/2017/author?id=85a20c3e5af69c
Example response:
{ "author":{ "id":"85a20c3e5af69c", "firstname":"ELVIS AARON", "lastname":"PRESLEY", "works":{ "url":"http://api.teosto.fi/2017/author?id=85a20c3e5af69c&method=works", "count":11 }, "topWorks":{ "url":"http://api.teosto.fi/2017/author?id=85a20c3e5af69c&method=topWorks" }, "topVenues":{ "url":"http://api.teosto.fi/2017/author?id=85a20c3e5af69c&method=topVenues" } } }

Methods

  • /author

    List of all author resources.

    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/author
    Example response:
    { "authors":[ { "id":"86a7003c53f097", "firstname":"", "lastname":"1000 LIGHTS MUSIC LIMITED", "url":"http://api.teosto.fi/2017/author?id=86a7003c53f097" }, { "id":"87aa0d3e5cf694", "firstname":"", "lastname":"119 SONGS", "url":"http://api.teosto.fi/2017/author?id=87aa0d3e5cf694" }, ... ], "response_meta":{ ... } }
  • /author?id={authorID}

    Get the basic info and URLs for more information about one specific author.

    Reguired parameters
    • id Identifies one specific author.
    Example request:
    http://api.teosto.fi/2017/author?id=85a20c3e5af69c
    Example response:
    { "author":{ "id":"85a20c3e5af69c", "firstname":"ELVIS AARON", "lastname":"PRESLEY", "works":{ "url":"http://api.teosto.fi/2017/author?id=85a20c3e5af69c&method=works", "count":11 }, "topWorks":{ "url":"http://api.teosto.fi/2017/author?id=85a20c3e5af69c&method=topWorks" }, "topVenues":{ "url":"http://api.teosto.fi/2017/author?id=85a20c3e5af69c&method=topVenues" } } }
  • /author?id={authorID}&method=works

    List of all the works from one specific author.

    Reguired parameters
    • id Identifies one specific author.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/author?id=85a20c3e5af69c&method=works
    Example response:
    { "works":[ { "id":"85aa013c5bf6", "title":"AMAZING GRACE", "url":"http://api.teosto.fi/2017/work?id=85aa013c5bf6" }, { "id":"85a4003a5af494", "title":"DON'T BE CRUEL", "url":"http://api.teosto.fi/2017/work?id=85a4003a5af494" }, ... ], "author":{ "id":"85a20c3e5af69c", "firstname":"ELVIS AARON", "lastname":"PRESLEY", "url":"http://api.teosto.fi/2017/author?id=85a20c3e5af69c" }, "response_meta":{ ... } }
  • /author?id={authorID}&method=topWorks

    List of top works from one specific author.

    Reguired parameters
    • id Identifies one specific author.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/author?id=85a20c3e5af69c&method=topWorks
    Example response:
    { "topWorks":[ { "work":{ "id":"86a6083c53f792", "title":"MELKEIN HALVAANNUIN", "url":"http://api.teosto.fi/2017/work?id=86a6083c53f792" }, "count":96 }, ... ], "author":{ "id":"85a20c3e5af69c", "firstname":"ELVIS AARON", "lastname":"PRESLEY", "url":"http://api.teosto.fi/2017/author?id=85a20c3e5af69c" }, "response_meta":{ ... } }
  • /author?id={authorID}&method=topVenues

    List of top venues where one specific author has been played.

    Reguired parameters
    • id Identifies one specific author.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/author?id=85a20c3e5af69c&method=topVenues
    Example response:
    { "topVenues":[ { "venue":{ "id":"85a2093b", "name":"M/S BALTIC PRINCESS", "url":"http://api.teosto.fi/2017/venue?id=85a2093b" }, "count":7 }, { "venue":{ "id":"85a30b3e5f", "name":"M/S VIKING GRACE", "url":"http://api.teosto.fi/2017/venue?id=85a30b3e5f" }, "count":7 }, ... ], "author":{ "id":"85a20c3e5af69c", "firstname":"ELVIS AARON", "lastname":"PRESLEY", "url":"http://api.teosto.fi/2017/author?id=85a20c3e5af69c" }, "response_meta":{ ... } }

Role

A role resource is one of the roles authors have when creating a work. These include for example authors, composers and arrangers.

Example request:
http://api.teosto.fi/2017/role?titleAbbr=C
Example response:
{ "role":{ "titleAbbr":"C", "title":"Composer", "description":"Composer", "topAuthors":{ "url":"http://api.teosto.fi/2017/role?titleAbbr=C&method=topAuthors" } } }

Methods

  • /role

    Get a list of all the roles.

    Example request:
    http://api.teosto.fi/2017/role
    Example response:
    { "roles":[ { "titleAbbr":"A", "title":"Author", "url":"http://api.teosto.fi/2017/role?titleAbbr=A" }, ... ], "response_meta":{ ... } }
  • /role?titleAbbr={titleAbbr}

    Get info and URLs for more information about one specific role.

    Reguired parameters
    • titleAbbr Abbreviation of the role title. Specifies what role to request.
    Example request:
    http://api.teosto.fi/2017/role?titleAbbr=C
    Example response:
    { "role":{ "titleAbbr":"C", "title":"Composer", "description":"Composer", "topAuthors":{ "url":"http://api.teosto.fi/2017/role?titleAbbr=C&method=topAuthors" } } }
  • /role?titleAbbr={titleAbbr}&method=topAuthors

    Top most played authors in this role.

    Reguired parameters
    • titleAbbr Abbreviation of the role title. Specifies what role to request.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/role?titleAbbr=C&method=topAuthors
    Example response:
    { "topAuthors":[ { "author":{ "id":"86a7093b59f193", "firstname":"", "lastname":"DP", "url":"http://api.teosto.fi/2017/author?id=86a7093b59f193" }, "count":12920 }, ... ], "role":{ "titleAbbr":"C", "title":"Composer", "url":"http://api.teosto.fi/2017/role?titleAbbr=C" }, "response_meta":{ ... } }

Date

Date resource gives you information about the events and what date they were happening. There are a few methods here to help you find what events there were in whichever day.

Note that if the event has a different start and end date, the API uses the start date. For example the response for a Date request will be events that start on the specific date.

Example request:
http://api.teosto.fi/2017/date?date=2017-06-28
Example response:
{ "date":{ "date": "2017-06-28", "eventCount": 104, "startDate": { "url": "http://api.teosto.fi/2017/date?startDate=2017-06-28", "count": 104 }, "month": { "url": "http://api.teosto.fi/2017/date?month=6", "count": 3839 }, "weekday": { "url": "http://api.teosto.fi/2017/date?weekday=4", "count": 4854 } } }

Methods

  • /date

    List of all dates that have an event. Note that if the event has a different start and end date, the API uses the start date. For example the request result for a Date request will be events that start on the specific date.

    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/date
    Example response:
    { "dates":[ { "date":"2017-01-01", "eventCount":93, "url":"http://api.teosto.fi/2017/date?date=2017-01-01" }, { "date":"2017-01-02", "eventCount":10, "url":"http://api.teosto.fi/2017/date?date=2017-01-02" }, ... ], "response_meta":{ ... } }
  • /date?date={yyyy-mm-dd}

    Basic info and URLs for more information about the specific date.

    Reguired parameters
    • date Specifies what date to request.
    Example request:
    http://api.teosto.fi/2017/date?date=2017-06-28
    Example response:
    { "date":{ "date": "2017-06-28", "eventCount": 104, "startDate": { "url": "http://api.teosto.fi/2017/date?startDate=2017-06-28", "count": 104 }, "month": { "url": "http://api.teosto.fi/2017/date?month=6", "count": 3839 }, "weekday": { "url": "http://api.teosto.fi/2017/date?weekday=4", "count": 4854 } } }
  • /date?startDate={yyyy-mm-dd}

    List of events that start on this date.

    Reguired parameters
    • startDate Specifies what date to request.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/date?startDate=2017-06-28
    Example response:
    { "events":[ { "id":"85a70c3d5ff793", "name":"", "startDate":"2017-06-28", "endDate":"2017-06-28", "url":"http://api.teosto.fi/2017/event?id=85a70c3d5ff793" }, { "id":"85a70c3f5ef296", "name":"", "startDate":"2017-06-28", "endDate":"2017-06-28", "url":"http://api.teosto.fi/2017/event?id=85a70c3f5ef296" }, ... ], "response_meta":{ ... } }
  • /date?month={monthNumber}

    List of events in this month.

    Reguired parameters
    • month Specifies what month to request.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/date?month=6
    Example response:
    { "events":[ { "id":"85a70c3058f294", "name":"", "startDate":"2017-06-01", "endDate":"2017-06-01", "url":"http://api.teosto.fi/2017/event?id=85a70c3058f294" }, { "id":"85a70d3c5bf496", "name":"", "startDate":"2017-06-01", "endDate":"2017-06-01", "url":"http://api.teosto.fi/2017/event?id=85a70d3c5bf496" }, ... ], "response_meta":{ ... } }
  • /date?weekday={weekdayNumber}

    List of events on one specific weekday. The weekdays are queried by number so 1 equals Monday, 2 Tuesday and so on.

    Reguired parameters
    • weekday Specifies what weekday to request.
    Optional parameters
    • page What page of the list to request.
    • limit How many objects to show on one page.
    Example request:
    http://api.teosto.fi/2017/date?weekday=6
    Example response:
    { "events":[ { "id":"85a709315ef695", "name":"", "startDate":"2017-01-06", "endDate":"2017-01-06", "url":"http://api.teosto.fi/2017/event?id=85a709315ef695" }, { "id":"85a70a3c58f196", "name":"", "startDate":"2017-01-06", "endDate":"2017-01-06", "url":"http://api.teosto.fi/2017/event?id=85a70a3c58f196" }, ... ], "response_meta":{ ... } }