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=74&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=75&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=73&show_all_keywords=True" }, "data": [ { "id": "yso:p13136", "has_user_editable_resources": false, "alt_labels": [ "Arktikum-huset" ], "created_time": "2023-08-16T05:08:59.433598Z", "last_modified_time": "2023-08-16T05:08:59.433618Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Arktikum-talo", "sv": "Arktikum", "en": "Arktikum" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13136/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12434", "has_user_editable_resources": false, "alt_labels": [ "arctic zone", "Arktis", "arktiset alueet", "Arktis", "arktiska området", "arktiskt område" ], "created_time": "2023-08-16T05:16:36.559178Z", "last_modified_time": "2023-08-16T05:16:36.559195Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "arktinen alue", "sv": "arktiska regionen", "en": "arctic region" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12434/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12194", "has_user_editable_resources": false, "alt_labels": [ "kylmän ilmanalan tutkimus" ], "created_time": "2023-08-16T05:12:35.003061Z", "last_modified_time": "2023-08-16T05:12:35.003082Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "arktinen tutkimus", "sv": "arktisk forskning", "en": "arctic research" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12194/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p6309", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:04.696706Z", "last_modified_time": "2023-08-16T05:12:04.696723Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "arktiset kulttuurit", "sv": "arktiska kulturer", "en": "arctic cultures" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6309/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39689", "has_user_editable_resources": false, "alt_labels": [ "Archival Resource Key", "archival resource key" ], "created_time": "2023-08-16T05:11:50.456644Z", "last_modified_time": "2023-08-16T05:11:50.456661Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ARK-tunnus", "sv": "ARK (identifikatorer)", "en": "ARK identifier" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39689/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p14164", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:09:06.641928Z", "last_modified_time": "2023-08-16T05:09:06.641946Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "arkusfunktiot", "sv": "arcusfunktioner", "en": "arcus functions" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14164/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p17946", "has_user_editable_resources": false, "alt_labels": [ "caskets", "chests", "kirstut" ], "created_time": "2023-08-16T05:09:37.225589Z", "last_modified_time": "2023-08-16T05:09:37.225612Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "arkut", "sv": "kistor", "en": "chests (boxes)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17946/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22504", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:18.867571Z", "last_modified_time": "2023-08-16T05:10:18.867589Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "arkuus", "sv": "skygghet", "en": "timidity" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22504/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3195", "has_user_editable_resources": false, "alt_labels": [ "pardon", "amnestia", "amnesti" ], "created_time": "2023-08-16T05:15:57.181042Z", "last_modified_time": "2023-08-16T05:15:57.181059Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "armahdus", "sv": "benådning", "en": "amnesty" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3195/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40341", "has_user_editable_resources": false, "alt_labels": [ "army corps", "military corps" ], "created_time": "2024-03-23T04:40:24.060065Z", "last_modified_time": "2024-08-29T04:40:16.437790Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "armeijakunnat", "sv": "armékårer", "en": "corps (military)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40341/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3884", "has_user_editable_resources": false, "alt_labels": [ "armeer" ], "created_time": "2023-08-16T05:19:11.401586Z", "last_modified_time": "2023-08-16T05:19:11.401603Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "armeijat", "sv": "arméer", "en": "armies" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3884/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p26234", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:15:42.942657Z", "last_modified_time": "2023-08-16T05:15:42.942683Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "armeliaisuus", "sv": "barmhärtighet", "en": "clemency" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26234/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p23648", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:30.244578Z", "last_modified_time": "2023-08-16T05:10:30.244604Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "armenialaiset", "sv": "armenier", "en": "Armenians" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23648/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38709", "has_user_editable_resources": false, "alt_labels": [ "Sosnowsky's hogweed", "Heracleum sosnowskyi" ], "created_time": "2023-08-16T05:07:58.706860Z", "last_modified_time": "2023-08-16T05:07:58.706885Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "armenianjättiputki", "sv": "bredloka", "en": "Heracleum sosnowskyi" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38709/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12754", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:13.496428Z", "last_modified_time": "2023-08-16T05:05:13.496448Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "armenian kieli", "sv": "armeniska", "en": "Armenian language" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12754/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29313", "has_user_editable_resources": false, "alt_labels": [ "armenisk litteratur" ], "created_time": "2023-08-16T05:11:18.864990Z", "last_modified_time": "2023-08-16T05:11:18.865010Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "armeniankielinen kirjallisuus", "sv": "litteratur på armeniska", "en": "Armenian language literature" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29313/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38293", "has_user_editable_resources": false, "alt_labels": [ "arminianismi", "remonstranter" ], "created_time": "2023-08-16T05:07:53.782414Z", "last_modified_time": "2023-08-16T05:07:53.782434Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "arminiolaisuus", "sv": "arminianism", "en": "Arminianism" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38293/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p7063", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:08.079845Z", "last_modified_time": "2023-08-16T05:12:08.079863Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "armo", "sv": "nåd", "en": "grace" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7063/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p9973", "has_user_editable_resources": false, "alt_labels": [ "karisma (uskonto)", "andegåvor" ], "created_time": "2023-08-16T05:14:55.661174Z", "last_modified_time": "2023-08-16T05:14:55.661191Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "armolahjat", "sv": "nådegåvor", "en": "spiritual gifts" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9973/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p23503", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:16:52.863210Z", "last_modified_time": "2023-08-16T05:16:52.863227Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aromaattiset hiilivedyt", "sv": "aromatiska kolväten", "en": "aromatic hydrocarbons" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23503/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "