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=248&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=249&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=247&show_all_keywords=True" }, "data": [ { "id": "yso:p15274", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:31.612146Z", "last_modified_time": "2023-08-16T05:05:31.612164Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "grunge", "en": "grunge music" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15274/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39402", "has_user_editable_resources": false, "alt_labels": [ "Gruyère", "gruyerejuusto", "gruyère", "gruyère" ], "created_time": "2023-08-16T05:08:05.840420Z", "last_modified_time": "2023-08-16T05:08:05.840438Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "gruyèrejuusto", "sv": "gruyèreost", "en": "Gruyère cheese" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39402/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p4480", "has_user_editable_resources": false, "alt_labels": [ "Kalaallisut language" ], "created_time": "2023-08-16T05:08:14.533743Z", "last_modified_time": "2023-08-16T05:08:14.533760Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "grönlannin kieli", "sv": "grönländska", "en": "Greenlandic language" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4480/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29214", "has_user_editable_resources": false, "alt_labels": [ "Kalaallisut language literature", "grönländsk litteratur" ], "created_time": "2023-08-16T05:11:17.085487Z", "last_modified_time": "2023-08-16T05:11:17.085505Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "grönlanninkielinen kirjallisuus", "sv": "litteratur på grönländska", "en": "Greenlandic language literature" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29214/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10016", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:08:37.516904Z", "last_modified_time": "2023-08-16T05:08:37.516923Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "grönlantilaiset", "sv": "grönlänningar", "en": "Greenlanders" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10016/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p18432", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:00.525588Z", "last_modified_time": "2023-08-16T05:06:00.525606Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Grönqvistin talo", "sv": "Grönqvistska huset", "en": "Grönqvist house" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18432/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p18467", "has_user_editable_resources": false, "alt_labels": [ "Global System for Mobile Communications", "Global System for Mobile Communications", "Group Special Mobile", "Global System for Mobile Communications" ], "created_time": "2023-08-16T05:09:42.006615Z", "last_modified_time": "2023-08-16T05:09:42.006633Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "GSM", "en": "GSM" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18467/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40634", "has_user_editable_resources": false, "alt_labels": [ "Guahiban languages", "Guahiboan languages", "guahibo (språkfamiljer)" ], "created_time": "2025-03-27T04:40:25.415999Z", "last_modified_time": "2025-03-27T04:40:25.416013Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "guahibolaiset kielet", "sv": "guahibospråk", "en": "Guajiboan languages" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40634/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p20680", "has_user_editable_resources": false, "alt_labels": [ "Guantanamo Bay Naval Base" ], "created_time": "2023-08-16T05:13:17.300878Z", "last_modified_time": "2023-08-16T05:13:17.300896Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Guantánamo Bay", "sv": "Guantánamobasen", "en": "Guantánamo Bay" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20680/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p17171", "has_user_editable_resources": false, "alt_labels": [ "guaraanit", "guaranier" ], "created_time": "2023-08-16T05:09:30.841376Z", "last_modified_time": "2025-04-30T04:40:23.889706Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "guaranít", "sv": "guaraní", "en": "Guarani people" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17171/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p6492", "has_user_editable_resources": false, "alt_labels": [ "peitevärimaalaus", "täckfärger" ], "created_time": "2023-08-16T05:12:05.251179Z", "last_modified_time": "2023-08-16T05:12:05.251195Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "guassi", "sv": "gouache", "en": "gouache" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6492/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40653", "has_user_editable_resources": false, "alt_labels": [ "Guaycuruan languages", "Guaykuruan languages", "guaicuruspråk", "guaycuru (språkfamiljer)", "guaycurú (språkfamiljer)" ], "created_time": "2025-03-27T04:40:25.800005Z", "last_modified_time": "2025-03-27T04:40:25.800036Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "guaycurulaiset kielet", "sv": "guaicurúspråk", "en": "Guaicuruan languages" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40653/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p25436", "has_user_editable_resources": false, "alt_labels": [ "gudzaratin kieli", "gujaratin kieli" ], "created_time": "2023-08-16T05:07:03.528699Z", "last_modified_time": "2023-08-16T05:07:03.528715Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "gudžaratin kieli", "sv": "gujarati", "en": "Gujarati language" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25436/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p37731", "has_user_editable_resources": false, "alt_labels": [ "gudzaratinkielinen kirjallisuus", "gujaratinkielinen kirjallisuus", "gujaratilitteratur", "gujaratisk litteratur", "litteratur på gujarātī" ], "created_time": "2023-08-16T05:11:31.282908Z", "last_modified_time": "2023-08-16T05:11:31.282948Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "gudžaratinkielinen kirjallisuus", "sv": "litteratur på gujarati", "en": "Gujarati language literature" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p37731/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39305", "has_user_editable_resources": false, "alt_labels": [ "Gurungs", "Tamu people", "tamut", "gurung (folk)", "tamu" ], "created_time": "2023-08-16T05:08:04.791365Z", "last_modified_time": "2023-08-16T05:08:04.791385Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "gurungit", "sv": "gurunger", "en": "Gurung people" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39305/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p20960", "has_user_editable_resources": false, "alt_labels": [ "gurur" ], "created_time": "2023-08-16T05:13:19.122323Z", "last_modified_time": "2023-08-16T05:13:19.122341Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "gurut", "sv": "guruer", "en": "gurus" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20960/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22915", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:41.333256Z", "last_modified_time": "2023-08-16T05:06:41.333307Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "GW-BASIC", "en": "GW-BASIC" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22915/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22444", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:37.180022Z", "last_modified_time": "2023-08-16T05:06:37.180042Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "gymstickit", "sv": "gymstick", "en": "gymsticks" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22444/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p4853", "has_user_editable_resources": false, "alt_labels": [ "naistentautioppi", "gynecology" ], "created_time": "2023-08-16T05:11:58.022111Z", "last_modified_time": "2025-04-24T04:40:48.625687Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "gynekologia", "sv": "gynekologi", "en": "gynaecology" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4853/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21659", "has_user_editable_resources": false, "alt_labels": [ "gynekologiset syöpätaudit", "gynekologiska cancersjukdomar", "gynecological cancers" ], "created_time": "2023-08-16T05:15:31.009053Z", "last_modified_time": "2023-08-16T05:15:31.009079Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "gynekologiset syövät", "sv": "gynekologisk cancer", "en": "gynaecological cancers" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21659/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "