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=196&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=197&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=195&show_all_keywords=True" }, "data": [ { "id": "yso:p29178", "has_user_editable_resources": false, "alt_labels": [ "litteratur på erjya", "litteratur på erza", "litteratur på erzia" ], "created_time": "2023-08-16T05:11:16.603902Z", "last_modified_time": "2023-08-16T05:11:16.603920Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ersänkielinen kirjallisuus", "sv": "litteratur på erzya", "en": "Erzya language literature" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29178/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39022", "has_user_editable_resources": false, "alt_labels": [ "erytrosyyttien muodostus", "punasolujen muodostus" ], "created_time": "2023-08-16T05:16:04.100480Z", "last_modified_time": "2023-08-16T05:16:04.100503Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "erytropoieesi", "sv": "erytropoes", "en": "erythropoiesis" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39022/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38860", "has_user_editable_resources": false, "alt_labels": [ "EPO (hormoni)", "epo", "erytropoetin" ], "created_time": "2023-08-16T05:14:17.720421Z", "last_modified_time": "2023-08-16T05:14:17.720440Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "erytropoietiini", "sv": "erytropoietin", "en": "erythropoietin" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38860/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10767", "has_user_editable_resources": false, "alt_labels": [ "eräkirjat", "erätarinat", "jakt- och fiskeberättelser", "jakt- och fiskehistorier", "jakt- och fiskeskildringar" ], "created_time": "2023-08-16T05:08:42.760061Z", "last_modified_time": "2023-08-16T05:08:42.760080Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "eräkertomukset", "sv": "vildmarksberättelser", "en": "wilderness stories" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10767/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10766", "has_user_editable_resources": false, "alt_labels": [ "ödemarkslitteratur", "eräkirjat", "outdoor literature" ], "created_time": "2023-08-16T05:17:30.213721Z", "last_modified_time": "2023-08-16T05:17:30.213738Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "eräkirjallisuus", "sv": "vildmarkslitteratur", "en": "wilderness literature" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10766/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22711", "has_user_editable_resources": false, "alt_labels": [ "kalastuslehdet", "metsästyslehdet", "fisketidningar", "jakttidningar" ], "created_time": "2023-08-16T05:10:20.795351Z", "last_modified_time": "2023-08-16T05:10:20.795378Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "erälehdet", "sv": "jakt- och fisketidningar", "en": "hunting and fishing magazines" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22711/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21343", "has_user_editable_resources": false, "alt_labels": [ "vildmarksområden" ], "created_time": "2023-08-16T05:10:07.636439Z", "last_modified_time": "2023-08-16T05:10:07.636456Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "erämaa-alueet", "sv": "ödemarksområden", "en": "wilderness areas" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21343/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16977", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:16:45.124413Z", "last_modified_time": "2023-08-16T05:16:45.124431Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "erämaat", "sv": "vildmarker", "en": "wildernesses" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16977/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p1981", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:16:48.043684Z", "last_modified_time": "2023-08-16T05:16:48.043702Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "eräoppaat (ammatit)", "sv": "vildmarksguider (yrken)", "en": "wilderness guides (occupations)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1981/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10784", "has_user_editable_resources": false, "alt_labels": [ "eräelämä", "vildmarksliv", "tunturivaellus", "fjällvandring", "jakt- och fiskefärder", "vildmarksfärder", "vildmarksutflykt", "ödemarksvandring" ], "created_time": "2023-08-16T05:17:30.323173Z", "last_modified_time": "2023-08-16T05:17:30.323191Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "eräretkeily", "sv": "vildmarksvandring", "en": "wilderness hiking" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10784/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p26129", "has_user_editable_resources": false, "alt_labels": [ "eräelämä", "vildmarksfärdigheter", "vildmarksliv" ], "created_time": "2023-08-16T05:16:55.586017Z", "last_modified_time": "2023-08-16T05:16:55.586036Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "erätaidot", "sv": "vildmarkskunskaper", "en": "woodcraft" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26129/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3544", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:18:20.482738Z", "last_modified_time": "2023-08-16T05:18:20.482757Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "erätalous", "sv": "ödemarksbruk", "en": "hunting, fishing and slash-burning" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3544/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p23302", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:31.989563Z", "last_modified_time": "2023-08-16T05:13:31.989581Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "erävalvonta", "sv": "jakt- och fiskeövervakning", "en": "hunting and fishing control" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23302/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p4942", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:16:11.464979Z", "last_modified_time": "2023-08-16T05:16:11.464996Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "esanssit", "sv": "essenser", "en": "flavouring essences" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4942/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39589", "has_user_editable_resources": false, "alt_labels": [ "prediabetic state", "fördiabetes" ], "created_time": "2023-08-16T05:11:49.357066Z", "last_modified_time": "2023-08-16T05:11:49.357092Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "esidiabetes", "sv": "prediabetes", "en": "prediabetes" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39589/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22003", "has_user_editable_resources": false, "alt_labels": [ "esimies-alaissuhde", "chef-medarbetare-relation", "chef-medarbetarrelation" ], "created_time": "2023-08-16T05:18:37.268815Z", "last_modified_time": "2023-08-16T05:18:37.268835Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "esihenkilö-alaissuhde", "sv": "chef-anställd-förhållande", "en": "supervisor-employee relationship" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22003/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p4191", "has_user_editable_resources": false, "alt_labels": [ "bosses", "foremen", "forepersons", "superiors", "esimiehet", "päälliköt", "chefer (förmän)", "föreståndare", "förpersoner", "överordnade", "teamledare" ], "created_time": "2023-08-16T05:19:39.233485Z", "last_modified_time": "2023-08-16T05:19:39.233504Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "esihenkilöt", "sv": "förmän", "en": "supervisors" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4191/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p24183", "has_user_editable_resources": false, "alt_labels": [ "esimiestaidot", "chefsegenskaper", "förmansfärdigheter" ], "created_time": "2023-08-16T05:13:35.872160Z", "last_modified_time": "2023-08-16T05:13:35.872176Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "esihenkilötaidot", "sv": "chefsfärdigheter", "en": "managerial skills" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24183/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p24182", "has_user_editable_resources": false, "alt_labels": [ "supervisory work", "esimiestyö", "chefsarbete (förmän)" ], "created_time": "2023-08-16T05:17:43.426344Z", "last_modified_time": "2023-08-16T05:17:43.426363Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "esihenkilötyö", "sv": "förmansarbete", "en": "managerial work" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24182/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p4622", "has_user_editable_resources": false, "alt_labels": [ "esihistoriallinen aika", "forntid", "förhistorisk tid" ], "created_time": "2023-08-16T05:18:55.978651Z", "last_modified_time": "2023-08-16T05:18:55.978667Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "esihistoria", "sv": "förhistoria", "en": "prehistory" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4622/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "