Keyword List List
Using the keyword endpoint
Here, categories for events are listed. Events in each category can be found at the
event
endpoint using the query parameter keyword
. The common keywords
used in all events originate from the general Finnish ontology (yso),
hence the format yso:p4354
. Default ordering is decreasing order by the number of events found.
The most common event categories are listed in the two keyword sets helsinki:topics and helsinki:audiences, which list the YSO keywords that are present in most events to specify event main topic and audience.
Keyword text
To find keywords that contain a specific string, use the query parameter text
.
Example:
keyword/?text=lapset
Free text
While the previous search is looking for the keywords containg exact matches of the search string,
free_text
retrieves keywords on the basis of similarity. Results are
sorted by similarity.
Example:
keyword/?free_text=lapppset
Keyword source
Will restrict keywords to a specific data source.
Example:
keyword/?data_source=yso
Show only keywords with the upcoming events
To show only the keywords which are used in the upcoming events supply the
has_upcoming_events
query parameter.
For example:
keyword/?has_upcoming_events=True
Showing all keywords
By default, only those keywords which have listed events are
displayed. You may display keywords with zero n_events
with the
query parameter show_all_keywords
.
For example:
keyword/?show_all_keywords=True
Showing deprecated keywords
By default, deprecated keywords are not displayed. You may also display deprecated keywords with the
query parameter show_deprecated
.
For example:
keyword/?show_deprecated=True
Ordering
Default ordering is decreasing order by the number of events found.
You may also order results by name
.
For example:
keyword/?sort=name
GET /linkedevents/v1/keyword/?format=api&page=2
http://api.hel.fi/linkedevents/v1/keyword/?format=api&page=3", "previous": "http://api.hel.fi/linkedevents/v1/keyword/?format=api" }, "data": [ { "id": "yso:p556", "alt_labels": [ "språk (typer)", "språk (språkvetenskap)", "kieli", "kieli (kielitiede)", "kielet", "språket" ], "created_time": "2014-06-23T11:37:23.862000Z", "last_modified_time": "2019-05-11T04:19:50.679204Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 16912, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "kieli ja kielet", "sv": "språk", "en": "languages" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p556/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p20513", "alt_labels": [], "created_time": "2014-06-23T11:37:28.599000Z", "last_modified_time": "2017-09-06T05:20:06.032620Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 15303, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vauvaperheet", "sv": "småbarnsfamiljer", "en": "families with babies" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p20513/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p18105", "alt_labels": [ "uutisryhmät", "nyhetsgrupper" ], "created_time": "2014-06-23T11:37:25.345000Z", "last_modified_time": "2017-09-06T05:20:46.419112Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 14656, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "keskusteluryhmät", "sv": "diskussionsgrupper", "en": "discussion groups" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p18105/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p7642", "alt_labels": [ "klubbar", "klubit (kerhot)", "klubbar (grupper)" ], "created_time": "2014-06-23T11:37:24.033000Z", "last_modified_time": "2017-09-06T05:20:44.657109Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 13648, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "kerhot", "sv": "klubbar (fritidsverksamhet)", "en": "clubs (recreational)" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p7642/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2108", "alt_labels": [ "evenemang", "incidents", "händelser", "evenemang och händelser" ], "created_time": "2014-06-23T11:37:28.601000Z", "last_modified_time": "2019-05-11T04:20:01.640718Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 13566, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "tapahtumat", "sv": "händelser och evenemang", "en": "events" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p2108/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2739", "alt_labels": [ "kuvaamataiteet", "kuvaamataide", "kuvataiteet" ], "created_time": "2014-06-23T11:37:24.297000Z", "last_modified_time": "2017-09-06T05:20:57.108100Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 13177, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "kuvataide", "sv": "bildkonst", "en": "fine arts" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p2739/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2851", "alt_labels": [], "created_time": "2014-06-23T11:37:30.586000Z", "last_modified_time": "2017-09-06T05:20:41.174579Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 12958, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "taide", "sv": "konst", "en": "art" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p2851/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p14710", "alt_labels": [], "created_time": "2014-06-23T11:37:28.359000Z", "last_modified_time": "2017-09-06T05:20:12.978120Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 12732, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "satutunnit", "sv": "sagotimmar", "en": "story hours" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p14710/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p8113", "alt_labels": [ "kirjallisuus", "världslitteratur", "maailmankirjallisuus" ], "created_time": "2014-06-23T11:37:28.803000Z", "last_modified_time": "2017-09-06T05:20:15.796029Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 12704, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "kirjallisuus", "sv": "litteratur", "en": "literature" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p8113/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5590", "alt_labels": [ "fullvuxna" ], "created_time": "2014-06-23T11:37:27.618000Z", "last_modified_time": "2017-09-06T05:21:07.319885Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 11923, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aikuiset", "sv": "vuxna", "en": "adults" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p5590/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16486", "alt_labels": [ "studenter (studerande)" ], "created_time": "2014-06-23T11:37:24.669000Z", "last_modified_time": "2017-09-06T05:20:12.127351Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 11550, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "opiskelijat", "sv": "studerande", "en": "students" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p16486/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5121", "alt_labels": [], "created_time": "2014-06-23T11:37:30.435000Z", "last_modified_time": "2017-09-06T05:20:59.730772Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 10588, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "näyttelyt", "sv": "utställningar", "en": "exhibitions" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p5121/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2771", "alt_labels": [], "created_time": "2014-06-23T11:37:29.558000Z", "last_modified_time": "2017-09-06T05:20:20.554713Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 9789, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ulkoilu", "sv": "friluftsliv", "en": "outdoor recreation" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p2771/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11185", "alt_labels": [ "live-konsertit", "konserter (evenemang)", "livekonserter" ], "created_time": "2014-06-23T11:37:29.533000Z", "last_modified_time": "2017-09-06T05:21:06.214861Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 8649, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "konsertit", "sv": "konserter (framträdanden)", "en": "concerts" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p11185/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p372", "alt_labels": [ "kulturformer", "kulttuurimuodot", "kultursystem", "kulttuurijärjestelmät", "kulturer", "kulttuurit" ], "created_time": "2014-06-23T11:37:23.964000Z", "last_modified_time": "2019-05-10T05:20:03.801859Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 6974, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "kulttuuri", "sv": "kultur", "en": "culture" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p372/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p272", "alt_labels": [ "organisation", "organisaatio", "organisationer (system)" ], "created_time": "2014-06-23T11:37:25.370000Z", "last_modified_time": "2018-11-17T05:20:04.980807Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 6841, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "organisaatiot", "sv": "organisationer", "en": "organisations (systems)" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p272/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p4934", "alt_labels": [ "muséer" ], "created_time": "2014-06-23T11:37:25.526000Z", "last_modified_time": "2017-09-06T05:19:58.766408Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 6538, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "museot", "sv": "museer", "en": "museums" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p4934/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11406", "alt_labels": [ "lästeknik", "lukutekniikka", "läsande" ], "created_time": "2014-06-23T11:37:25.519000Z", "last_modified_time": "2019-05-08T04:20:03.023249Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 6386, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "lukeminen", "sv": "läsning", "en": "reading" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p11406/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p965", "alt_labels": [ "sport", "damsport", "damidrott", "herridrott", "herrsport", "idrott", "idrott och sport" ], "created_time": "2014-06-23T11:37:30.287000Z", "last_modified_time": "2024-01-18T04:41:26.122560Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 5949, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "urheilu", "sv": "sport och idrott", "en": "sports" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p965/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2315", "alt_labels": [], "created_time": "2014-06-23T11:37:26.753000Z", "last_modified_time": "2017-09-06T05:20:11.898766Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 5879, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "teatteritapahtumat", "sv": "teaterfestivaler", "en": "theatre events" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p2315/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 3480, "next": "