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=171
https://api.hel.fi/linkedevents/v1/keyword/?format=api&page=172", "previous": "https://api.hel.fi/linkedevents/v1/keyword/?format=api&page=170" }, "data": [ { "id": "helmet:11899", "alt_labels": [], "created_time": "2019-07-16T12:15:47.605948Z", "last_modified_time": "2019-07-16T13:19:59.612787Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 2, "image": null, "data_source": "helmet", "publisher": "ahjo:u4804001010", "replaced_by": null, "name": { "fi": "Kirjallisuuspalkinto", "sv": "Litteraturpris" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11899/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:11955", "alt_labels": [], "created_time": "2021-03-31T08:19:26.844137Z", "last_modified_time": "2021-03-31T08:19:26.852669Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 2, "image": null, "data_source": "helmet", "publisher": "ahjo:u4804001010", "replaced_by": null, "name": { "fi": "Koulut ja päiväkodit" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11955/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:11962", "alt_labels": [], "created_time": "2021-03-31T08:19:26.929928Z", "last_modified_time": "2021-03-31T08:19:26.937592Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 2, "image": null, "data_source": "helmet", "publisher": "ahjo:u4804001010", "replaced_by": null, "name": { "fi": "Koulut ja päiväkodit" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11962/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:11944", "alt_labels": [], "created_time": "2021-03-31T08:19:26.677872Z", "last_modified_time": "2021-03-31T08:19:26.687143Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 2, "image": null, "data_source": "helmet", "publisher": "ahjo:u4804001010", "replaced_by": null, "name": { "fi": "Koulut ja päiväkodit" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11944/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:11939", "alt_labels": [], "created_time": "2021-03-31T08:19:26.615027Z", "last_modified_time": "2021-03-31T08:19:26.625511Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 2, "image": null, "data_source": "helmet", "publisher": "ahjo:u4804001010", "replaced_by": null, "name": { "fi": "Koulut ja päiväkodit" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11939/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:11942", "alt_labels": [], "created_time": "2021-03-31T08:19:26.650232Z", "last_modified_time": "2021-03-31T08:19:26.660415Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 2, "image": null, "data_source": "helmet", "publisher": "ahjo:u4804001010", "replaced_by": null, "name": { "fi": "Koulut ja päiväkodit" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11942/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:10813", "alt_labels": [], "created_time": null, "last_modified_time": "2017-11-22T15:12:04.430361Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 2, "image": null, "data_source": "helmet", "publisher": "ahjo:45400", "replaced_by": null, "name": { "fi": "Laajalahden kirjasto" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:10813/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:11508", "alt_labels": [], "created_time": "2019-01-09T15:28:53.744198Z", "last_modified_time": "2019-01-09T15:28:53.786069Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 2, "image": null, "data_source": "helmet", "publisher": "ahjo:u4804001010", "replaced_by": null, "name": { "fi": "Palvelut" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11508/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:11430", "alt_labels": [], "created_time": null, "last_modified_time": "2018-06-11T10:26:37.135892Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 2, "image": null, "data_source": "helmet", "publisher": "ahjo:u4804001010", "replaced_by": null, "name": { "fi": "Palvelut" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11430/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:11712", "alt_labels": [], "created_time": null, "last_modified_time": "2018-06-11T10:27:39.922444Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 2, "image": null, "data_source": "helmet", "publisher": "ahjo:u4804001010", "replaced_by": null, "name": { "fi": "Saunalahden kirjasto", "sv": "Bastviks bibliotek" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11712/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:11276", "alt_labels": [], "created_time": "2021-01-21T17:19:17.207196Z", "last_modified_time": "2021-01-21T17:19:17.226715Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 2, "image": null, "data_source": "helmet", "publisher": "ahjo:u4804001010", "replaced_by": null, "name": { "fi": "Афиша", "ru": "Афиша" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11276/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:11397", "alt_labels": [], "created_time": "2021-01-21T17:19:17.325486Z", "last_modified_time": "2021-01-21T17:19:17.331370Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 2, "image": null, "data_source": "helmet", "publisher": "ahjo:u4804001010", "replaced_by": null, "name": { "fi": "Афиша", "ru": "Афиша" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11397/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:11858", "alt_labels": [], "created_time": "2021-01-21T17:19:17.362197Z", "last_modified_time": "2021-01-21T17:19:17.367887Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 2, "image": null, "data_source": "helmet", "publisher": "ahjo:u4804001010", "replaced_by": null, "name": { "fi": "Афиша", "ru": "Афиша" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11858/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:11365", "alt_labels": [], "created_time": "2021-01-21T17:19:17.294858Z", "last_modified_time": "2021-01-21T17:19:17.301915Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 2, "image": null, "data_source": "helmet", "publisher": "ahjo:u4804001010", "replaced_by": null, "name": { "fi": "Афиша", "ru": "Афиша" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11365/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:11897", "alt_labels": [], "created_time": "2020-03-25T14:20:15.387112Z", "last_modified_time": "2020-03-25T14:20:15.401889Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "helmet", "publisher": "ahjo:u4804001010", "replaced_by": null, "name": { "fi": "Aukioloajat" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11897/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:11910", "alt_labels": [], "created_time": "2019-09-23T12:21:27.563215Z", "last_modified_time": "2023-06-20T04:17:11.922803Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "helmet", "publisher": "ahjo:u4804001010", "replaced_by": null, "name": { "fi": "Entressen omat", "sv": "I Entresse" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11910/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:11322", "alt_labels": [], "created_time": "2020-01-20T15:19:15.020667Z", "last_modified_time": "2020-01-20T15:19:15.033713Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "helmet", "publisher": "ahjo:u4804001010", "replaced_by": null, "name": { "fi": "Juttuja kirjastosta" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11322/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:11358", "alt_labels": [], "created_time": "2021-07-07T11:21:31.449488Z", "last_modified_time": "2021-07-07T11:21:31.467881Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "helmet", "publisher": "ahjo:u4804001010", "replaced_by": null, "name": { "fi": "Juttuja kirjastosta" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11358/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:11314", "alt_labels": [], "created_time": "2018-10-15T13:23:32.224133Z", "last_modified_time": "2018-10-15T13:23:32.243064Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "helmet", "publisher": "ahjo:u4804001010", "replaced_by": null, "name": { "fi": "Juttuja kirjastosta" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11314/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "helmet:11382", "alt_labels": [], "created_time": null, "last_modified_time": "2017-03-10T07:13:49.602456Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 1, "image": null, "data_source": "helmet", "publisher": null, "replaced_by": null, "name": { "fi": "Juttuja kirjastosta" }, "@id": "https://api.hel.fi/linkedevents/v1/keyword/helmet:11382/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 3516, "next": "