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=57&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=58&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=56&show_all_keywords=True" }, "data": [ { "id": "yso:p22080", "has_user_editable_resources": false, "alt_labels": [ "kylpyammeet", "kar" ], "created_time": "2023-08-16T05:13:25.376234Z", "last_modified_time": "2023-08-16T05:13:25.376251Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ammeet", "sv": "badkar", "en": "bathtubs" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22080/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p1889", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:09:45.599507Z", "last_modified_time": "2023-08-16T05:09:45.599524Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ammoniakki", "sv": "ammoniak", "en": "ammonia" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1889/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p24405", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:55.543513Z", "last_modified_time": "2023-08-16T05:06:55.543530Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ammoniumnitraatti", "sv": "ammoniumnitrat", "en": "ammonium nitrate" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24405/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5857", "has_user_editable_resources": false, "alt_labels": [ "ammunition (projektiler)", "vapenprojektiler", "ammukset (laukaistavat)", "projektiilit" ], "created_time": "2023-08-16T05:17:57.700145Z", "last_modified_time": "2025-07-31T04:41:31.821445Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ammukset", "sv": "projektiler", "en": "projectiles (ammunition)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5857/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15302", "has_user_editable_resources": false, "alt_labels": [ "shooting (sport)", "ampumaurheilu", "ampuminen", "skjutning", "sportskytte" ], "created_time": "2023-08-16T05:18:11.903103Z", "last_modified_time": "2023-08-16T05:18:11.903121Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ammunta", "sv": "skytte", "en": "shooting" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15302/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p26433", "has_user_editable_resources": false, "alt_labels": [ "räiskintäpelit" ], "created_time": "2023-08-16T05:15:43.411366Z", "last_modified_time": "2023-08-16T05:15:43.411384Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ammuntapelit", "sv": "skjutspel", "en": "shooting games" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26433/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15439", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:16:42.763987Z", "last_modified_time": "2023-08-16T05:16:42.764004Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amorfiset aineet", "sv": "amorfa ämnen", "en": "amorphous substances" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15439/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39081", "has_user_editable_resources": false, "alt_labels": [ "amurrulaiset", "amoreer", "amoréer" ], "created_time": "2023-08-16T05:11:44.268760Z", "last_modified_time": "2023-08-16T05:11:44.268777Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amorilaiset", "sv": "amoriter", "en": "Amorites" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39081/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p23984", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:34.860026Z", "last_modified_time": "2023-08-16T05:13:34.860051Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Amorph!", "en": "Amorph! Festival" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23984/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16683", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:59.027618Z", "last_modified_time": "2023-08-16T05:12:59.027638Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ampiaiset", "sv": "getingar", "en": "Vespidae" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16683/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p28724", "has_user_editable_resources": false, "alt_labels": [ "Falco columbarius" ], "created_time": "2023-08-16T05:07:32.555998Z", "last_modified_time": "2023-08-16T05:07:32.556014Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ampuhaukka", "sv": "stenfalk", "en": "merlin (Falconidae)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28724/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p23616", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:49.030023Z", "last_modified_time": "2023-08-16T05:06:49.030042Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ampuma-alueet", "sv": "skjutområden", "en": "shooting zones" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23616/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11352", "has_user_editable_resources": false, "alt_labels": [ "guns (firearms)", "pyssyt", "tuliaseet", "bössor", "eldvapen" ], "created_time": "2023-08-16T05:18:08.529960Z", "last_modified_time": "2023-08-16T05:18:08.529978Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ampuma-aseet", "sv": "skjutvapen", "en": "firearms" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11352/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p23438", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:28.224869Z", "last_modified_time": "2023-08-16T05:10:28.224887Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ampuma-aselaki", "sv": "skjutvapenlag", "en": "Firearms Act" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23438/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11800", "has_user_editable_resources": false, "alt_labels": [ "biathlon", "biatlon" ], "created_time": "2023-08-16T05:08:49.727520Z", "last_modified_time": "2023-08-16T05:08:49.727548Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ampumahiihto", "sv": "skidskytte", "en": "biathlon" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11800/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p24958", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:59.264485Z", "last_modified_time": "2023-08-16T05:06:59.264503Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ampumahiihtäjät", "sv": "skidskyttar", "en": "biathlonists" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24958/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40596", "has_user_editable_resources": false, "alt_labels": [ "skytteutbildning (militär utbildning)", "firearms training (military education)" ], "created_time": "2025-01-21T04:40:53.817795Z", "last_modified_time": "2025-01-24T07:25:01.683789Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ampumakoulutus (sotilaskoulutus)", "sv": "skjututbildning (militär utbildning)", "en": "markmanship training" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40596/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5533", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:01.086297Z", "last_modified_time": "2023-08-16T05:12:01.086317Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ampumaradat", "sv": "skjutbanor", "en": "shooting ranges" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5533/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p13635", "has_user_editable_resources": false, "alt_labels": [ "ammukset (ampumatarvikkeet)", "skjuttillbehör" ], "created_time": "2023-08-16T05:12:42.481900Z", "last_modified_time": "2023-08-16T05:12:42.481918Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ampumatarvikkeet", "sv": "ammunition", "en": "ammunition" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13635/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10264", "has_user_editable_resources": false, "alt_labels": [ "ampujat", "skyttar (idrott)" ], "created_time": "2023-08-16T05:04:58.705795Z", "last_modified_time": "2023-08-16T05:04:58.705822Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ampumaurheilijat", "sv": "sportskyttar", "en": "shooters (athletes)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10264/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "