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=240&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=241&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=239&show_all_keywords=True" }, "data": [ { "id": "yso:p13086", "has_user_editable_resources": false, "alt_labels": [ "geoterminen lämpö" ], "created_time": "2023-08-16T05:12:39.476957Z", "last_modified_time": "2023-08-16T05:12:39.476974Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "geoterminen energia", "sv": "geotermisk energi", "en": "geothermal energy" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13086/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p8274", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:18:02.947749Z", "last_modified_time": "2023-08-16T05:18:02.947768Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "geotieteet", "sv": "geovetenskaper", "en": "geosciences" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8274/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12861", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:14.236201Z", "last_modified_time": "2023-08-16T05:05:14.236223Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "gepardi", "sv": "gepard", "en": "cheetah" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12861/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p28376", "has_user_editable_resources": false, "alt_labels": [ "HRO", "hauraus-raihnausoireyhtymä", "skörhet hos äldre", "skörhetssyndrom", "ålderdomsavtyning", "ålderdomsbräcklighet", "ålderdomsskörhet", "ålderdomssvaghet" ], "created_time": "2023-08-16T05:07:29.784425Z", "last_modified_time": "2023-08-16T05:07:29.784447Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "gerastenia", "sv": "gerasteni", "en": "frailty syndrome" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28376/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22589", "has_user_editable_resources": false, "alt_labels": [ "sädelatvat", "Gerbera" ], "created_time": "2023-08-16T05:06:38.607237Z", "last_modified_time": "2023-08-16T05:06:38.607307Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "gerberat", "sv": "gerberor", "en": "gerberas" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22589/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5318", "has_user_editable_resources": false, "alt_labels": [ "gerbillit", "hyppymyyrät", "gerbiler", "ökenråttor" ], "created_time": "2023-08-16T05:14:31.960709Z", "last_modified_time": "2023-08-16T05:14:31.960726Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "gerbiilit", "sv": "gerbiller", "en": "gerbils" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5318/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19179", "has_user_editable_resources": false, "alt_labels": [ "vanhustenhoito-oppi" ], "created_time": "2023-08-16T05:06:08.666421Z", "last_modified_time": "2023-08-16T05:06:08.666443Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "geriatria", "sv": "geriatrik", "en": "geriatrics" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19179/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p23914", "has_user_editable_resources": false, "alt_labels": [ "germanistiikka" ], "created_time": "2023-08-16T05:13:34.315282Z", "last_modified_time": "2023-08-16T05:13:34.315309Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "germaaninen filologia", "sv": "germansk filologi", "en": "germanic philology" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23914/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p37782", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:11:31.402358Z", "last_modified_time": "2023-08-16T05:11:31.402378Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "germaaninen mytologia", "sv": "germansk mytologi", "en": "Germanic mythology" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p37782/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3856", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:17:07.846856Z", "last_modified_time": "2023-08-16T05:17:07.846873Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "germaaniset kielet", "sv": "germanska språk", "en": "Germanic languages" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3856/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5199", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:18:56.494569Z", "last_modified_time": "2023-08-16T05:18:56.494587Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "germaanit", "sv": "germaner", "en": "Germanic peoples" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5199/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22858", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:29.711347Z", "last_modified_time": "2023-08-16T05:13:29.711365Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "germanium", "en": "germanium" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22858/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39833", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:14:24.153731Z", "last_modified_time": "2023-08-16T05:14:24.153750Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "geronomit", "sv": "geronomer", "en": "Bachelors of Social Services and Health Care (elderly care)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39833/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p468", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:18:23.341317Z", "last_modified_time": "2023-08-16T05:18:23.341336Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "gerontologia", "sv": "gerontologi", "en": "gerontology" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p468/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12901", "has_user_editable_resources": false, "alt_labels": [ "geronteknologia", "gerontotekniikka", "gerontoteknologia", "gerotekniikka" ], "created_time": "2023-08-16T05:12:38.324660Z", "last_modified_time": "2023-08-16T05:12:38.324677Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "geroteknologia", "sv": "geriatrisk teknologi", "en": "gerotechnology" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12901/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22864", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:29.754080Z", "last_modified_time": "2023-08-16T05:13:29.754098Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "gesneriakasvit", "sv": "gloxiniaväxter", "en": "Gesneriaceae" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22864/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29145", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:11:16.167191Z", "last_modified_time": "2023-08-16T05:11:16.167210Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Gettysburgin taistelu", "sv": "slaget vid Gettysburg", "en": "Battle of Gettysburg" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29145/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40080", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:08:12.802418Z", "last_modified_time": "2023-08-16T05:08:12.802450Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ghanalaiset", "sv": "ghananer", "en": "Ghanaians" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40080/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29931", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:11:24.378597Z", "last_modified_time": "2023-08-16T05:11:24.378617Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ghazal", "en": "ghazal" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29931/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16450", "has_user_editable_resources": false, "alt_labels": [ "getot", "getton" ], "created_time": "2023-08-16T05:05:41.528623Z", "last_modified_time": "2023-08-16T05:05:41.528640Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ghetot", "sv": "ghetton", "en": "ghettos" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16450/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "