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=121&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=122&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=120&show_all_keywords=True" }, "data": [ { "id": "yso:p17472", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:09:33.316043Z", "last_modified_time": "2023-08-16T05:09:33.316062Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bokseri", "sv": "boxer", "en": "boxer (Molossers)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17472/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p30075", "has_user_editable_resources": false, "alt_labels": [ "boleroer (danser)", "boleror (danser)", "boleros (danser)" ], "created_time": "2023-08-16T05:07:44.620963Z", "last_modified_time": "2023-08-16T05:07:44.620995Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bolero (tanssit)", "sv": "bolero (danser)", "en": "bolero (dances)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30075/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p30036", "has_user_editable_resources": false, "alt_labels": [ "boleroer (kompositioner)", "boleros (kompositioner)" ], "created_time": "2023-08-16T05:11:25.502884Z", "last_modified_time": "2023-08-16T05:11:25.502901Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bolerot (sävellykset)", "sv": "boleror (kompositioner)", "en": "boleros (compositions)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30036/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22727", "has_user_editable_resources": false, "alt_labels": [ "Bulgars" ], "created_time": "2023-08-16T05:10:20.894394Z", "last_modified_time": "2023-08-16T05:10:20.894423Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bolgaarit", "sv": "bolgarer", "en": "Bolgars" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22727/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40024", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:08:11.969308Z", "last_modified_time": "2023-08-16T05:08:11.969327Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bolivialaiset", "sv": "bolivianer", "en": "Bolivians" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40024/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p27755", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:24.856493Z", "last_modified_time": "2023-08-16T05:07:24.856510Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bollywood-tanssi", "sv": "bollywooddans", "en": "Bollywood (dance)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27755/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p20814", "has_user_editable_resources": false, "alt_labels": [ "Bologna-prosessi", "Bologna processen" ], "created_time": "2023-08-16T05:13:18.186453Z", "last_modified_time": "2023-08-16T05:13:18.186471Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Bolognan prosessi", "sv": "Bolognaprocessen", "en": "Bologna process" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20814/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21883", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:12.616679Z", "last_modified_time": "2023-08-16T05:10:12.616698Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bolognese", "en": "Bolognese dog" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21883/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40513", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2024-11-02T04:40:55.902325Z", "last_modified_time": "2024-11-14T04:40:56.785517Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bolometrit", "sv": "bolometrar", "en": "bolometers" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40513/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p6699", "has_user_editable_resources": false, "alt_labels": [ "bolshevismi" ], "created_time": "2023-08-16T05:16:17.995044Z", "last_modified_time": "2023-08-16T05:16:17.995061Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bolševismi", "sv": "bolsjevism", "en": "Bolshevism" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6699/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15575", "has_user_editable_resources": false, "alt_labels": [ "Bomarsund" ], "created_time": "2023-08-16T05:12:52.875229Z", "last_modified_time": "2023-08-16T05:12:52.875253Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Bomarsund", "sv": "Bomarsunds fästning", "en": "Bomarsund" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15575/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21746", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:32.379916Z", "last_modified_time": "2023-08-16T05:06:32.379933Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Bomban juhlaviikot", "en": "Bomba festivals" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21746/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p28427", "has_user_editable_resources": false, "alt_labels": [ "Bomba-huset" ], "created_time": "2023-08-16T05:11:10.346771Z", "last_modified_time": "2023-08-16T05:11:10.346789Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Bomban talo", "sv": "Bombahuset", "en": "Bomba House" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28427/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p8622", "has_user_editable_resources": false, "alt_labels": [ "bon-po", "bön", "bön-po", "bon (religion)", "bön-religion" ], "created_time": "2023-08-16T05:14:48.602387Z", "last_modified_time": "2023-08-16T05:14:48.602414Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bon", "sv": "bon (religioner)", "en": "Bon" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8622/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15913", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:37.565065Z", "last_modified_time": "2023-08-16T05:05:37.565083Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "BONes", "en": "BONes (computer programmes)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15913/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p26416", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:15:43.307530Z", "last_modified_time": "2023-08-16T05:15:43.307553Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bonkei", "en": "bonkei" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26416/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p4931", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:16:11.445150Z", "last_modified_time": "2023-08-16T05:16:11.445168Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bonsai", "en": "bonsai" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4931/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21122", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:15:29.126917Z", "last_modified_time": "2023-08-16T05:15:29.126937Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bonukset", "sv": "bonusar", "en": "bonuses" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21122/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29816", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:15:55.137885Z", "last_modified_time": "2023-08-16T05:15:55.137904Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "boogie woogie (musiikki)", "sv": "boogie woogie (musik)", "en": "boogie woogie (music)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29816/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39175", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:08:03.494411Z", "last_modified_time": "2023-08-16T05:08:03.494431Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "boogie woogie (tanssit)", "sv": "boogie woogie (danser)", "en": "boogie-woogie (dances)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39175/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "