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=69&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=70&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=68&show_all_keywords=True" }, "data": [ { "id": "yso:p19587", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:09:52.621178Z", "last_modified_time": "2023-08-16T05:09:52.621197Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aprikoosi", "sv": "aprikos", "en": "apricot" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19587/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p23147", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:43.314359Z", "last_modified_time": "2023-08-16T05:06:43.314381Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aprillipäivä", "sv": "första april", "en": "April Fools' Day" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23147/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p378", "has_user_editable_resources": false, "alt_labels": [ "a priori tieto", "förnuftskunskap" ], "created_time": "2023-08-16T05:11:31.508766Z", "last_modified_time": "2023-08-16T05:11:31.508785Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "apriorinen tieto", "sv": "kunskap a priori", "en": "a priori knowledge" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p378/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11364", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:04.373218Z", "last_modified_time": "2023-08-16T05:05:04.373235Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "APROS", "en": "APROS" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11364/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p25614", "has_user_editable_resources": false, "alt_labels": [ "APS II", "autoimmunt polyglandulärt syndrom typ II" ], "created_time": "2023-08-16T05:07:05.917151Z", "last_modified_time": "2023-08-16T05:07:05.917170Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "APS II", "en": "autoimmune polyendocrine syndrome type 2" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25614/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5771", "has_user_editable_resources": false, "alt_labels": [ "chemists' shops", "drugstores" ], "created_time": "2023-08-16T05:14:34.435179Z", "last_modified_time": "2023-08-16T05:14:34.435198Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "apteekit", "sv": "apotek", "en": "pharmacies" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5771/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11777", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:32.768109Z", "last_modified_time": "2023-08-16T05:12:32.768125Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "apteekkarit", "sv": "apotekare", "en": "pharmacists (entrepreneurs)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11777/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39018", "has_user_editable_resources": false, "alt_labels": [ "marking for cutting into lengths" ], "created_time": "2023-08-16T05:17:52.561342Z", "last_modified_time": "2023-08-16T05:17:52.561367Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "apteeraus", "sv": "aptering", "en": "marking for cross-cutting" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39018/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p13268", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:15:07.850671Z", "last_modified_time": "2023-08-16T05:15:07.850689Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "apuhoitajat", "sv": "hjälpskötare", "en": "practical nurses" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13268/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15695", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:35.240652Z", "last_modified_time": "2023-08-16T05:05:35.240670Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "apulaiskaupunginjohtajat", "sv": "biträdande stadsdirektörer", "en": "deputy mayors" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15695/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19363", "has_user_editable_resources": false, "alt_labels": [ "assistant head nurses" ], "created_time": "2023-08-16T05:13:12.025728Z", "last_modified_time": "2023-08-16T05:13:12.025744Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "apulaisosastonhoitajat", "sv": "biträdande avdelningsskötare", "en": "ward managers" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19363/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p9438", "has_user_editable_resources": false, "alt_labels": [ "hjälpmedelstekniker (yrken)", "orthopedic technicians" ], "created_time": "2023-08-16T05:17:26.947425Z", "last_modified_time": "2023-08-16T05:17:26.947444Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "apuneuvoteknikot", "sv": "hjälpmedelstekniker", "en": "orthopaedic technicians" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9438/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5436", "has_user_editable_resources": false, "alt_labels": [ "stipendit" ], "created_time": "2023-08-16T05:16:13.060467Z", "last_modified_time": "2023-08-16T05:16:13.060484Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "apurahat", "sv": "stipendier", "en": "grants" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5436/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16043", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:55.317823Z", "last_modified_time": "2023-08-16T05:12:55.317840Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "apusisaret", "sv": "hjälpsystrar", "en": "assistant nursing sisters" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16043/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29102", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:36.101223Z", "last_modified_time": "2023-08-16T05:07:36.101246Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "apuverbit", "sv": "hjälpverb", "en": "auxiliary verbs" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29102/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p9044", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:18:47.270791Z", "last_modified_time": "2023-08-16T05:18:47.270808Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "apuvälineet", "sv": "hjälpmedel", "en": "aids (implements)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9044/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p31044", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:11:27.715527Z", "last_modified_time": "2023-08-16T05:11:27.715555Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "arabeskit (kuvataide)", "sv": "arabesker (bildkonst)", "en": "arabesques (art)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p31044/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29881", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:11:24.017927Z", "last_modified_time": "2023-08-16T05:11:24.017945Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "arabeskit (sävellykset)", "sv": "arabesker (kompositioner)", "en": "arabesques (compositions)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29881/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2116", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:28.661285Z", "last_modified_time": "2023-08-16T05:06:28.661313Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "arabialainen filosofia", "sv": "arabisk filosofi", "en": "Arabic philosophy" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2116/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p26867", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:57.482967Z", "last_modified_time": "2023-08-16T05:10:57.482986Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "arabialainen kirjaimisto", "sv": "arabiska alfabetet", "en": "Arabic alphabet" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26867/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "