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=1556&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1557&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1555&show_all_keywords=True" }, "data": [ { "id": "yso:p3221", "has_user_editable_resources": false, "alt_labels": [ "poströstning", "valdeltagande", "votering" ], "created_time": "2023-08-16T05:18:39.846114Z", "last_modified_time": "2023-08-16T05:18:39.846146Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "äänestäminen", "sv": "röstning", "en": "voting" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3221/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29792", "has_user_editable_resources": false, "alt_labels": [ "registers (vocal)", "lauluäänet", "register (röst)", "röstfack", "röstlägen" ], "created_time": "2023-08-16T05:19:10.631922Z", "last_modified_time": "2023-08-16T05:19:10.631940Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "äänialat", "sv": "sångstämmor", "en": "vocal registers" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29792/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19521", "has_user_editable_resources": false, "alt_labels": [ "audio archives", "nauhoitearkistot", "äänitearkistot", "bandarkiv" ], "created_time": "2023-08-16T05:13:12.765810Z", "last_modified_time": "2023-08-16T05:13:12.765828Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ääniarkistot", "sv": "ljudarkiv", "en": "sound archives" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19521/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p8982", "has_user_editable_resources": false, "alt_labels": [ "puhe-elimet", "röst- och talorganen" ], "created_time": "2023-08-16T05:16:26.296709Z", "last_modified_time": "2023-08-16T05:16:26.296727Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "äänielimet", "sv": "röst- och talorgan", "en": "vocal organs" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8982/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29617", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:40.989734Z", "last_modified_time": "2023-08-16T05:07:40.989762Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "äänielokuvat", "sv": "ljudfilmer", "en": "sound films" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29617/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p4572", "has_user_editable_resources": false, "alt_labels": [ "sounds", "äänet" ], "created_time": "2023-08-16T05:18:55.890810Z", "last_modified_time": "2023-08-16T05:18:55.890829Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ääni (fysikaaliset ilmiöt)", "sv": "ljud", "en": "sound (physical phenomena)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4572/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15708", "has_user_editable_resources": false, "alt_labels": [ "voice physiology" ], "created_time": "2023-08-16T05:09:19.174759Z", "last_modified_time": "2023-08-16T05:09:19.174783Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "äänifysiologia", "sv": "röstfysiologi", "en": "vocal physiology" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15708/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p986", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:18:47.734351Z", "last_modified_time": "2023-08-16T05:18:47.734369Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ääniharjoitukset", "sv": "röstövningar", "en": "vocal exercises" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p986/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22694", "has_user_editable_resources": false, "alt_labels": [ "vocal folds", "stämbanden", "stämläppar" ], "created_time": "2023-08-16T05:10:20.598548Z", "last_modified_time": "2023-08-16T05:10:20.598566Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "äänihuulet", "sv": "stämband", "en": "vocal cords" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22694/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15560", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:52.854842Z", "last_modified_time": "2023-08-16T05:12:52.854865Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "äänihäiriöt", "sv": "röstrubbningar", "en": "voice disorders" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15560/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38058", "has_user_editable_resources": false, "alt_labels": [ "rösten", "röster" ], "created_time": "2023-08-16T05:17:06.846679Z", "last_modified_time": "2023-08-16T05:17:06.846697Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ääni (ihmisääni)", "sv": "röst", "en": "voice" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38058/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12688", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:15:05.615027Z", "last_modified_time": "2023-08-16T05:15:05.615047Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "äänikasetit", "sv": "ljudkassetter", "en": "audio cassettes" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12688/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p25752", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:48.615331Z", "last_modified_time": "2023-08-16T05:10:48.615351Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "äänikerronta", "sv": "ljudberättande", "en": "sound narrative" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25752/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p25071", "has_user_editable_resources": false, "alt_labels": [ "e-audiobooks", "e-äänikirjat", "kasettikirjat", "e-ljudböcker", "hörböcker", "kassettböcker" ], "created_time": "2023-08-16T05:18:37.855505Z", "last_modified_time": "2023-08-16T05:18:37.855523Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "äänikirjat", "sv": "ljudböcker", "en": "audiobooks" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25071/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5778", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:08:19.046285Z", "last_modified_time": "2023-08-16T05:08:19.046307Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "äänikortit", "sv": "ljudkort", "en": "sound cards" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5778/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38385", "has_user_editable_resources": false, "alt_labels": [ "announcements (audio)", "kuulutukset (äänikuulutukset)", "högtalarutrop" ], "created_time": "2023-08-16T05:14:15.243461Z", "last_modified_time": "2023-08-16T05:14:15.243480Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "äänikuulutukset", "sv": "ljudutrop", "en": "audio announcements" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38385/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p20661", "has_user_editable_resources": false, "alt_labels": [ "rösttröskel", "spärr (val)", "valtröskel" ], "created_time": "2023-08-16T05:10:02.443624Z", "last_modified_time": "2023-08-16T05:10:02.443642Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "äänikynnys", "sv": "spärrgräns", "en": "election threshold" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20661/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15836", "has_user_editable_resources": false, "alt_labels": [ "kasettilehdet", "kassettidningar", "taltidskrifter" ], "created_time": "2023-08-16T05:05:36.688966Z", "last_modified_time": "2023-08-16T05:05:36.688998Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "äänilehdet", "sv": "taltidningar", "en": "audio magazines" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15836/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p17544", "has_user_editable_resources": false, "alt_labels": [ "gramophone records", "records (phonograph records)", "vinyl records", "LP-levyt", "LP-äänilevyt", "gramofonilevyt", "levyt (äänilevyt)", "savikiekot", "vinyylilevyt", "LP-skivor", "skivor (grammofonskivor)", "stenkakor", "vinylskivor" ], "created_time": "2023-08-16T05:09:33.826634Z", "last_modified_time": "2023-08-16T05:09:33.826652Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "äänilevyt", "sv": "grammofonskivor", "en": "phonograph records" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17544/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p1715", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:16:45.359387Z", "last_modified_time": "2023-08-16T05:16:45.359405Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "äänimaisema", "sv": "ljudlandskap", "en": "soundscape" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1715/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "