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=108&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=109&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=107&show_all_keywords=True" }, "data": [ { "id": "yso:p30091", "has_user_editable_resources": false, "alt_labels": [ "barrelhouse piano" ], "created_time": "2023-08-16T05:15:55.942077Z", "last_modified_time": "2023-08-16T05:15:55.942106Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "barrelhouse piano", "en": "barrelhouse" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30091/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p28468", "has_user_editable_resources": false, "alt_labels": [ "Bartonella" ], "created_time": "2023-08-16T05:11:10.703629Z", "last_modified_time": "2023-08-16T05:11:10.703648Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Bartonella-bakteerit", "sv": "Bartonellabakterier", "en": "Bartonella bacteria" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28468/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40086", "has_user_editable_resources": false, "alt_labels": [ "baryonigeneesi", "baryogenesis" ], "created_time": "2023-08-16T05:14:25.883413Z", "last_modified_time": "2023-08-16T05:14:25.883431Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "baryogeneesi", "sv": "baryogenes", "en": "baryogenesis" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40086/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39308", "has_user_editable_resources": false, "alt_labels": [ "souks" ], "created_time": "2023-08-16T05:17:09.144017Z", "last_modified_time": "2023-08-16T05:17:09.144046Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "basaarit", "sv": "basarer (österländska)", "en": "bazaars (markets)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39308/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p18919", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:06.158086Z", "last_modified_time": "2023-08-16T05:06:06.158104Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "basaltti", "sv": "basalt", "en": "basalt" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18919/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15235", "has_user_editable_resources": false, "alt_labels": [ "baseball" ], "created_time": "2023-08-16T05:12:51.417715Z", "last_modified_time": "2023-08-16T05:12:51.417732Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "baseball", "sv": "baseboll", "en": "baseball" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15235/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12957", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:14.988504Z", "last_modified_time": "2023-08-16T05:05:14.988523Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "base-hypyt", "sv": "BASE-hopp", "en": "BASE jumps" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12957/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p23212", "has_user_editable_resources": false, "alt_labels": [ "kongonpystykorva" ], "created_time": "2023-08-16T05:10:25.886225Z", "last_modified_time": "2023-08-16T05:10:25.886245Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "basenji", "en": "basenji" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23212/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10681", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:00.982841Z", "last_modified_time": "2023-08-16T05:05:00.982861Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "BASIC", "en": "BASIC" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10681/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40229", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2024-01-24T04:40:54.510087Z", "last_modified_time": "2024-03-09T04:40:47.753509Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "basilikat (arkkitehtuuri)", "sv": "basilikor (arkitektur)", "en": "basilicas (architecture)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40229/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p9811", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:08:36.547925Z", "last_modified_time": "2023-08-16T05:08:36.547944Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "basiliskit", "sv": "basilisker", "en": "basilisks" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9811/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p28513", "has_user_editable_resources": false, "alt_labels": [ "baskiirin kieli" ], "created_time": "2023-08-16T05:07:30.742136Z", "last_modified_time": "2023-08-16T05:07:30.742153Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "baškiirin kieli", "sv": "basjkiriska", "en": "Bashkir language" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28513/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29233", "has_user_editable_resources": false, "alt_labels": [ "baskiirinkielinen kirjallisuus", "basjkirisk litteratur" ], "created_time": "2023-08-16T05:11:17.402522Z", "last_modified_time": "2023-08-16T05:11:17.402539Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "baškiirinkielinen kirjallisuus", "sv": "litteratur på basjkiriska", "en": "Bashkir language literature" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29233/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29684", "has_user_editable_resources": false, "alt_labels": [ "baskiirit" ], "created_time": "2023-08-16T05:11:22.282017Z", "last_modified_time": "2023-08-16T05:11:22.282035Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "baškiirit", "sv": "basjkirer", "en": "Bashkirs" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29684/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15830", "has_user_editable_resources": false, "alt_labels": [ "Euskara", "euskaran kieli", "euskeran kieli", "euskara" ], "created_time": "2023-08-16T05:05:36.653657Z", "last_modified_time": "2023-08-16T05:05:36.653675Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "baskin kieli", "sv": "baskiska", "en": "Basque language" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15830/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29291", "has_user_editable_resources": false, "alt_labels": [ "baskisk litteratur", "baskiskspråkig litteratur" ], "created_time": "2023-08-16T05:11:18.430959Z", "last_modified_time": "2023-08-16T05:11:18.430978Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "baskinkielinen kirjallisuus", "sv": "litteratur på baskiska", "en": "Basque language literature" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29291/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p17667", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:53.122396Z", "last_modified_time": "2023-08-16T05:05:53.122423Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "baskit", "sv": "basker", "en": "Basques" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17667/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38566", "has_user_editable_resources": false, "alt_labels": [ "basses danses" ], "created_time": "2023-08-16T05:07:56.775535Z", "last_modified_time": "2023-08-16T05:07:56.775562Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "basse danse", "en": "basse danse" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38566/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22225", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:16.124122Z", "last_modified_time": "2023-08-16T05:10:16.124139Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "basset hound", "en": "basset hound" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22225/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2666", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:15:43.876466Z", "last_modified_time": "2023-08-16T05:15:43.876491Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bassokitara", "sv": "basgitarr", "en": "bass guitar" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2666/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31684, "next": "