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
https://api.hel.fi/linkedevents/v1/keyword/?format=api&page=2", "previous": null }, "data": [ { "id": "yso:p4354", "alt_labels": [ "barn", "imeväisikäiset", "lapset", "spädbarn" ], "created_time": "2014-06-23T11:37:27.705000Z", "last_modified_time": "2017-09-06T05:20:47.061426Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 100932, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "lapset (ikäryhmät)", "sv": "barn (åldersgrupper)", "en": "children (age groups)" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p4354/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11617", "alt_labels": [ "nuoriso", "unga" ], "created_time": "2014-06-23T11:37:27.563000Z", "last_modified_time": "2017-09-06T05:20:59.293091Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 75525, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "nuoret", "sv": "ungdomar", "en": "young people" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p11617/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16485", "alt_labels": [ "peruskoululaiset" ], "created_time": "2014-06-23T11:37:26.180000Z", "last_modified_time": "2017-09-06T05:20:45.137409Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 57682, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "koululaiset", "sv": "skolelever", "en": "pupils" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p16485/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p13050", "alt_labels": [], "created_time": "2014-06-23T11:37:23.969000Z", "last_modified_time": "2017-09-06T05:20:32.944169Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 53439, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "lapsiperheet", "sv": "barnfamiljer", "en": "families with children" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p13050/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2433", "alt_labels": [ "ikä-ihmiset", "ikäihmiset", "gamlingar", "seniorer", "gamla", "äldre människor", "äldre personer", "vanhukset", "seniorit", "iäkkäät", "åldringar", "elderly", "older adults", "old people", "senior citizens" ], "created_time": "2014-06-23T11:37:26.251000Z", "last_modified_time": "2022-05-11T01:40:15.150990Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 49214, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ikääntyneet", "sv": "äldre", "en": "older people" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p2433/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p916", "alt_labels": [ "motionering", "liikuntakäyttäytyminen", "motion (gymnastik)", "liikkuminen (liikunta)", "motion (idrott)" ], "created_time": "2014-06-23T11:37:27.126000Z", "last_modified_time": "2019-05-15T05:20:08.902393Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 44716, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "liikunta", "sv": "motion", "en": "physical training" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p916/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p1808", "alt_labels": [ "musiikki", "säveltaide", "musikkonst", "tonkonst" ], "created_time": "2014-06-23T11:37:28.044000Z", "last_modified_time": "2017-09-06T05:20:22.016421Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 41225, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "musiikki", "sv": "musik", "en": "music" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p1808/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p9270", "alt_labels": [], "created_time": "2014-06-23T11:37:26.899000Z", "last_modified_time": "2017-09-06T05:19:59.267957Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 38983, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "kurssit", "sv": "kurser", "en": "courses (societal objects)" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p9270/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p4363", "alt_labels": [ "ydinperheet", "familj", "perhe", "familjer (grupper)", "kärnfamiljer" ], "created_time": "2014-06-23T11:37:28.246000Z", "last_modified_time": "2019-05-11T04:20:04.577893Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 32336, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "perheet", "sv": "familjer", "en": "families" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p4363/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p360", "alt_labels": [], "created_time": "2014-06-23T11:37:29.198000Z", "last_modified_time": "2017-09-06T05:20:25.832872Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 30634, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "kulttuuritapahtumat", "sv": "kulturevenemang", "en": "cultural events" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p360/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p6165", "alt_labels": [ "immigrantit", "immigranter" ], "created_time": "2014-06-23T11:37:28.630000Z", "last_modified_time": "2023-08-31T04:47:47.500809Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 28951, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "maahanmuuttajat", "sv": "invandrare", "en": "immigrants" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p6165/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2149", "alt_labels": [ "opastukset", "opastaminen", "vägledning" ], "created_time": "2014-06-23T11:37:25.994000Z", "last_modified_time": "2017-09-06T05:21:07.924133Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 27372, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "opastus", "sv": "guidning", "en": "guidance" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p2149/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p316", "alt_labels": [ "leken", "lek (barnlek)", "lek", "lek (mental aktivitet)", "barnlek", "leikki (leikkiminen)", "leikki" ], "created_time": "2014-06-23T11:37:26.834000Z", "last_modified_time": "2019-05-08T04:19:51.933927Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 25892, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "leikkiminen", "sv": "lek (aktivitet)", "en": "playing (children's games)" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p316/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2625", "alt_labels": [ "teatteritaide", "teatteri", "näyttämötaide", "scenkonst", "teaterkonst", "teater", "dramatic art", "teatteri (taiteet)", "teater (konstarter)", "puheteatteri", "talteater", "theater" ], "created_time": "2014-06-23T11:37:27.748000Z", "last_modified_time": "2023-08-31T04:47:51.550713Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 24976, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "teatteritaide", "sv": "teaterkonst", "en": "theatre (art forms)" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p2625/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10727", "alt_labels": [ "kansalaisosallistuminen", "kansalaisten osallistuminen", "kansalaisaktivismi", "medborgaraktivism", "medborgarinflytande", "medborgardeltagande", "engagemang" ], "created_time": "2014-06-23T11:37:28.213000Z", "last_modified_time": "2017-09-06T05:20:57.830630Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 22589, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "osallistuminen", "sv": "deltagande", "en": "participation" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p10727/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p6062", "alt_labels": [ "spel (objekt)" ], "created_time": "2014-06-23T11:37:24.440000Z", "last_modified_time": "2017-09-06T05:20:54.945885Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 21920, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "pelit", "sv": "spel", "en": "games" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p6062/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p14004", "alt_labels": [ "diskussion" ], "created_time": "2014-06-23T11:37:27.886000Z", "last_modified_time": "2017-09-06T05:20:58.680345Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 21031, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "keskustelu", "sv": "samtal", "en": "conversation" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p14004/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p8105", "alt_labels": [ "leikkikentät" ], "created_time": "2014-06-23T11:37:28.731000Z", "last_modified_time": "2017-09-06T05:21:10.313676Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 18303, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "leikkipuistot", "sv": "lekparker", "en": "playgrounds" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p8105/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p1278", "alt_labels": [ "tanssitaide", "tanssi", "danskonst", "tanssit", "danser" ], "created_time": "2014-06-23T11:37:28.946000Z", "last_modified_time": "2017-09-06T05:20:51.217975Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 18259, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "tanssi", "sv": "dans", "en": "dance (performing arts)" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p1278/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p1947", "alt_labels": [ "hyvinvointi (taloudellinen)", "hyvinvointi (aineellinen)", "prosperity", "welfare (well-being)" ], "created_time": "2014-06-23T11:37:23.778000Z", "last_modified_time": "2019-05-16T05:20:11.428706Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 17469, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "hyvinvointi", "sv": "välfärd", "en": "well-being" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p1947/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 3389, "next": "