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=18&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=19&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=17&show_all_keywords=True" }, "data": [ { "id": "yso:p17642", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:04.163825Z", "last_modified_time": "2023-08-16T05:13:04.163849Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "absurdismi", "sv": "absurdism", "en": "absurdism" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17642/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p25784", "has_user_editable_resources": false, "alt_labels": [ "theater of the absurd" ], "created_time": "2023-08-16T05:13:43.851822Z", "last_modified_time": "2023-08-16T05:13:43.851840Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "absurdi teatteri", "sv": "absurd teater", "en": "theatre of the absurd" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25784/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29997", "has_user_editable_resources": false, "alt_labels": [ "a cappella", "acapella" ], "created_time": "2023-08-16T05:11:25.050666Z", "last_modified_time": "2023-08-16T05:11:25.050683Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "a cappella -musiikki", "sv": "a cappella-musik", "en": "a cappella" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29997/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p1576", "has_user_editable_resources": false, "alt_labels": [ "Microsoft Access" ], "created_time": "2023-08-16T05:05:35.803565Z", "last_modified_time": "2023-08-16T05:05:35.803583Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Access", "en": "Access" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1576/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19772", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:15.442016Z", "last_modified_time": "2023-08-16T05:06:15.442037Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Access Basic", "en": "Access Basic" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19772/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29900", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:15:55.479669Z", "last_modified_time": "2023-08-16T05:15:55.479688Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "acid jazz", "en": "acid jazz" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29900/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p28598", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:11:11.607937Z", "last_modified_time": "2023-08-16T05:11:11.607954Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Acinetobacter baumannii", "en": "Acinetobacter baumannii" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28598/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19448", "has_user_editable_resources": false, "alt_labels": [ "Adobe Acrobat", "Adobe Acrobat" ], "created_time": "2023-08-16T05:06:11.397611Z", "last_modified_time": "2023-08-16T05:06:11.397628Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Acrobat", "en": "Acrobat" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19448/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p23111", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:43.027945Z", "last_modified_time": "2023-08-16T05:06:43.027962Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Acrobat Connect Professional", "en": "Acrobat Connect Professional" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23111/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12817", "has_user_editable_resources": false, "alt_labels": [ "Adobe Acrobat Reader" ], "created_time": "2023-08-16T05:05:13.926783Z", "last_modified_time": "2023-08-16T05:05:13.926814Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Acrobat Reader", "en": "Acrobat Reader" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12817/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p14032", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:21.977957Z", "last_modified_time": "2023-08-16T05:05:21.977976Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ActionScript", "en": "ActionScript" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14032/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16143", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:09:22.641035Z", "last_modified_time": "2023-08-16T05:09:22.641060Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ActiveX", "en": "ActiveX" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16143/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p9253", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:08:33.728180Z", "last_modified_time": "2023-08-16T05:08:33.728208Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Ada", "en": "Ada" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9253/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29974", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:11:24.826000Z", "last_modified_time": "2023-08-16T05:11:24.826017Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "adagiot", "sv": "adagion", "en": "adagios" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29974/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19790", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:15.699463Z", "last_modified_time": "2023-08-16T05:06:15.699481Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ADAMS", "en": "ADAMS" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19790/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39584", "has_user_editable_resources": false, "alt_labels": [ "Attention Deficit Disorder", "tarkkaavaisuushäiriö", "tarkkaavuushäiriö", "uppmärksamhetsstörning" ], "created_time": "2023-08-16T05:11:49.316755Z", "last_modified_time": "2023-08-16T05:11:49.316772Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ADD", "en": "ADD" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39584/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39590", "has_user_editable_resources": false, "alt_labels": [ "koukuttavuus", "beroendeframkallande egenskap" ], "created_time": "2023-08-16T05:11:49.395507Z", "last_modified_time": "2023-08-16T05:11:49.395607Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "addiktiivisuus", "sv": "beroendeframkallande", "en": "addictiveness" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39590/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p17277", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:09:31.761444Z", "last_modified_time": "2023-08-16T05:09:31.761461Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Addisonin tauti", "sv": "Addisons sjukdom", "en": "Addison's disease" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17277/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p17331", "has_user_editable_resources": false, "alt_labels": [ "rauhassyöpä", "adenocarcinom" ], "created_time": "2023-08-16T05:05:49.536615Z", "last_modified_time": "2023-08-16T05:05:49.536633Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "adenokarsinooma", "sv": "adenokarcinom", "en": "adenocarcinoma" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17331/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p23459", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:28.365894Z", "last_modified_time": "2023-08-16T05:10:28.365912Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "adenosiini", "sv": "adenosin", "en": "adenosine" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23459/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "