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=63&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=64&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=62&show_all_keywords=True" }, "data": [ { "id": "yso:p13052", "has_user_editable_resources": false, "alt_labels": [ "curriculum vitae", "CV", "c. v.", "curriculum vitae", "CV", "c. v.", "curriculum vitae" ], "created_time": "2023-08-16T05:08:58.749012Z", "last_modified_time": "2023-08-16T05:08:58.749030Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ansioluettelot", "sv": "meritförteckningar", "en": "resumes (employment)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13052/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p4348", "has_user_editable_resources": false, "alt_labels": [ "commemorative crosses", "ansiomitalit", "muistoristit", "förtjänstmedaljer", "förtjänsttecken", "minneskors (utmärkelsetecken)" ], "created_time": "2023-08-16T05:16:09.363079Z", "last_modified_time": "2023-08-16T05:16:09.363097Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ansiomerkit", "sv": "utmärkelsetecken", "en": "medals for merit" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4348/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39101", "has_user_editable_resources": false, "alt_labels": [ "ansiosidonnainen päiväraha", "ansiosidonnainen työttömyyspäiväraha", "dagpenning avvägd enligt förtjänsten", "förtjänstrelaterad dagpenning" ], "created_time": "2023-08-16T05:08:02.409063Z", "last_modified_time": "2023-08-16T05:08:02.409083Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ansiopäiväraha", "sv": "inkomstrelaterad dagpenning", "en": "earnings-related unemployment allowance" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39101/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39698", "has_user_editable_resources": false, "alt_labels": [ "kunniaritarikunnat", "ritarikunnat (ansioritarikunnat)", "riddarordnar (förtjänstordnar)", "orders of chivalry" ], "created_time": "2023-08-16T05:11:50.539449Z", "last_modified_time": "2023-08-16T05:11:50.539475Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ansioritarikunnat", "sv": "förtjänstordnar", "en": "orders of merit" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39698/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3481", "has_user_editable_resources": false, "alt_labels": [ "earnings level", "income level", "level of earnings", "level of income", "salary level", "palkkataso", "palkkaus", "avlöning (lönenivå)", "förtjänstnivå", "löneläge" ], "created_time": "2023-08-16T05:19:25.666083Z", "last_modified_time": "2023-08-16T05:19:25.666100Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ansiotaso", "sv": "lönenivå", "en": "wage level" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3481/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p13961", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:17:35.007970Z", "last_modified_time": "2023-08-16T05:17:35.007990Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ansiotulot", "sv": "förvärvsinkomster", "en": "earned income" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13961/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p14103", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:09:06.326776Z", "last_modified_time": "2023-08-16T05:09:06.326794Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ansioturva", "sv": "inkomsttrygghet", "en": "compensation for loss of earnings" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14103/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p9254", "has_user_editable_resources": false, "alt_labels": [ "förtjänstarbete" ], "created_time": "2023-08-16T05:16:27.666527Z", "last_modified_time": "2023-08-16T05:16:27.666544Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ansiotyö", "sv": "förvärvsarbete", "en": "gainful employment" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9254/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12432", "has_user_editable_resources": false, "alt_labels": [ "antarktiska området" ], "created_time": "2023-08-16T05:16:36.524762Z", "last_modified_time": "2023-08-16T05:16:36.524780Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "antarktinen alue", "sv": "antarktiska regionen", "en": "antarctic zone" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12432/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29484", "has_user_editable_resources": false, "alt_labels": [ "surrender", "kapitulaatio", "kapitulering" ], "created_time": "2023-08-16T05:14:03.905861Z", "last_modified_time": "2023-08-16T05:14:03.905880Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "antautuminen", "sv": "kapitulation", "en": "capitulation" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29484/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5253", "has_user_editable_resources": false, "alt_labels": [ "anteeksiantaminen", "anteeksiantamus" ], "created_time": "2023-08-16T05:18:56.559853Z", "last_modified_time": "2023-08-16T05:18:56.559871Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "anteeksianto", "sv": "förlåtelse", "en": "forgiveness" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5253/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p20832", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:18.374689Z", "last_modified_time": "2023-08-16T05:13:18.374706Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "anteeksipyyntö", "sv": "ursäkt", "en": "apology" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20832/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p9623", "has_user_editable_resources": false, "alt_labels": [ "generositet" ], "created_time": "2023-08-16T05:12:21.668527Z", "last_modified_time": "2023-08-16T05:12:21.668546Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "anteliaisuus", "sv": "givmildhet", "en": "generosity" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9623/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16154", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:56.109166Z", "last_modified_time": "2023-08-16T05:12:56.109184Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "antennijärjestelmät", "sv": "antennsystem", "en": "antenna systems" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16154/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16153", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:56.090953Z", "last_modified_time": "2023-08-16T05:12:56.090970Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "antennit", "sv": "antenner", "en": "antennas" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16153/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p37999", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:14:13.242664Z", "last_modified_time": "2023-08-16T05:14:13.242682Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "anthemit", "sv": "anthems", "en": "anthems" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p37999/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22254", "has_user_editable_resources": false, "alt_labels": [ "amerikkalaisvastaisuus" ], "created_time": "2023-08-16T05:10:16.517587Z", "last_modified_time": "2023-08-16T05:10:16.517605Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "antiamerikkalaisuus", "sv": "antiamerikanism", "en": "anti-Americanism" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22254/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38644", "has_user_editable_resources": false, "alt_labels": [ "androgen antagonists", "androgeeniantagonistit", "androgenantagonister", "androgenblockerare" ], "created_time": "2023-08-16T05:14:16.501922Z", "last_modified_time": "2023-08-16T05:14:16.501942Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "antiandrogeenit", "sv": "antiandrogener", "en": "antiandrogens" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38644/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10820", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:18:32.115697Z", "last_modified_time": "2023-08-16T05:18:32.115716Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "antibiootit", "sv": "antibiotika", "en": "antibiotics" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10820/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29640", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:41.212628Z", "last_modified_time": "2023-08-16T05:07:41.212654Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "antibioottiresistenssi", "sv": "antibiotikaresistens", "en": "antibiotic resistance" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29640/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "