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=173
http://api.hel.fi/linkedevents/v1/keyword/?format=api&page=174", "previous": "http://api.hel.fi/linkedevents/v1/keyword/?format=api&page=172" }, "data": [ { "id": "helfi:12", "alt_labels": [], "created_time": "2015-01-13T12:00:00Z", "last_modified_time": "2015-01-13T12:00:00Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 22813, "image": null, "data_source": "helfi", "publisher": null, "replaced_by": null, "name": { "fi": "Kulttuuri ja vapaa-aika", "sv": "Kultur och fritid", "en": "Culture and leisure" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/helfi:12/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helfi:11", "alt_labels": [], "created_time": "2015-01-13T12:00:00Z", "last_modified_time": "2015-01-13T12:00:00Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 12740, "image": null, "data_source": "helfi", "publisher": null, "replaced_by": null, "name": { "fi": "Päivähoito ja koulutus", "sv": "Dagvård och utbildning", "en": "Daycare and education" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/helfi:11/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helfi:1", "alt_labels": [], "created_time": "2015-01-13T12:00:00Z", "last_modified_time": "2015-01-13T12:00:00Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 12369, "image": null, "data_source": "helfi", "publisher": null, "replaced_by": null, "name": { "fi": "Lapset ja lapsiperheet", "sv": "Barn och barnfamiljer", "en": "Children and families" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/helfi:1/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helfi:9", "alt_labels": [], "created_time": "2015-01-13T12:00:00Z", "last_modified_time": "2015-01-13T12:00:00Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 8931, "image": null, "data_source": "helfi", "publisher": null, "replaced_by": null, "name": { "fi": "Sosiaali- ja terveyspalvelut", "sv": "Social- och hälsovård", "en": "Social services and health care" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/helfi:9/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helfi:5", "alt_labels": [], "created_time": "2015-01-13T12:00:00Z", "last_modified_time": "2015-01-13T12:00:00Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 5247, "image": null, "data_source": "helfi", "publisher": null, "replaced_by": null, "name": { "fi": "Vanhukset", "sv": "Äldre", "en": "Elderly" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/helfi:5/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helfi:3", "alt_labels": [], "created_time": "2015-01-13T12:00:00Z", "last_modified_time": "2015-01-13T12:00:00Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1350, "image": null, "data_source": "helfi", "publisher": null, "replaced_by": null, "name": { "fi": "Maahanmuuttajat", "sv": "Invandrare", "en": "Immigrants" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/helfi:3/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helfi:13", "alt_labels": [], "created_time": "2015-01-13T12:00:00Z", "last_modified_time": "2015-01-13T12:00:00Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 803, "image": null, "data_source": "helfi", "publisher": null, "replaced_by": null, "name": { "fi": "Asuminen ja ympäristö", "sv": "Boende och miljö", "en": "Housing and environment" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/helfi:13/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helfi:2", "alt_labels": [], "created_time": "2015-01-13T12:00:00Z", "last_modified_time": "2015-01-13T12:00:00Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 498, "image": null, "data_source": "helfi", "publisher": null, "replaced_by": null, "name": { "fi": "Nuoret", "sv": "Unga", "en": "Youth" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/helfi:2/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helfi:8", "alt_labels": [], "created_time": "2015-01-13T12:00:00Z", "last_modified_time": "2015-01-13T12:00:00Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 263, "image": null, "data_source": "helfi", "publisher": null, "replaced_by": null, "name": { "fi": "Kaupunki ja hallinto", "sv": "Staden och förvaltning", "en": "City administration" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/helfi:8/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helfi:4", "alt_labels": [], "created_time": "2015-01-13T12:00:00Z", "last_modified_time": "2015-01-13T12:00:00Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 258, "image": null, "data_source": "helfi", "publisher": null, "replaced_by": null, "name": { "fi": "Vammaiset", "sv": "Funktionshindrade", "en": "Disabled" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/helfi:4/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helfi:6", "alt_labels": [], "created_time": "2015-01-13T12:00:00Z", "last_modified_time": "2015-01-13T12:00:00Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 135, "image": null, "data_source": "helfi", "publisher": null, "replaced_by": null, "name": { "fi": "Yritykset", "sv": "Företagare", "en": "Entrepreneurs" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/helfi:6/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helfi:10", "alt_labels": [], "created_time": "2015-01-13T12:00:00Z", "last_modified_time": "2015-01-13T12:00:00Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 121, "image": null, "data_source": "helfi", "publisher": null, "replaced_by": null, "name": { "fi": "Liikenne ja kartat", "sv": "Kartor och trafik", "en": "Maps and transport" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/helfi:10/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helfi:7", "alt_labels": [], "created_time": "2015-01-13T12:00:00Z", "last_modified_time": "2015-01-13T12:00:00Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 116, "image": null, "data_source": "helfi", "publisher": null, "replaced_by": null, "name": { "fi": "Yhdistykset", "sv": "Föreningar", "en": "Associations" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/helfi:7/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "espoo_le:aggh5gwljq", "alt_labels": [], "created_time": "2023-12-18T20:25:23.022381Z", "last_modified_time": "2023-12-18T20:25:23.022424Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 645, "image": null, "data_source": "espoo_le", "publisher": null, "replaced_by": null, "name": { "fi": "Leppävaara", "sv": "Alberga", "en": "Leppävaara" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwljq/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "espoo_le:aggh5gwmlm", "alt_labels": [], "created_time": "2023-12-18T20:25:23.293959Z", "last_modified_time": "2023-12-18T20:25:23.293975Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 559, "image": null, "data_source": "espoo_le", "publisher": null, "replaced_by": null, "name": { "fi": "lapsiperheet", "sv": "barnfamiljer", "en": "families" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwmlm/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "espoo_le:aggh5gwlgm", "alt_labels": [], "created_time": "2023-12-18T20:25:22.997752Z", "last_modified_time": "2023-12-18T20:25:22.997768Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 371, "image": null, "data_source": "espoo_le", "publisher": null, "replaced_by": null, "name": { "fi": "Espoonlahti", "sv": "Esboviken", "en": "Espoonlahti" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwlgm/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "espoo_le:aggh5gwlfu", "alt_labels": [], "created_time": "2023-12-18T20:25:22.991565Z", "last_modified_time": "2023-12-18T20:25:22.991581Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 360, "image": null, "data_source": "espoo_le", "publisher": null, "replaced_by": null, "name": { "fi": "Kivenlahti", "sv": "Stensvik", "en": "Kivenlahti" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwlfu/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "espoo_le:aggh5gwliu", "alt_labels": [], "created_time": "2023-12-18T20:25:23.016029Z", "last_modified_time": "2023-12-18T20:25:23.016044Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 337, "image": null, "data_source": "espoo_le", "publisher": null, "replaced_by": null, "name": { "fi": "Finnoo", "sv": "Finno", "en": "Finnoo" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwliu/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "espoo_le:aggh5gwkya", "alt_labels": [], "created_time": "2023-12-18T20:25:22.883069Z", "last_modified_time": "2023-12-18T20:25:22.883099Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 320, "image": null, "data_source": "espoo_le", "publisher": null, "replaced_by": null, "name": { "fi": "Espoon keskus", "sv": "Esbo centrum", "en": "Espoon keskus" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwkya/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "espoo_le:aggh5gwlh4", "alt_labels": [], "created_time": "2023-12-18T20:25:23.009578Z", "last_modified_time": "2023-12-18T20:25:23.009594Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 319, "image": null, "data_source": "espoo_le", "publisher": null, "replaced_by": null, "name": { "fi": "Soukka", "sv": "Sökö", "en": "Soukka" }, "@id": "http://api.hel.fi/linkedevents/v1/keyword/espoo_le:aggh5gwlh4/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 3523, "next": "