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=3
http://api.hel.fi/linkedevents/v1/keyword/?format=api&page=4", "previous": "http://api.hel.fi/linkedevents/v1/keyword/?format=api&page=2" }, "data": [ { "id": "yso:p1235", "alt_labels": [ "spelfilmer", "motion pictures", "movies" ], "created_time": "2014-06-23T11:37:28.320000Z", "last_modified_time": "2018-07-05T02:20:10.277160Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 5597, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "elokuvat", "sv": "filmer", "en": "films" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p1235/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p26626", "alt_labels": [ "distansdeltagande" ], "created_time": "2014-06-23T11:37:26.586000Z", "last_modified_time": "2017-09-06T05:20:15.235148Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 4595, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "etäosallistuminen", "sv": "deltagande på distans", "en": "remote participation" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p26626/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p7643", "alt_labels": [], "created_time": "2014-06-23T11:37:26.382000Z", "last_modified_time": "2017-09-06T05:20:04.372992Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 4162, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "venäjän kieli", "sv": "ryska", "en": "Russian language" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p7643/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15875", "alt_labels": [], "created_time": "2014-06-23T11:37:27.098000Z", "last_modified_time": "2017-09-06T05:20:18.842933Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 4146, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "luennot", "sv": "föreläsningar", "en": "lectures" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p15875/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2850", "alt_labels": [ "scenkonst", "uppträdande konst" ], "created_time": "2014-06-23T11:37:30.702000Z", "last_modified_time": "2017-09-06T05:20:56.019040Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 4051, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "esittävät taiteet", "sv": "scenisk konst", "en": "performing arts" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p2850/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3670", "alt_labels": [ "ruoat" ], "created_time": "2014-06-23T11:37:27.735000Z", "last_modified_time": "2019-04-09T04:20:01.129780Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 3754, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ruoka", "sv": "mat", "en": "food" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p3670/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p8630", "alt_labels": [ "käden taidot", "handens skicklighet" ], "created_time": "2014-06-23T11:37:29.869000Z", "last_modified_time": "2017-09-06T05:20:45.028878Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 3337, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "kädentaidot", "sv": "händighet", "en": "craft skills" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p8630/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p7708", "alt_labels": [], "created_time": "2014-06-23T11:37:30.374000Z", "last_modified_time": "2017-09-06T05:20:41.675524Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 3253, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "työttömät", "sv": "arbetslösa", "en": "unemployed people" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p7708/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p6889", "alt_labels": [], "created_time": "2014-06-23T11:37:29.024000Z", "last_modified_time": "2017-09-06T05:20:19.636550Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 3231, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "taidenäyttelyt", "sv": "konstutställningar", "en": "art exhibitions" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p6889/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16327", "alt_labels": [ "spelfilm", "film (konstarter)", "elokuva (taiteet)", "elokuva" ], "created_time": "2014-06-23T11:37:25.176000Z", "last_modified_time": "2018-10-10T05:22:32.732532Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 3174, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "elokuvataide", "sv": "filmkonst", "en": "cinema (art forms)" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p16327/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2787", "alt_labels": [], "created_time": "2014-06-23T11:37:30.594000Z", "last_modified_time": "2017-09-06T05:21:04.564275Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 2937, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "kirjastot", "sv": "bibliotek", "en": "libraries" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p2787/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3093", "alt_labels": [ "soveltava liikunta", "specialmotion", "specialgymnastik" ], "created_time": "2014-06-23T11:37:27.510000Z", "last_modified_time": "2017-11-10T05:20:09.812490Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 2792, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "erityisliikunta", "sv": "specialidrott", "en": "adapted physical activity" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p3093/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15937", "alt_labels": [ "imeväisikäiset", "spädbarn", "bebisar", "infants" ], "created_time": "2014-06-23T11:37:27.437000Z", "last_modified_time": "2017-09-06T05:20:47.053954Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 2602, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vauvat", "sv": "babyer", "en": "babies" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p15937/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p27962", "alt_labels": [ "livemusik", "livemusiikki" ], "created_time": "2017-02-06T16:25:21.725113Z", "last_modified_time": "2017-09-06T05:20:21.124949Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 2387, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "elävä musiikki", "sv": "levande musik", "en": "live music" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p27962/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5201", "alt_labels": [], "created_time": "2014-06-23T11:37:28.823000Z", "last_modified_time": "2017-09-06T05:20:37.979684Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 2380, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "perheliikunta", "sv": "familjemotion", "en": "family sports" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p5201/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2445", "alt_labels": [ "massamedia" ], "created_time": "2014-06-23T11:37:27.049000Z", "last_modified_time": "2017-09-06T05:20:03.713128Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 2354, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "media", "sv": "media", "en": "media" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p2445/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p13035", "alt_labels": [ "liikuntakäyttäytyminen" ], "created_time": "2014-06-23T11:37:29.531000Z", "last_modified_time": "2017-09-06T05:20:49.572836Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 2179, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "liikuntaharrastus", "sv": "fritidsmotion", "en": "physical hobbies" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p13035/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p13084", "alt_labels": [ "natur" ], "created_time": "2014-06-23T11:37:30.351000Z", "last_modified_time": "2017-09-06T05:20:18.876324Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 2139, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "luonto", "sv": "naturen", "en": "nature" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p13084/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p18434", "alt_labels": [ "konserttimusiikki", "seriös musik", "konsertmusik", "vakava musiikki", "klassisk musik", "klassinen musiikki", "länsimainen taidemusiikki", "Western classical music", "Western art music", "västerländsk konstmusik" ], "created_time": "2014-06-23T11:37:27.651000Z", "last_modified_time": "2017-09-06T05:21:06.970863Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 2059, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "taidemusiikki", "sv": "konstmusik", "en": "art music" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p18434/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p143", "alt_labels": [], "created_time": "2014-06-23T11:37:26.679000Z", "last_modified_time": "2017-09-06T05:20:32.423267Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 1901, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "leirit", "sv": "läger", "en": "camps" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p143/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 3466, "next": "