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 /v1/keyword/?format=api&page=15&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=16&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=14&show_all_keywords=True" }, "data": [ { "id": "yso:p16239", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:39.866676Z", "last_modified_time": "2023-08-16T05:05:39.866695Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aamu", "sv": "morgon", "en": "morning" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16239/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3522", "has_user_editable_resources": false, "alt_labels": [ "aamupäiväkerhot", "ap-toiminta", "förmiddagsaktivitet", "förmiddagsverksamhet" ], "created_time": "2023-08-16T05:17:05.378331Z", "last_modified_time": "2023-08-16T05:17:05.378360Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aamupäivätoiminta", "sv": "morgonverksamhet", "en": "morning activities" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3522/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29142", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:11:16.112641Z", "last_modified_time": "2023-08-16T05:11:16.112659Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aamutakit", "sv": "morgonrockar", "en": "robes" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29142/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p17093", "has_user_editable_resources": false, "alt_labels": [ "strängmyrar" ], "created_time": "2023-08-16T05:16:45.296871Z", "last_modified_time": "2023-08-16T05:16:45.296889Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aapasuot", "sv": "aapamyrar", "en": "aapa mires" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17093/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p17439", "has_user_editable_resources": false, "alt_labels": [ "ABC-böcker" ], "created_time": "2023-08-16T05:09:33.020058Z", "last_modified_time": "2023-08-16T05:09:33.020077Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aapiset", "sv": "abc-böcker", "en": "alphabet books" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17439/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p14604", "has_user_editable_resources": false, "alt_labels": [ "ariettat", "ariettor" ], "created_time": "2023-08-16T05:16:41.257244Z", "last_modified_time": "2023-08-16T05:16:41.257310Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aariat", "sv": "arior", "en": "arias" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14604/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3620", "has_user_editable_resources": false, "alt_labels": [ "naturskogsreservat", "ödemarksreservat" ], "created_time": "2023-08-16T05:17:51.095800Z", "last_modified_time": "2023-08-16T05:17:51.095818Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aarnialueet", "sv": "urskogsområden", "en": "primeval forest areas" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3620/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38077", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:11:34.063802Z", "last_modified_time": "2023-08-16T05:11:34.063827Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Aarnikotkan metsän luonnonsuojelualue", "sv": "Aarnikotka skogs naturskyddsområde", "en": "Aarnikotka Nature Reserve" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38077/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p6351", "has_user_editable_resources": false, "alt_labels": [ "griipit" ], "created_time": "2023-08-16T05:08:21.333435Z", "last_modified_time": "2023-08-16T05:08:21.333454Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aarnikotkat", "sv": "gripar", "en": "griffins" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6351/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3622", "has_user_editable_resources": false, "alt_labels": [ "virgin forests", "aarnimetsät" ], "created_time": "2023-08-16T05:18:40.404746Z", "last_modified_time": "2023-08-16T05:18:40.404764Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aarniometsät", "sv": "urskogar", "en": "primeval forests" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3622/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10416", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:14:57.016660Z", "last_modified_time": "2023-08-16T05:14:57.016676Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aarrelöydöt", "sv": "skattfynd", "en": "treasure finds" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10416/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p13888", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:43.848820Z", "last_modified_time": "2023-08-16T05:12:43.848837Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aarteet", "sv": "skatter (dyrgripar)", "en": "treasures" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13888/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21825", "has_user_editable_resources": false, "alt_labels": [ "asiat-amerikansk litteratur" ], "created_time": "2023-08-16T05:10:11.947112Z", "last_modified_time": "2023-08-16T05:10:11.947142Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aasialaisamerikkalainen kirjallisuus", "sv": "asiatisk-amerikansk litteratur", "en": "Asian American literature" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21825/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3255", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:19:47.570698Z", "last_modified_time": "2023-08-16T05:19:47.570717Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aasialaiset", "sv": "asiater", "en": "Asians" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3255/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p18194", "has_user_editable_resources": false, "alt_labels": [ "Eastern culture", "itämainen kulttuuri", "orientalisk kultur", "österländsk kultur" ], "created_time": "2023-08-16T05:09:39.536539Z", "last_modified_time": "2023-08-16T05:09:39.536558Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aasialaiset kulttuurit", "sv": "asiatiska kulturer", "en": "Asian cultures" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18194/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39725", "has_user_editable_resources": false, "alt_labels": [ "Asiatic elephant", "Elephas maximus", "intiannorsu", "indisk elefant" ], "created_time": "2023-08-16T05:08:09.081509Z", "last_modified_time": "2023-08-16T05:08:09.081528Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aasiannorsu", "sv": "asiatisk elefant", "en": "Asian elephant" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39725/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p37907", "has_user_editable_resources": false, "alt_labels": [ "Anoplophora glabripennis", "Anoplophora glabripennis" ], "created_time": "2023-08-16T05:11:32.657462Z", "last_modified_time": "2023-08-16T05:11:32.657481Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aasianrunkojäärä", "sv": "asiatisk långhorning", "en": "Asian longhorned beetle" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p37907/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p040802", "has_user_editable_resources": false, "alt_labels": [ "Acrocodia indica", "Asian tapir", "Tapirus indicus", "Tapirus indicus", "intiantapiiri", "asiatisk tapir", "indisk tapir" ], "created_time": "2025-07-01T04:39:47.722855Z", "last_modified_time": "2025-07-01T04:39:47.722865Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aasiantapiiri", "sv": "schabraktapir", "en": "Malayan tapir" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p040802/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15050", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:09:13.706643Z", "last_modified_time": "2023-08-16T05:09:13.706662Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aasit", "sv": "åsnor", "en": "donkeys" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15050/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p32610", "has_user_editable_resources": false, "alt_labels": [ "aatenäytelmät" ], "created_time": "2023-08-16T05:14:09.317907Z", "last_modified_time": "2023-08-16T05:14:09.317924Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aatedraamat", "sv": "idédramer", "en": "problem plays" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p32610/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "