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 /linkedevents/v1/keyword/?format=api&page=138
http://api.hel.fi/linkedevents/v1/keyword/?format=api&page=139", "previous": "http://api.hel.fi/linkedevents/v1/keyword/?format=api&page=137" }, "data": [ { "id": "yso:p1653", "alt_labels": [ "ritt", "equestrian sports", "ridsport", "equestrianism", "horseback riding", "ratsastusurheilu" ], "created_time": "2014-06-23T11:37:26.223000Z", "last_modified_time": "2017-09-06T05:20:49.930631Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ratsastus", "sv": "ridning", "en": "horse riding" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p1653/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p7957", "alt_labels": [], "created_time": "2014-06-23T11:37:29.862000Z", "last_modified_time": "2017-09-06T05:20:55.578848Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "rauha", "sv": "fred", "en": "peace" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p7957/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p18807", "alt_labels": [], "created_time": "2014-06-23T11:37:29.045000Z", "last_modified_time": "2017-09-06T05:20:40.821133Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ravintola-ala", "sv": "restaurangbranschen", "en": "restaurant sector (lines of business)" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p18807/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16147", "alt_labels": [ "nutritionists (authorised)", "dietister", "nutritionister" ], "created_time": "2014-06-23T11:37:25.048000Z", "last_modified_time": "2017-09-06T05:20:38.490477Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ravitsemusterapeutit", "sv": "näringsterapeuter", "en": "dietitians" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p16147/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p14430", "alt_labels": [ "rekat", "trailer trucks", "reckor" ], "created_time": "2014-06-23T11:37:30.581000Z", "last_modified_time": "2017-09-06T05:19:59.328641Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "rekka-autot", "sv": "långtradare", "en": "trailer lorries" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p14430/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19741", "alt_labels": [ "dödsmässor", "sielunmessut", "själamässor", "missa pro defunctis", "requiem" ], "created_time": "2014-06-23T11:37:30.337000Z", "last_modified_time": "2017-09-06T05:20:20.625680Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "requiemit", "sv": "rekviem", "en": "requiems" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p19741/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p26972", "alt_labels": [], "created_time": "2014-06-23T11:37:24.407000Z", "last_modified_time": "2017-09-06T05:21:07.120475Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "retro", "sv": "retro", "en": "retro" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p26972/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p26379", "alt_labels": [], "created_time": "2014-06-23T11:37:24.061000Z", "last_modified_time": "2017-09-06T05:19:57.603548Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "retrospektiivit", "sv": "retrospektiv", "en": "retrospectives" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p26379/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p9414", "alt_labels": [ "addiktio", "addiktion", "avhängighet", "dependency" ], "created_time": "2014-06-23T11:37:23.853000Z", "last_modified_time": "2017-09-06T05:20:38.321671Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "riippuvuus", "sv": "beroende", "en": "addiction" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p9414/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p14069", "alt_labels": [ "brösten", "kvinnobröst" ], "created_time": "2014-06-23T11:37:30.993000Z", "last_modified_time": "2017-09-06T05:20:08.960497Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "rinnat", "sv": "bröst (brösten)", "en": "breasts" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p14069/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p4347", "alt_labels": [ "pinssit", "rintanapit", "pins", "buttons", "pins" ], "created_time": "2014-06-23T11:37:28.542000Z", "last_modified_time": "2017-09-06T05:20:15.350522Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "rintamerkit", "sv": "rockmärken", "en": "badges, buttons and pins" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p4347/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p30084", "alt_labels": [ "rock and roll", "rock 'n' roll", "rockenroll", "rocknroll", "rock 'n' roll", "rock'n'roll" ], "created_time": "2017-12-20T05:20:05.481069Z", "last_modified_time": "2018-01-09T05:20:09.584529Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "rock and roll", "sv": "rock'n'roll", "en": "rock and roll music" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p30084/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10737", "alt_labels": [], "created_time": "2014-06-23T11:37:28.896000Z", "last_modified_time": "2017-09-06T05:20:24.336722Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "rohkeus", "sv": "mod", "en": "courage" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p10737/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p7631", "alt_labels": [], "created_time": "2014-06-23T11:37:26.610000Z", "last_modified_time": "2017-09-06T05:20:08.391648Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "rokokoo", "sv": "rokoko", "en": "rococo" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p7631/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p7523", "alt_labels": [ "vaccination" ], "created_time": "2014-06-23T11:37:24.104000Z", "last_modified_time": "2017-09-06T05:20:56.004952Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "rokotus", "sv": "vaccinering", "en": "vaccination" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p7523/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p27323", "alt_labels": [], "created_time": "2014-06-23T11:37:29.399000Z", "last_modified_time": "2017-09-06T05:20:00.330879Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "roller derby", "sv": "roller derby" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p27323/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p670", "alt_labels": [], "created_time": "2014-06-23T11:37:24.534000Z", "last_modified_time": "2017-09-06T05:21:12.747728Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "romanialaiset", "sv": "rumäner", "en": "Romanians" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p670/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19958", "alt_labels": [ "Gypsy music", "romsk musik", "mustalaismusiikki", "viihteellinen romanimusiikki", "zigensk musik (underhållningsmusik)", "zigenarmusik (underhållningsmusik)", "Gypsy style" ], "created_time": "2014-06-23T11:37:28.554000Z", "last_modified_time": "2020-03-22T02:39:54.790274Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "romanimusiikki (viihdemusiikki)", "sv": "romsk musik (underhållningsmusik)", "en": "Romani music (popular music)" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p19958/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p7504", "alt_labels": [ "romanssit", "romances (music)" ], "created_time": "2018-08-15T02:20:21.743727Z", "last_modified_time": "2018-08-15T02:20:21.744090Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "romanssit (sävellykset)", "sv": "romanser (kompositioner)", "en": "romances (compositions)" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p7504/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2482", "alt_labels": [], "created_time": "2014-06-23T11:37:27.084000Z", "last_modified_time": "2017-09-06T05:20:23.271726Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "roolimallit", "sv": "rollmodeller", "en": "role models" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/yso:p2482/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 3499, "next": "