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=44&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=45&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=43&show_all_keywords=True" }, "data": [ { "id": "yso:p40311", "has_user_editable_resources": false, "alt_labels": [ "alkuperäiskansatieto", "traditionell kunskap (urfolkskunskap)", "traditionskunskap (urfolkskunskap)" ], "created_time": "2024-04-04T04:40:49.784740Z", "last_modified_time": "2024-04-10T04:41:52.255926Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alkuperäiskansojen tieto", "sv": "urfolkskunskap", "en": "indigenous knowledge" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40311/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p17308", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:49.334443Z", "last_modified_time": "2023-08-16T05:05:49.334463Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alkuperäiskielet", "sv": "ursprungsspråk", "en": "indigenous languages" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17308/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p28980", "has_user_editable_resources": false, "alt_labels": [ "ursprungliga raser" ], "created_time": "2023-08-16T05:11:14.817071Z", "last_modified_time": "2023-08-16T05:11:14.817089Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alkuperäisrodut", "sv": "ursprungsraser", "en": "endemic breeds" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28980/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10665", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:08:42.032401Z", "last_modified_time": "2023-08-16T05:08:42.032420Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alkuperäissuoja", "sv": "ursprungsskydd", "en": "protection of origin" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10665/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p27000", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:50.011493Z", "last_modified_time": "2023-08-16T05:13:50.011511Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alkuperämaa", "sv": "ursprungsland", "en": "country of origin" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27000/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p17688", "has_user_editable_resources": false, "alt_labels": [ "locality marks", "ursprungsbeteckningar" ], "created_time": "2023-08-16T05:13:04.357204Z", "last_modified_time": "2023-08-16T05:13:04.357223Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alkuperämerkinnät", "sv": "ursprungsmärkningar", "en": "origin markings" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17688/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11822", "has_user_editable_resources": false, "alt_labels": [ "starters", "alkupalat", "alkuruuat", "entrérätter" ], "created_time": "2023-08-16T05:05:07.260147Z", "last_modified_time": "2023-08-16T05:05:07.260164Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alkuruoat", "sv": "förrätter", "en": "appetisers" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11822/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21501", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:17:41.756637Z", "last_modified_time": "2023-08-16T05:17:41.756654Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alkuräjähdys", "sv": "big bang", "en": "big bang" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21501/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39368", "has_user_editable_resources": false, "alt_labels": [ "incipient fire fighting", "första släckning", "första släckningsinsats", "handsläckning", "primärsläckning" ], "created_time": "2023-08-16T05:11:47.368288Z", "last_modified_time": "2023-08-16T05:11:47.368307Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alkusammutus", "sv": "förstahandssläckning", "en": "early fire suppression" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39368/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p14153", "has_user_editable_resources": false, "alt_labels": [ "allitteraatio", "begynnelserim", "bokstavsrim", "stavrim", "uddrim" ], "created_time": "2023-08-16T05:12:45.359222Z", "last_modified_time": "2023-08-16T05:12:45.359238Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alkusointu", "sv": "allitteration", "en": "alliteration" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14153/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5663", "has_user_editable_resources": false, "alt_labels": [ "uvertyrer" ], "created_time": "2023-08-16T05:16:13.937063Z", "last_modified_time": "2023-08-16T05:16:13.937081Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alkusoitot", "sv": "ouvertyrer", "en": "overtures" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5663/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5883", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:17:57.779186Z", "last_modified_time": "2023-08-16T05:17:57.779204Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alkutuotanto", "sv": "primärproduktion", "en": "primary production" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5883/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3809", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:16:00.592814Z", "last_modified_time": "2023-08-16T05:16:00.592832Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "allasalueet", "sv": "bassängområden", "en": "reservoir areas" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3809/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16680", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:43.777996Z", "last_modified_time": "2023-08-16T05:05:43.778013Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "allatiivi", "sv": "allativ", "en": "allative case" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16680/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5555", "has_user_editable_resources": false, "alt_labels": [ "vertauskuvalliset teokset", "allegoriska verk" ], "created_time": "2023-08-16T05:18:43.718075Z", "last_modified_time": "2023-08-16T05:18:43.718093Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "allegoriat", "sv": "allegorier", "en": "allegories" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5555/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p23706", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:49.941046Z", "last_modified_time": "2023-08-16T05:06:49.941064Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "allelopatia", "sv": "allelopati", "en": "allelopathy" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23706/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p30220", "has_user_editable_resources": false, "alt_labels": [ "allemanda", "allemandet (tanssit)", "almain", "alman", "almond", "allemander (danser)" ], "created_time": "2023-08-16T05:07:46.139580Z", "last_modified_time": "2023-08-16T05:07:46.139600Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "allemande (tanssit)", "sv": "allemande (danser)", "en": "allemande (dances)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30220/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p30189", "has_user_editable_resources": false, "alt_labels": [ "allemandat", "almainit", "almanit", "almondit" ], "created_time": "2023-08-16T05:14:07.976374Z", "last_modified_time": "2023-08-16T05:14:07.976392Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "allemandet (sävellykset)", "sv": "allemander (kompositioner)", "en": "allemandes (compositions)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30189/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21057", "has_user_editable_resources": false, "alt_labels": [ "allergiframkallande ämnen" ], "created_time": "2023-08-16T05:18:14.451683Z", "last_modified_time": "2023-08-16T05:18:14.451700Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "allergeenit", "sv": "allergener", "en": "allergens" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21057/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p342", "has_user_editable_resources": false, "alt_labels": [ "allergiat", "allergier" ], "created_time": "2023-08-16T05:18:20.309300Z", "last_modified_time": "2023-08-16T05:18:20.309319Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "allergia", "sv": "allergi", "en": "allergy" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p342/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "