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=261&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=262&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=260&show_all_keywords=True" }, "data": [ { "id": "yso:p9981", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:17:28.767657Z", "last_modified_time": "2023-08-16T05:17:28.767673Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "hammasvalaat", "sv": "tandvalar", "en": "toothed whales" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9981/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p26492", "has_user_editable_resources": false, "alt_labels": [ "Hammurabin laki", "Hammurabis lagar" ], "created_time": "2023-08-16T05:10:54.989335Z", "last_modified_time": "2023-08-16T05:10:54.989355Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Hammurabin lait", "sv": "Hammurabis lag", "en": "Code of Hammurabi" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26492/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21342", "has_user_editable_resources": false, "alt_labels": [ "hampaan juuret", "tandroten", "tandrötter" ], "created_time": "2023-08-16T05:13:21.374735Z", "last_modified_time": "2023-08-16T05:13:21.374760Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "hampaan juuri", "sv": "tandrot", "en": "tooth root" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21342/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15304", "has_user_editable_resources": false, "alt_labels": [ "oikomishoito", "ortodontia", "ortodonti" ], "created_time": "2023-08-16T05:09:15.592337Z", "last_modified_time": "2023-08-16T05:09:15.592355Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "hampaanoionta", "sv": "tandreglering", "en": "orthodontics" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15304/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p28297", "has_user_editable_resources": false, "alt_labels": [ "hampaanpaikkaus", "hampaiden paikkaus", "paikkaus (hampaat)", "plombering", "tandfyllning" ], "created_time": "2023-08-16T05:15:49.501851Z", "last_modified_time": "2023-08-16T05:15:49.501870Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "hampaan paikkaus", "sv": "tandlagning", "en": "dental restoration" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28297/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2205", "has_user_editable_resources": false, "alt_labels": [ "tänderna" ], "created_time": "2023-08-16T05:18:51.999641Z", "last_modified_time": "2023-08-16T05:18:51.999660Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "hampaat", "sv": "tänder", "en": "teeth" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2205/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10478", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:08:40.898528Z", "last_modified_time": "2023-08-16T05:08:40.898553Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "hampaattomuus", "sv": "tandlöshet", "en": "toothlessness" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10478/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15843", "has_user_editable_resources": false, "alt_labels": [ "hammashygienia", "tandhygien", "tandskötsel" ], "created_time": "2023-08-16T05:15:16.223992Z", "last_modified_time": "2023-08-16T05:15:16.224009Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "hampaidenhoito", "sv": "tandvård (hygien)", "en": "dental hygiene" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15843/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p24764", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:39.311722Z", "last_modified_time": "2023-08-16T05:10:39.311750Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "hampaidenvalkaisu", "sv": "tandblekning", "en": "dental bleaching" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24764/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10690", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:19:08.440366Z", "last_modified_time": "2023-08-16T05:19:08.440387Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "hamppu", "sv": "hampa", "en": "hemp" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10690/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10691", "has_user_editable_resources": false, "alt_labels": [ "hampväxter" ], "created_time": "2023-08-16T05:16:32.014468Z", "last_modified_time": "2023-08-16T05:16:32.014486Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "hamppukasvit", "sv": "hampaväxter", "en": "Cannabaceae" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10691/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19896", "has_user_editable_resources": false, "alt_labels": [ "burgers", "burgerit", "burgare" ], "created_time": "2023-08-16T05:09:55.420831Z", "last_modified_time": "2023-08-16T05:09:55.420850Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "hampurilaiset", "sv": "hamburgare", "en": "hamburgers" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19896/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19292", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:11.719234Z", "last_modified_time": "2023-08-16T05:13:11.719251Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "hamsterit", "sv": "hamstrar", "en": "hamsters" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19292/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p27559", "has_user_editable_resources": false, "alt_labels": [ "hamstraaminen", "keräilypakko", "pakonomainen keräily", "disposofobi", "hamstrande", "patologiskt samlande", "samlarsjuka", "samlarsyndrom" ], "created_time": "2023-08-16T05:11:03.490585Z", "last_modified_time": "2023-08-16T05:11:03.490603Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "hamstraus", "sv": "hamstring", "en": "hoarding" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27559/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3565", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:14:10.454057Z", "last_modified_time": "2023-08-16T05:14:10.454072Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "hanat", "sv": "kranar", "en": "faucets" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3565/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39661", "has_user_editable_resources": false, "alt_labels": [ "Handle" ], "created_time": "2023-08-16T05:11:50.187689Z", "last_modified_time": "2023-08-16T05:11:50.187711Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Handle-tunnus", "sv": "Handle (identifikatorer)", "en": "Handle (identifiers)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39661/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p4361", "has_user_editable_resources": false, "alt_labels": [ "hands free -toiminto", "kädet vapaana -toiminto" ], "created_time": "2023-08-16T05:11:55.807849Z", "last_modified_time": "2023-08-16T05:11:55.807867Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "handsfree-toiminto", "sv": "handsfree", "en": "hands free" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4361/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p20903", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:04.101916Z", "last_modified_time": "2023-08-16T05:10:04.101940Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Hangon kirkko", "sv": "Hangö kyrka", "en": "Hanko Church" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20903/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p8344", "has_user_editable_resources": false, "alt_labels": [ "Anserinae" ], "created_time": "2023-08-16T05:16:23.973016Z", "last_modified_time": "2023-08-16T05:16:23.973032Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "hanhet", "sv": "gäss", "en": "geese" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8344/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22920", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:41.408414Z", "last_modified_time": "2024-09-01T04:40:23.505575Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "hankajalkaiset", "sv": "hoppkräftor", "en": "Copepoda" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22920/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31684, "next": "