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=104&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=105&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=103&show_all_keywords=True" }, "data": [ { "id": "yso:p5235", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:14:31.712283Z", "last_modified_time": "2023-08-16T05:14:31.712313Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ayurveda", "en": "ayurveda" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5235/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p26212", "has_user_editable_resources": false, "alt_labels": [ "azeriska" ], "created_time": "2023-08-16T05:07:11.630184Z", "last_modified_time": "2023-08-16T05:07:11.630202Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "azerin kieli", "sv": "azerbajdzjanska", "en": "Azerbaijani language" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26212/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29297", "has_user_editable_resources": false, "alt_labels": [ "azerbajdzjansk litteratur" ], "created_time": "2023-08-16T05:11:18.503574Z", "last_modified_time": "2023-08-16T05:11:18.503593Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "azerinkielinen kirjallisuus", "sv": "litteratur på azerbajdzjanska", "en": "Azerbaijani language literature" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29297/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29464", "has_user_editable_resources": false, "alt_labels": [ "Azeri Turks", "Azeris", "azerbajdzjanier", "azerer" ], "created_time": "2023-08-16T05:07:39.499739Z", "last_modified_time": "2023-08-16T05:07:39.499758Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "azerit", "sv": "azerbajdzjaner", "en": "Azerbaijanis" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29464/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p25575", "has_user_editable_resources": false, "alt_labels": [ "syanokobalamiini", "B12-vitamin", "kobalamin" ], "created_time": "2023-08-16T05:15:41.329750Z", "last_modified_time": "2023-08-16T05:15:41.329781Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "B12-vitamiini", "sv": "vitamin B12", "en": "vitamin B12" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25575/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12869", "has_user_editable_resources": false, "alt_labels": [ "pyridoksiini", "pyridoxin", "vitamin B6" ], "created_time": "2023-08-16T05:15:06.452747Z", "last_modified_time": "2023-08-16T05:15:06.452764Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "B6-vitamiini", "sv": "B6-vitamin", "en": "vitamin B6" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12869/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p28305", "has_user_editable_resources": false, "alt_labels": [ "babilaisuus" ], "created_time": "2023-08-16T05:11:09.355552Z", "last_modified_time": "2023-08-16T05:11:09.355570Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "baabilaisuus", "sv": "babism", "en": "Babism" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28305/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15888", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:37.360798Z", "last_modified_time": "2023-08-16T05:05:37.360817Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "baarimestarit", "sv": "barmästare", "en": "bartenders" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15888/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p7057", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:18:00.104576Z", "last_modified_time": "2023-08-16T05:18:00.104602Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "baarit", "sv": "barer", "en": "bars (eating and drinking establishments)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7057/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p040810", "has_user_editable_resources": false, "alt_labels": [ "Babyrousa babyrussa", "deer-pig", "Babyrousa babyrussa", "hirvisika", "babirusa" ], "created_time": "2025-07-01T04:39:47.844340Z", "last_modified_time": "2025-07-01T04:39:47.844353Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "babirussa", "sv": "hjortsvin", "en": "babirusa" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p040810/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p18307", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:59.179966Z", "last_modified_time": "2023-08-16T05:05:59.179987Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "babylonialaiset", "sv": "babylonier", "en": "Babylonians" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18307/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p17670", "has_user_editable_resources": false, "alt_labels": [ "Bach-kukkaterapia", "kukkaisterapia", "kukkaterapia", "Bachs blomstermedel", "Bachs blomstermedicin" ], "created_time": "2023-08-16T05:05:53.178568Z", "last_modified_time": "2023-08-16T05:05:53.178587Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Bachin kukkaterapia", "sv": "Bachs blomsterterapi", "en": "Bach flower therapy" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17670/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p20898", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:17:41.163076Z", "last_modified_time": "2023-08-16T05:17:41.163094Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Bacillus-bakteerit", "sv": "Bacillusbakterier", "en": "Bacillus bacteria" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20898/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21397", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:08.192375Z", "last_modified_time": "2023-08-16T05:10:08.192393Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Bacillus cereus", "en": "Bacillus cereus" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21397/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21400", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:08.270502Z", "last_modified_time": "2023-08-16T05:10:08.270529Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Bacillus mojavensis", "en": "Bacillus mojavensis" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21400/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21399", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:08.247142Z", "last_modified_time": "2023-08-16T05:10:08.247160Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Bacillus subtilis", "en": "Bacillus subtilis" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21399/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p20897", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:04.022446Z", "last_modified_time": "2023-08-16T05:10:04.022466Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Bacillus thuringiensis", "en": "Bacillus thuringiensis" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20897/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p20474", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:23.758502Z", "last_modified_time": "2023-08-16T05:06:23.758521Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Backas", "sv": "Backas gård", "en": "Backas manor" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20474/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38512", "has_user_editable_resources": false, "alt_labels": [ "sokeriruokojäte", "bagasse" ], "created_time": "2023-08-16T05:14:15.763946Z", "last_modified_time": "2023-08-16T05:14:15.763964Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bagassi", "sv": "bagass", "en": "bagasse" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38512/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p30015", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:11:25.294073Z", "last_modified_time": "2023-08-16T05:11:25.294110Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bagatellit", "sv": "bagateller (kompositioner)", "en": "bagatelles" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30015/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31684, "next": "