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=124&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=125&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=123&show_all_keywords=True" }, "data": [ { "id": "yso:p15566", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:09:17.895401Z", "last_modified_time": "2023-08-16T05:09:17.895421Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "brandy", "en": "brandy" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15566/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38513", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:56.272724Z", "last_modified_time": "2023-08-16T05:07:56.272747Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "branle", "en": "branle" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38513/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39732", "has_user_editable_resources": false, "alt_labels": [ "brasilianare" ], "created_time": "2023-08-16T05:08:09.206601Z", "last_modified_time": "2023-08-16T05:08:09.206619Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "brasilialaiset", "sv": "brasilianer", "en": "Brazilians" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39732/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12580", "has_user_editable_resources": false, "alt_labels": [ "brasilienfinländare" ], "created_time": "2023-08-16T05:05:12.262671Z", "last_modified_time": "2025-01-09T04:40:57.836562Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "brasiliansuomalaiset", "sv": "finländare i Brasilien", "en": "Finns in Brazil" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12580/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22603", "has_user_editable_resources": false, "alt_labels": [ "terrier brasileiro" ], "created_time": "2023-08-16T05:10:19.665333Z", "last_modified_time": "2023-08-16T05:10:19.665352Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "brasilianterrieri", "sv": "brasiliansk terrier", "en": "Brazilian terrier" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22603/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p23324", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:27.019833Z", "last_modified_time": "2023-08-16T05:10:27.019852Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bretoni (koira)", "sv": "breton (hund)", "en": "Brittany spaniel" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23324/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p26191", "has_user_editable_resources": false, "alt_labels": [ "bretoni (kieli)" ], "created_time": "2023-08-16T05:07:11.413803Z", "last_modified_time": "2023-08-16T05:07:11.413821Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bretonin kieli", "sv": "bretonska", "en": "Breton language" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26191/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29276", "has_user_editable_resources": false, "alt_labels": [ "bretonsk litteratur" ], "created_time": "2023-08-16T05:11:18.168511Z", "last_modified_time": "2023-08-16T05:11:18.168530Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bretoninkielinen kirjallisuus", "sv": "litteratur på bretonska", "en": "Breton language literature" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29276/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2473", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:38.259455Z", "last_modified_time": "2023-08-16T05:13:38.259476Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bretonit (kansat)", "sv": "bretoner (folk)", "en": "Bretons" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2473/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p37972", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:11:33.012701Z", "last_modified_time": "2023-08-16T05:11:33.012719Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "brexit", "en": "brexit" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p37972/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22433", "has_user_editable_resources": false, "alt_labels": [ "briardi" ], "created_time": "2023-08-16T05:13:27.286489Z", "last_modified_time": "2023-08-16T05:13:27.286508Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "briard", "en": "Briard" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22433/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29432", "has_user_editable_resources": false, "alt_labels": [ "BRIC countries", "BRIC-maat", "BRIC-länder" ], "created_time": "2023-08-16T05:07:39.311509Z", "last_modified_time": "2023-08-16T05:07:39.311539Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "BRICS-maat", "sv": "BRICS-länder", "en": "BRICS countries" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29432/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19294", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:09.993928Z", "last_modified_time": "2023-08-16T05:06:09.993946Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "bridge", "en": "bridge (card games)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19294/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p14986", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:49.941992Z", "last_modified_time": "2023-08-16T05:12:49.942010Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "briketit", "sv": "briketter", "en": "briquets" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14986/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19815", "has_user_editable_resources": false, "alt_labels": [ "Brinkala", "Brinkkala", "Prinkkala", "Brinkhall gård", "Brinkhalls gård" ], "created_time": "2023-08-16T05:06:16.007033Z", "last_modified_time": "2023-08-16T05:06:16.007050Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Brinkhall", "en": "Brinkhall manor" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19815/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29050", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:35.433196Z", "last_modified_time": "2023-08-16T05:07:35.433214Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Brinkhall soi", "sv": "Musik på Brinkhall", "en": "Brinkhall soi" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29050/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40483", "has_user_editable_resources": false, "alt_labels": [ "brintsoliamidi" ], "created_time": "2024-10-20T04:40:26.422128Z", "last_modified_time": "2024-11-14T04:40:26.103641Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "brintsolamidi", "sv": "brinzolamid", "en": "brinzolamide" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40483/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11004", "has_user_editable_resources": false, "alt_labels": [ "Brits" ], "created_time": "2023-08-16T05:16:33.080963Z", "last_modified_time": "2023-08-16T05:16:33.080998Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "britit", "sv": "britter", "en": "British people" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11004/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38373", "has_user_editable_resources": false, "alt_labels": [ "brittiska" ], "created_time": "2023-08-16T05:07:54.562155Z", "last_modified_time": "2023-08-16T05:07:54.562172Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "brittienglanti", "sv": "brittisk engelska", "en": "British English" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38373/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p28414", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:30.042727Z", "last_modified_time": "2023-08-16T05:07:30.042751Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "brittiläinen viittomakieli", "sv": "brittiskt teckenspråk", "en": "British Sign Language" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28414/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "