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=40&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=41&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=39&show_all_keywords=True" }, "data": [ { "id": "yso:p28522", "has_user_editable_resources": false, "alt_labels": [ "Aleuttien minkkitauti", "aleutiantauti" ], "created_time": "2023-08-16T05:15:50.356963Z", "last_modified_time": "2023-08-16T05:15:50.356981Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Aleutian tauti", "sv": "aleutisk minksjukdom", "en": "Aleutian disease" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28522/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p24283", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:54.437916Z", "last_modified_time": "2023-08-16T05:06:54.437940Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aleutin kieli", "sv": "aleutiska", "en": "Aleut language" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24283/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p25233", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:43.898690Z", "last_modified_time": "2023-08-16T05:10:43.898709Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aleutit (kansat)", "sv": "aleuter", "en": "Aleuts" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25233/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19156", "has_user_editable_resources": false, "alt_labels": [ "Aleksanteri-tekniikka" ], "created_time": "2023-08-16T05:09:48.230485Z", "last_modified_time": "2023-08-16T05:09:48.230503Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Alexander-tekniikka", "sv": "Alexanderteknik", "en": "Alexander technique" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19156/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40768", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2025-03-15T04:41:04.012395Z", "last_modified_time": "2025-04-03T04:40:16.223342Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alfahajoaminen", "sv": "alfasönderfall", "en": "alpha decay" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40768/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38904", "has_user_editable_resources": false, "alt_labels": [ "alfa-linoleenihappo", "alfalinolensyra" ], "created_time": "2023-08-16T05:11:42.601005Z", "last_modified_time": "2023-08-16T05:11:42.601023Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alfalinoleenihappo", "sv": "alfa-linolensyra", "en": "alpha-linolenic acid" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38904/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p24404", "has_user_editable_resources": false, "alt_labels": [ "alfa-synuklein", "α-synuklein" ], "created_time": "2023-08-16T05:13:36.912515Z", "last_modified_time": "2024-03-27T04:41:07.507710Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alfasynukleiini", "sv": "alfasynuklein", "en": "alpha-synuclein" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24404/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11010", "has_user_editable_resources": false, "alt_labels": [ "α-strålning" ], "created_time": "2023-08-16T05:08:44.389192Z", "last_modified_time": "2023-08-16T05:08:44.389209Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alfasäteily", "sv": "alfastrålning", "en": "alpha radiation" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11010/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22268", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:16.632350Z", "last_modified_time": "2023-08-16T05:10:16.632379Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alfavirukset", "sv": "alfavirus", "en": "alphaviruses" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22268/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12498", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:15:04.845137Z", "last_modified_time": "2023-08-16T05:15:04.845155Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "algebra", "en": "algebra" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12498/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p27954", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:55.552685Z", "last_modified_time": "2023-08-16T05:13:55.552703Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "algebrallinen topologia", "sv": "algebraisk topologi", "en": "algebraic topology" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27954/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39727", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:08:09.137182Z", "last_modified_time": "2023-08-16T05:08:09.137208Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "algerialaiset", "sv": "algerier", "en": "Algerians" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39727/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15387", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:32.553617Z", "last_modified_time": "2023-08-16T05:05:32.553635Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Algerian sota", "sv": "Algerietrevolten", "en": "Algerian War" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15387/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40666", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2025-03-27T04:40:26.106174Z", "last_modified_time": "2025-03-27T04:40:26.106185Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "algilaiset kielet", "sv": "algiska språk", "en": "Algic languages" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40666/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38349", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:54.362989Z", "last_modified_time": "2023-08-16T05:07:54.363017Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Algol", "en": "Algol" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38349/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40192", "has_user_editable_resources": false, "alt_labels": [ "algonkinska språk", "Algonkian languages" ], "created_time": "2023-10-18T04:40:21.273990Z", "last_modified_time": "2023-10-26T04:40:51.908418Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "algonkin-kielet", "sv": "algonkinspråk", "en": "Algonquian languages" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40192/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3365", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:11:29.001741Z", "last_modified_time": "2023-08-16T05:11:29.001759Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "algoritmiikka", "sv": "algoritmik", "en": "algorithmics" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3365/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p14524", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:16:41.055751Z", "last_modified_time": "2023-08-16T05:16:41.055770Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "algoritmit", "sv": "algoritmer", "en": "algorithms" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14524/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12195", "has_user_editable_resources": false, "alt_labels": [ "kylmän ilmanalan tutkimus", "matalien lämpötilojen tutkimus" ], "created_time": "2023-08-16T05:16:36.118355Z", "last_modified_time": "2023-08-16T05:16:36.118374Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alhaisen lämpötilan tutkimus", "sv": "lågtemperaturforskning", "en": "low temperature research" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12195/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p9263", "has_user_editable_resources": false, "alt_labels": [ "osahankinta", "osavalmistus" ], "created_time": "2023-08-16T05:14:51.537422Z", "last_modified_time": "2023-08-16T05:14:51.537438Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "alihankinta", "sv": "underleverans", "en": "subcontracting (acquisition)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9263/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "