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=1436&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1437&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1435&show_all_keywords=True" }, "data": [ { "id": "yso:p9113", "has_user_editable_resources": false, "alt_labels": [ "central government administration", "state administration" ], "created_time": "2023-08-16T05:18:47.349420Z", "last_modified_time": "2023-08-16T05:18:47.349436Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtionhallinto", "sv": "statsförvaltning", "en": "central government" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9113/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p18511", "has_user_editable_resources": false, "alt_labels": [ "valtiokirkko" ], "created_time": "2023-08-16T05:09:42.456030Z", "last_modified_time": "2023-08-16T05:09:42.456048Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtionkirkko", "sv": "statskyrka", "en": "state church" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18511/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12872", "has_user_editable_resources": false, "alt_labels": [ "government institutions", "state institutions" ], "created_time": "2023-08-16T05:08:57.375999Z", "last_modified_time": "2023-08-16T05:08:57.376023Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtion laitokset", "sv": "statliga inrättningar", "en": "state agencies" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12872/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15484", "has_user_editable_resources": false, "alt_labels": [ "state enterprises", "statens affärsverk" ], "created_time": "2023-08-16T05:12:52.545626Z", "last_modified_time": "2023-08-16T05:12:52.545655Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtion liikelaitokset", "sv": "statliga affärsverk", "en": "unincorporated state enterprises" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15484/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p14782", "has_user_editable_resources": false, "alt_labels": [ "statlig affärsverksamhet" ], "created_time": "2023-08-16T05:09:11.604568Z", "last_modified_time": "2023-08-16T05:09:11.604585Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtion liiketoiminta", "sv": "statens affärsverksamhet", "en": "state's business activities" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14782/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16040", "has_user_editable_resources": false, "alt_labels": [ "valtion maat" ], "created_time": "2023-08-16T05:16:43.706430Z", "last_modified_time": "2023-08-16T05:16:43.706463Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtionmaat", "sv": "statens mark", "en": "state lands" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16040/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5492", "has_user_editable_resources": false, "alt_labels": [ "statliga utgifter", "statsutgifter" ], "created_time": "2023-08-16T05:14:32.868117Z", "last_modified_time": "2023-08-16T05:14:32.868134Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtion menot", "sv": "statens utgifter", "en": "state expenditures" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5492/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11320", "has_user_editable_resources": false, "alt_labels": [ "valtion metsät" ], "created_time": "2023-08-16T05:17:31.260719Z", "last_modified_time": "2023-08-16T05:17:31.260741Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtionmetsät", "sv": "statens skogar", "en": "state forests" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11320/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p27426", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:15:46.706729Z", "last_modified_time": "2023-08-16T05:15:46.706746Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtionmuodostus", "sv": "statsbildning", "en": "state formation" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27426/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p26425", "has_user_editable_resources": false, "alt_labels": [ "valtion ohjaus", "statsstyrning" ], "created_time": "2023-08-16T05:07:13.974239Z", "last_modified_time": "2023-08-16T05:07:13.974298Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtionohjaus", "sv": "statlig styrning", "en": "state ownership steering" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26425/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p6184", "has_user_editable_resources": false, "alt_labels": [ "statutory government contributions" ], "created_time": "2023-08-16T05:14:36.318851Z", "last_modified_time": "2023-08-16T05:14:36.318871Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtionosuudet", "sv": "statsandelar", "en": "central government transfers to local government" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6184/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p13285", "has_user_editable_resources": false, "alt_labels": [ "state local administration" ], "created_time": "2023-08-16T05:19:24.436702Z", "last_modified_time": "2023-08-16T05:19:24.436718Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtion paikallishallinto", "sv": "statens lokalförvaltning", "en": "state local government" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13285/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22539", "has_user_editable_resources": false, "alt_labels": [ "statliga pris" ], "created_time": "2023-08-16T05:06:38.185894Z", "last_modified_time": "2023-08-16T05:06:38.185915Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtionpalkinnot", "sv": "statspriser", "en": "state prizes" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22539/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p8251", "has_user_editable_resources": false, "alt_labels": [ "valtion päämiehet", "statschefer" ], "created_time": "2023-08-16T05:17:22.904133Z", "last_modified_time": "2023-08-16T05:17:22.904151Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtionpäämiehet", "sv": "statsöverhuvud", "en": "heads of state" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8251/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p13650", "has_user_editable_resources": false, "alt_labels": [ "kansallinen oikeus", "nationell rätt" ], "created_time": "2023-08-16T05:05:19.578638Z", "last_modified_time": "2023-08-16T05:05:19.578657Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtionsisäinen oikeus", "sv": "inomstatlig rätt", "en": "internal law of a state" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13650/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p6891", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:16:18.550233Z", "last_modified_time": "2023-08-16T05:16:18.550251Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtiontakaus", "sv": "statsgaranti", "en": "state guarantee" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6891/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19008", "has_user_editable_resources": false, "alt_labels": [ "Jyväskylä Defence Corps Building", "Jyväskylän suojeluskuntatalo", "Jyväskylän suojeluskuntatalo" ], "created_time": "2023-08-16T05:09:46.714775Z", "last_modified_time": "2023-08-16T05:09:46.714792Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Valtiontalo (Jyväskylä)", "en": "Valtiontalo (Jyväskylä)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19008/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11859", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:33.333441Z", "last_modified_time": "2023-08-16T05:12:33.333460Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtiontalouden tarkastus", "sv": "revision av statshushållningen", "en": "national audit" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11859/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15617", "has_user_editable_resources": false, "alt_labels": [ "statsfinanser", "central government finances", "state economy", "statlig ekonomi", "statshushållning" ], "created_time": "2023-08-16T05:17:37.273611Z", "last_modified_time": "2023-08-16T05:17:37.273628Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtiontalous", "sv": "statsekonomi", "en": "state finances" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15617/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15164", "has_user_editable_resources": false, "alt_labels": [ "government budgets", "valtion tulo- ja menoarviot", "statsbudgetar", "statsbudgeten" ], "created_time": "2023-08-16T05:17:36.683661Z", "last_modified_time": "2023-08-16T05:17:36.683686Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "valtion talousarviot", "sv": "statsbudgeter", "en": "budgets (governmental)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15164/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31685, "next": "