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=122&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=123&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=121&show_all_keywords=True" }, "data": [ { "id": "yso:p29494", "has_user_editable_resources": false, "alt_labels": [ "kirjakrossaus", "kirjanvapautus", "bokcrossing" ], "created_time": "2023-08-16T05:17:48.355951Z", "last_modified_time": "2023-08-16T05:17:48.355988Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bookcrossing", "en": "bookcrossing" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29494/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p762", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:08:26.450733Z", "last_modified_time": "2023-08-16T05:08:26.450755Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Boolen algebra", "sv": "Boolesk algebra", "en": "Boolean algebra" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p762/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21072", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:28.071025Z", "last_modified_time": "2023-08-16T05:06:28.071047Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "boolit", "sv": "bålar", "en": "punches (beverages)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21072/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p7591", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:08:26.296438Z", "last_modified_time": "2023-08-16T05:08:26.296457Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "boori", "sv": "bor", "en": "boron" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7591/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40479", "has_user_editable_resources": false, "alt_labels": [ "BNCT-hoito", "boorineutronisädehoito", "BNCT-behandling", "BNCT-strålbehandling", "BNCT" ], "created_time": "2024-10-20T04:40:26.354056Z", "last_modified_time": "2024-11-14T04:40:26.057382Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "boori-neutronikaappaushoito", "sv": "borneutroninfångningsterapi", "en": "boron-neutron capture therapy" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40479/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29924", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:14:06.462846Z", "last_modified_time": "2023-08-16T05:14:06.462864Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bootlegit", "sv": "bootlegs", "en": "bootlegs" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29924/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p23323", "has_user_editable_resources": false, "alt_labels": [ "French mastiff" ], "created_time": "2023-08-16T05:10:26.986646Z", "last_modified_time": "2023-08-16T05:10:26.986667Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bordeauxindoggi", "sv": "dogue de bordeaux", "en": "dogue de Bordeaux" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23323/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10349", "has_user_editable_resources": false, "alt_labels": [ "ilotalot", "glädjehus" ], "created_time": "2023-08-16T05:16:31.028060Z", "last_modified_time": "2023-08-16T05:16:31.028084Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bordellit", "sv": "bordeller", "en": "brothels" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10349/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22434", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:27.322431Z", "last_modified_time": "2023-08-16T05:13:27.322449Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bordercollie", "sv": "border collie", "en": "border collie" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22434/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21635", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:10.400507Z", "last_modified_time": "2023-08-16T05:10:10.400524Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "borderterrieri", "sv": "borderterrier", "en": "border terrier" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21635/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5172", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:11:59.309646Z", "last_modified_time": "2023-08-16T05:11:59.309679Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Bordetella-bakteerit", "sv": "Bordetellabakterier", "en": "Bordetella" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5172/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16692", "has_user_editable_resources": false, "alt_labels": [ "Northern coniferous zone", "boreal ecosystem", "pohjoinen havumetsävyöhyke", "viileä vyöhyke", "kyliga zonen", "norra barrskogsregionen" ], "created_time": "2023-08-16T05:15:18.722612Z", "last_modified_time": "2023-08-16T05:15:18.722630Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "boreaalinen vyöhyke", "sv": "boreala zonen", "en": "boreal zone" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16692/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p14237", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:23.981968Z", "last_modified_time": "2023-08-16T05:05:23.981989Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "boridit", "sv": "borider", "en": "borides" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14237/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19549", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:12.516163Z", "last_modified_time": "2023-08-16T05:06:12.516180Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Borland C++ 5", "en": "Borland C++ 5" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19549/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p17589", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:52.357587Z", "last_modified_time": "2023-08-16T05:05:52.357613Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Borland Pascal with Objects", "en": "Borland Pascal with Objects" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17589/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p25813", "has_user_editable_resources": false, "alt_labels": [ "Bornatautivirus", "BD-virus", "borna disease virus" ], "created_time": "2023-08-16T05:10:49.218684Z", "last_modified_time": "2023-08-16T05:10:49.218703Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Borna-tautivirus", "sv": "bornavirus", "en": "Borna disease virus" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25813/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5531", "has_user_editable_resources": false, "alt_labels": [ "Pongo pygmaeus", "oranki (laji)", "orangutang (art)" ], "created_time": "2023-08-16T05:08:18.203581Z", "last_modified_time": "2023-08-16T05:08:18.203609Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "borneonoranki", "sv": "borneoorangutang", "en": "orangutan" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5531/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40652", "has_user_editable_resources": false, "alt_labels": [ "Bororoan languages", "Borotuke languages" ], "created_time": "2025-03-27T04:40:25.772532Z", "last_modified_time": "2025-03-27T04:40:25.772543Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bororolaiset kielet", "sv": "bororo (språkfamiljer)", "en": "Borôroan languages" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40652/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p23656", "has_user_editable_resources": false, "alt_labels": [ "Borreliabakterier" ], "created_time": "2023-08-16T05:10:30.408577Z", "last_modified_time": "2023-08-16T05:10:30.408595Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Borrelia-bakteerit", "sv": "borreliabakterier", "en": "Borrelia" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23656/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p13975", "has_user_editable_resources": false, "alt_labels": [ "borreliainfektion", "Lyme borreliosis", "borreliosis", "Lymen borrelioosi", "Lymen tauti", "Lyme-borrelios", "Lyme-sjukdom", "Lymes sjukdom", "Lymesjukdomen", "borrelia (sjukdom)" ], "created_time": "2023-08-16T05:15:10.315692Z", "last_modified_time": "2023-08-16T05:15:10.315710Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "borrelioosi", "sv": "borrelios", "en": "Lyme disease" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13975/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "