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=189&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=190&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=188&show_all_keywords=True" }, "data": [ { "id": "yso:p126", "has_user_editable_resources": false, "alt_labels": [ "epikureismen" ], "created_time": "2023-08-16T05:05:12.379855Z", "last_modified_time": "2023-08-16T05:05:12.379873Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "epikurolaisuus", "sv": "epikurism", "en": "Epicureanism" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p126/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p9413", "has_user_editable_resources": false, "alt_labels": [ "kaatumatauti", "fallandesjuka" ], "created_time": "2023-08-16T05:16:28.172054Z", "last_modified_time": "2023-08-16T05:16:28.172071Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "epilepsia", "sv": "epilepsi", "en": "epilepsy" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9413/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p37973", "has_user_editable_resources": false, "alt_labels": [ "pintakuvanheittimet", "balloptikon" ], "created_time": "2023-08-16T05:16:00.015549Z", "last_modified_time": "2023-08-16T05:16:00.015575Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "episkoopit", "sv": "episkop", "en": "episcopes" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p37973/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p4723", "has_user_editable_resources": false, "alt_labels": [ "epitelet" ], "created_time": "2023-08-16T05:18:23.403153Z", "last_modified_time": "2023-08-16T05:18:23.403174Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "epiteeli", "sv": "epitel", "en": "epithelium" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4723/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p28973", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:17:47.783188Z", "last_modified_time": "2023-08-16T05:17:47.783205Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "epiteelisolut", "sv": "epitelceller", "en": "epithelial cells" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28973/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29716", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:41.636871Z", "last_modified_time": "2023-08-16T05:07:41.636889Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "epiteksti", "sv": "epitext", "en": "epitext" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29716/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p8556", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:15.663138Z", "last_modified_time": "2023-08-16T05:12:15.663156Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "EPOC", "en": "EPOC" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8556/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p17574", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:52.140003Z", "last_modified_time": "2023-08-16T05:05:52.140028Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "epoksi", "sv": "epoxiplast", "en": "epoxy" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17574/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40587", "has_user_editable_resources": false, "alt_labels": [ "epoxidation" ], "created_time": "2025-01-22T04:40:25.543473Z", "last_modified_time": "2025-01-24T07:24:27.325361Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "epoksidointi", "sv": "epoxidering", "en": "epoxidation" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40587/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p26665", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:15.635051Z", "last_modified_time": "2023-08-16T05:07:15.635071Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "eponyymit", "sv": "eponymer", "en": "eponyms" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26665/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p30182", "has_user_editable_resources": false, "alt_labels": [ "period dress", "aikakausipuvut", "historialliset näyttämöpuvut", "historialliset teatteripuvut", "periodipuvut" ], "created_time": "2023-08-16T05:17:49.200483Z", "last_modified_time": "2023-08-16T05:17:49.200502Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "epookkipuvut", "sv": "epokdräkter", "en": "period costumes" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30182/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22637", "has_user_editable_resources": false, "alt_labels": [ "EBV (virus)", "humant herpesvirus 4" ], "created_time": "2023-08-16T05:10:19.988696Z", "last_modified_time": "2024-04-05T04:40:50.572454Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Epstein-Barrin virus", "sv": "Epstein–Barr-virus", "en": "Epstein–Barr virus" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22637/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29782", "has_user_editable_resources": false, "alt_labels": [ "levyt (äänilevyt)", "extended-play discs", "records (EPs)", "EP-levyt", "eepeet", "EP-skivor", "EP:s", "skivor (ep)", "extended-play disks" ], "created_time": "2023-08-16T05:15:54.988564Z", "last_modified_time": "2023-08-16T05:15:54.988583Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "EP:t", "sv": "ep", "en": "EPs" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29782/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38821", "has_user_editable_resources": false, "alt_labels": [ "inappropriate behaviour", "mistreatment", "inappropriate behavior" ], "created_time": "2023-08-16T05:17:08.253765Z", "last_modified_time": "2023-08-16T05:17:08.253786Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "epäasiallinen kohtelu", "sv": "osakligt bemötande", "en": "inappropriate treatment" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38821/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p9473", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:20.755144Z", "last_modified_time": "2023-08-16T05:12:20.755162Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "epäeuklidinen geometria", "sv": "icke-euklidisk geometri", "en": "non-Euclidean geometry" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9473/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p1724", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:17:38.820780Z", "last_modified_time": "2023-08-16T05:17:38.820800Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "epäily", "sv": "tvivel", "en": "doubt" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1724/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16074", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:09:22.024303Z", "last_modified_time": "2023-08-16T05:09:22.024334Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "epäinhimillisyys", "sv": "omänsklighet", "en": "inhumanity" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16074/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2895", "has_user_editable_resources": false, "alt_labels": [ "pyyteettömyys" ], "created_time": "2023-08-16T05:17:01.367919Z", "last_modified_time": "2023-08-16T05:17:01.367936Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "epäitsekkyys", "sv": "osjälviskhet", "en": "unselfishness" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2895/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2480", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:39.542945Z", "last_modified_time": "2023-08-16T05:10:39.542964Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "epäjatkuvuus", "sv": "diskontinuitet", "en": "discontinuity" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2480/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21604", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:10.116742Z", "last_modified_time": "2023-08-16T05:10:10.116760Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "epäjumalat", "sv": "avgudar", "en": "false gods" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21604/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31673, "next": "