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=200&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=201&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=199&show_all_keywords=True" }, "data": [ { "id": "yso:p29350", "has_user_editable_resources": false, "alt_labels": [ "manner of expression", "framförandesätt" ], "created_time": "2023-08-16T05:18:18.883038Z", "last_modified_time": "2023-08-16T05:18:18.883065Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "esitystapa", "sv": "framställningssätt", "en": "manner of representation" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29350/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p25457", "has_user_editable_resources": false, "alt_labels": [ "presentationsteknologi" ], "created_time": "2023-08-16T05:07:03.744415Z", "last_modified_time": "2023-08-16T05:07:03.744435Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "esitystekniikka", "sv": "presentationsteknik", "en": "presentation technology" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25457/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p28832", "has_user_editable_resources": false, "alt_labels": [ "framställningssituation" ], "created_time": "2023-08-16T05:17:47.560143Z", "last_modified_time": "2023-08-16T05:17:47.560181Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "esitystilanne", "sv": "framförandesituation", "en": "performance situation" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28832/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p28212", "has_user_editable_resources": false, "alt_labels": [ "performanssitutkimus", "performanssitutkimus" ], "created_time": "2023-08-16T05:18:38.805762Z", "last_modified_time": "2023-08-16T05:18:38.805780Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "esitystutkimus", "sv": "performanceforskning", "en": "performance studies" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28212/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p18484", "has_user_editable_resources": false, "alt_labels": [ "primaries" ], "created_time": "2023-08-16T05:06:00.936626Z", "last_modified_time": "2023-08-16T05:06:00.936645Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "esivaalit", "sv": "primärval", "en": "primary elections" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18484/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p27836", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:25.315308Z", "last_modified_time": "2023-08-16T05:07:25.315325Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "esivahvistimet", "sv": "förförstärkare", "en": "preamplifiers" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27836/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2210", "has_user_editable_resources": false, "alt_labels": [ "förmödrar" ], "created_time": "2023-08-16T05:15:32.455225Z", "last_modified_time": "2023-08-16T05:15:32.455243Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "esivanhemmat", "sv": "förfäder", "en": "ancestors" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2210/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40339", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2024-03-23T04:40:24.042636Z", "last_modified_time": "2024-05-07T04:40:21.911839Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "eskadroonat", "sv": "skvadroner", "en": "squadrons (cavalry)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40339/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p6645", "has_user_editable_resources": false, "alt_labels": [ "todellisuuspakoisuus", "verklighetsflykt" ], "created_time": "2023-08-16T05:12:05.830811Z", "last_modified_time": "2023-08-16T05:12:05.830828Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "eskapismi", "sv": "eskapism", "en": "escapism" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6645/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3913", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:18:21.455625Z", "last_modified_time": "2023-08-16T05:18:21.455644Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "eskatologia", "sv": "eskatologi", "en": "eschatology" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3913/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p27445", "has_user_editable_resources": false, "alt_labels": [ "s-ketamiini" ], "created_time": "2023-08-16T05:07:22.510020Z", "last_modified_time": "2023-08-16T05:07:22.510037Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "esketamiini", "sv": "esketamin", "en": "esketamine" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27445/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p24282", "has_user_editable_resources": false, "alt_labels": [ "Eskaleut languages", "eskaleutspråk", "inuit-yupik-aleutspråk", "inuit-yupik-unanganspråk", "Inuit–Yupik–Unangan languages", "inuitti-jupik-unanganilaiset kielet" ], "created_time": "2023-08-16T05:15:38.039408Z", "last_modified_time": "2025-08-19T04:41:14.158835Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "eskimo-aleuttilaiset kielet", "sv": "eskimåisk-aleutiska språk", "en": "Eskimo-Aleut languages" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24282/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p4481", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:14:28.047610Z", "last_modified_time": "2023-08-16T05:14:28.047638Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "eskimokielet", "sv": "eskimåspråk", "en": "Eskimo languages" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4481/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p6603", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:16:17.581356Z", "last_modified_time": "2023-08-16T05:16:17.581382Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "esoterismi", "sv": "esoterism", "en": "esoterism" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6603/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16199", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:56.325697Z", "last_modified_time": "2023-08-16T05:12:56.325714Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "espanjalaiset", "sv": "spanjorer", "en": "Spanish people" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16199/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21783", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:16:50.523721Z", "last_modified_time": "2023-08-16T05:16:50.523740Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "espanjalaisuus", "sv": "spanskhet", "en": "Spanish identity" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21783/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12398", "has_user_editable_resources": false, "alt_labels": [ "Castilian language" ], "created_time": "2023-08-16T05:05:11.182971Z", "last_modified_time": "2023-08-16T05:05:11.182990Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "espanjan kieli", "sv": "spanska", "en": "Spanish language" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12398/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p17030", "has_user_editable_resources": false, "alt_labels": [ "spansk litteratur", "spanskspråkig litteratur" ], "created_time": "2023-08-16T05:09:29.621140Z", "last_modified_time": "2023-08-16T05:09:29.621157Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "espanjankielinen kirjallisuus", "sv": "litteratur på spanska", "en": "Spanish language literature" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17030/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2199", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:13.666184Z", "last_modified_time": "2023-08-16T05:10:13.666211Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "espanjankieliset", "sv": "spanskspråkiga", "en": "Spanish speakers" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2199/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38352", "has_user_editable_resources": false, "alt_labels": [ "mastin español", "mastin español", "mastín espanol", "mastín español", "spansk mastiff" ], "created_time": "2023-08-16T05:11:36.673761Z", "last_modified_time": "2023-08-16T05:11:36.673795Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "espanjanmastiffi", "sv": "mastin espanol", "en": "Spanish mastiff" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38352/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "