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=231&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=232&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=230&show_all_keywords=True" }, "data": [ { "id": "yso:p25720", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:07.080642Z", "last_modified_time": "2023-08-16T05:07:07.080662Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "futuuri", "sv": "futurum", "en": "future tense" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25720/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15927", "has_user_editable_resources": false, "alt_labels": [ "futures contracts", "future", "futurekontrakt", "futures", "futurkontrakt" ], "created_time": "2023-08-16T05:09:20.851563Z", "last_modified_time": "2023-08-16T05:09:20.851582Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "futuurit", "sv": "futurer", "en": "futures" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15927/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16025", "has_user_editable_resources": false, "alt_labels": [ "fugatot", "fughetat" ], "created_time": "2023-08-16T05:15:16.820482Z", "last_modified_time": "2023-08-16T05:15:16.820500Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "fuugat", "sv": "fugor", "en": "fugues" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16025/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p26054", "has_user_editable_resources": false, "alt_labels": [ "fuusiovoima" ], "created_time": "2023-08-16T05:07:10.477887Z", "last_modified_time": "2023-08-16T05:07:10.477904Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "fuusioenergia", "sv": "fusionsenergi", "en": "fusion energy" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26054/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11367", "has_user_editable_resources": false, "alt_labels": [ "cross kitchen", "cross kitchen", "cross kitchen" ], "created_time": "2023-08-16T05:12:30.412525Z", "last_modified_time": "2023-08-16T05:12:30.412543Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "fuusiokeittiö", "sv": "fusionskök", "en": "fusion cuisine" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11367/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p7198", "has_user_editable_resources": false, "alt_labels": [ "jazz-rock", "jazz-rock", "popjazz", "jazzrock", "popjazz" ], "created_time": "2023-08-16T05:14:41.518502Z", "last_modified_time": "2023-08-16T05:14:41.518519Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "fuusiomusiikki", "sv": "fusionsmusik", "en": "fusion music" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7198/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19475", "has_user_editable_resources": false, "alt_labels": [ "fuusio (ydinreaktiot)", "ydinfuusio", "fusion (kärnfysik)", "fusionsreaktion", "kärnfusion" ], "created_time": "2023-08-16T05:09:51.566391Z", "last_modified_time": "2023-08-16T05:09:51.566409Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "fuusioreaktio", "sv": "fusion (kärnreaktioner)", "en": "nuclear fusion" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19475/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p28207", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:11:08.588080Z", "last_modified_time": "2023-08-16T05:11:08.588098Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "fylogenetiikka", "sv": "fylogenetik", "en": "phylogenetics" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28207/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p25760", "has_user_editable_resources": false, "alt_labels": [ "fylogeneesi", "fylogenes" ], "created_time": "2023-08-16T05:13:43.640656Z", "last_modified_time": "2023-08-16T05:13:43.640677Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "fylogenia", "sv": "fylogeni", "en": "phylogeny" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25760/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21715", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:23.504175Z", "last_modified_time": "2023-08-16T05:13:23.504193Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "fylogeografia", "sv": "fylogeografi", "en": "phylogeography" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21715/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10516", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:08:41.200383Z", "last_modified_time": "2023-08-16T05:08:41.200403Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "fysiatria", "sv": "fysiatri", "en": "physiatrics" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10516/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22485", "has_user_editable_resources": false, "alt_labels": [ "fysiatrar" ], "created_time": "2023-08-16T05:06:37.505050Z", "last_modified_time": "2023-08-16T05:06:37.505067Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "fysiatrit", "sv": "fysiatrer", "en": "physiatrists" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22485/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p20662", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:02.465209Z", "last_modified_time": "2023-08-16T05:10:02.465227Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "fysiikanopettajat", "sv": "fysiklärare", "en": "physics teachers" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20662/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p900", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:19:42.763529Z", "last_modified_time": "2023-08-16T05:19:42.763546Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "fysiikka", "sv": "fysik", "en": "physics" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p900/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p6533", "has_user_editable_resources": false, "alt_labels": [ "liiketerapia (fysikaalinen hoito)" ], "created_time": "2023-08-16T05:19:36.807716Z", "last_modified_time": "2023-08-16T05:19:36.807734Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "fysikaalinen hoito", "sv": "fysikalisk behandling", "en": "physical therapy" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6533/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p7202", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:18:26.943712Z", "last_modified_time": "2023-08-16T05:18:26.943730Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "fysikaalinen kemia", "sv": "fysikalisk kemi", "en": "physical chemistry" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7202/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15130", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:09:14.381826Z", "last_modified_time": "2023-08-16T05:09:14.381845Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "fysikaalinen torjunta", "sv": "fysikalisk bekämpning", "en": "physical control" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15130/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p949", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:19:44.554960Z", "last_modified_time": "2023-08-16T05:19:44.554978Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "fysikaaliset ilmiöt", "sv": "fysikaliska fenomen", "en": "physical phenomena" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p949/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p1174", "has_user_editable_resources": false, "alt_labels": [ "mechanic properties", "mekaaniset ominaisuudet", "mekaniska egenskaper" ], "created_time": "2023-08-16T05:19:45.223016Z", "last_modified_time": "2023-08-16T05:19:45.223034Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "fysikaaliset ominaisuudet", "sv": "fysikaliska egenskaper", "en": "physical properties" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1174/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p27715", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:19:47.902780Z", "last_modified_time": "2023-08-16T05:19:47.902796Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "fysikaaliset tapahtumat", "sv": "fysikaliska händelser", "en": "physical events" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27715/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "