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=1474&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1475&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1473&show_all_keywords=True" }, "data": [ { "id": "yso:p10541", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:16:31.494389Z", "last_modified_time": "2023-08-16T05:16:31.494408Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesieläimistö", "sv": "vattenfauna", "en": "aquatic fauna" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10541/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3161", "has_user_editable_resources": false, "alt_labels": [ "vesien hoito" ], "created_time": "2023-08-16T05:17:04.305676Z", "last_modified_time": "2023-08-16T05:17:04.305696Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesienhoito", "sv": "vattenvård", "en": "water management" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3161/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21995", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:25.092780Z", "last_modified_time": "2023-08-16T05:13:25.092798Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesienhoitoalueet", "sv": "vattenvårdsområden", "en": "river basin districts" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21995/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p7659", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:19:07.450199Z", "last_modified_time": "2023-08-16T05:19:07.450216Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesien saastuminen", "sv": "vattenförorening", "en": "water pollution" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7659/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3163", "has_user_editable_resources": false, "alt_labels": [ "vesistönsuojelu" ], "created_time": "2023-08-16T05:17:04.340057Z", "last_modified_time": "2023-08-16T05:17:04.340074Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesiensuojelu", "sv": "vattenskydd", "en": "water protection" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3163/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p37934", "has_user_editable_resources": false, "alt_labels": [ "vesistöjen tila", "sjöars och vattendrags status", "sjöars och vattendrags tillstånd", "vattendragens status" ], "created_time": "2023-08-16T05:18:40.674000Z", "last_modified_time": "2023-08-16T05:18:40.674017Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesien tila", "sv": "vattendragens tillstånd", "en": "state of waters" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p37934/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19381", "has_user_editable_resources": false, "alt_labels": [ "vattenadministration" ], "created_time": "2023-08-16T05:15:25.560019Z", "last_modified_time": "2023-08-16T05:15:25.560038Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesihallinto", "sv": "vattenförvaltning", "en": "water administration" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19381/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12800", "has_user_editable_resources": false, "alt_labels": [ "vattenskidning" ], "created_time": "2023-08-16T05:05:13.774651Z", "last_modified_time": "2023-08-16T05:05:13.774670Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesihiihto", "sv": "vattenskidåkning", "en": "water skiing" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12800/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p13439", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:17.969882Z", "last_modified_time": "2023-08-16T05:05:17.969901Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesihome", "sv": "vattenmögel", "en": "aquatic fungi" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13439/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p9681", "has_user_editable_resources": false, "alt_labels": [ "VA-tjänster", "vatten och avlopp" ], "created_time": "2023-08-16T05:19:14.567297Z", "last_modified_time": "2023-08-16T05:19:14.567325Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesihuolto", "sv": "vattentjänster", "en": "water services" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9681/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5979", "has_user_editable_resources": false, "alt_labels": [ "VA-anläggningar" ], "created_time": "2023-08-16T05:18:25.001962Z", "last_modified_time": "2023-08-16T05:18:25.001980Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesihuoltolaitokset", "sv": "vattentjänstverk", "en": "water supply plants" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5979/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p18133", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:06.561491Z", "last_modified_time": "2023-08-16T05:13:06.561509Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesihuoltolaki", "sv": "lag om vattentjänster", "en": "Act on Water Services" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18133/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38786", "has_user_editable_resources": false, "alt_labels": [ "water vapor" ], "created_time": "2023-08-16T05:17:52.310988Z", "last_modified_time": "2023-08-16T05:17:52.311004Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesihöyry", "sv": "vattenånga", "en": "water vapour" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38786/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p25484", "has_user_editable_resources": false, "alt_labels": [ "vattenavtryck" ], "created_time": "2023-08-16T05:15:41.104230Z", "last_modified_time": "2023-08-16T05:15:41.104247Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesijalanjälki", "sv": "vattenfotavtryck", "en": "water footprint" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25484/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40435", "has_user_editable_resources": false, "alt_labels": [ "Vesijako naturreservat" ], "created_time": "2024-09-22T04:40:53.454410Z", "last_modified_time": "2024-09-22T04:40:53.459911Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Vesijaon luonnonpuisto", "sv": "Vesijako naturpark", "en": "Vesijako Strict Nature Reserve" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40435/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21720", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:18:37.123703Z", "last_modified_time": "2023-08-16T05:18:37.123725Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesi- ja ympäristöpiirit", "sv": "vatten- och miljödistrikt", "en": "water and environment districts" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21720/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3072", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:17:49.401446Z", "last_modified_time": "2023-08-16T05:17:49.401464Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesijohdot", "sv": "vattenledningar", "en": "water pipes" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3072/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p13550", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:42.065535Z", "last_modified_time": "2023-08-16T05:12:42.065552Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesijohtoverkot", "sv": "vattenledningsnät", "en": "water distribution systems" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13550/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p17564", "has_user_editable_resources": false, "alt_labels": [ "vattenledningsvatten" ], "created_time": "2023-08-16T05:13:03.750956Z", "last_modified_time": "2023-08-16T05:13:03.750974Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesijohtovesi", "sv": "kranvatten", "en": "tap water" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17564/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2238", "has_user_editable_resources": false, "alt_labels": [ "water running" ], "created_time": "2023-08-16T05:06:36.923210Z", "last_modified_time": "2023-08-16T05:06:36.923229Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vesijuoksu", "sv": "vattenlöpning", "en": "aqua jogging" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2238/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31705, "next": "