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=1459&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1460&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1458&show_all_keywords=True" }, "data": [ { "id": "yso:p15306", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:18:11.937916Z", "last_modified_time": "2023-08-16T05:18:11.937935Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vedenpuhdistus", "sv": "vattenrening", "en": "water purification" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15306/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p37924", "has_user_editable_resources": false, "alt_labels": [ "colour number", "väriluku", "färgtal", "color number", "color of water" ], "created_time": "2023-08-16T05:11:32.844490Z", "last_modified_time": "2023-08-16T05:11:32.844509Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vedenväri", "sv": "vattnets färg", "en": "colour of water" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p37924/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5571", "has_user_editable_resources": false, "alt_labels": [ "vadslagning" ], "created_time": "2023-08-16T05:17:57.131697Z", "last_modified_time": "2023-08-16T05:17:57.131722Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vedonlyönti", "sv": "vadhållning", "en": "betting" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5571/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38431", "has_user_editable_resources": false, "alt_labels": [ "avdragning (boktryck)", "avdragning (kontrolltryckning)" ], "created_time": "2023-08-16T05:07:55.023420Z", "last_modified_time": "2023-08-16T05:07:55.023440Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vedostus (kirjapaino)", "sv": "provtryckning (boktryck)", "en": "proofing" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38431/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38442", "has_user_editable_resources": false, "alt_labels": [ "avdragning (konstgrafik)" ], "created_time": "2023-08-16T05:11:37.716515Z", "last_modified_time": "2023-08-16T05:11:37.716533Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vedostus (taidegrafiikka)", "sv": "tryckning (konstgrafik)", "en": "printing (graphic arts)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38442/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2696", "has_user_editable_resources": false, "alt_labels": [ "framkallning", "kopiering (fotografering)" ], "created_time": "2023-08-16T05:15:45.029495Z", "last_modified_time": "2023-08-16T05:15:45.029513Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vedostus (valokuvaus)", "sv": "framkallning och utskrift av fotografier", "en": "printing (photography)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2696/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19454", "has_user_editable_resources": false, "alt_labels": [ "Gowinin Vee", "Vee-diagrammit", "tietovee", "tietoveekartat", "V-diagram (pedagogik)" ], "created_time": "2023-08-16T05:09:51.308003Z", "last_modified_time": "2024-10-30T04:40:37.274891Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Vee-heuristiikka", "sv": "V-heuristik", "en": "Vee heuristic" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19454/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39856", "has_user_editable_resources": false, "alt_labels": [ "vegan foods", "vegaaniruoat", "vegaaniruuat", "vegaaniset ruuat", "vegankost", "veganmat", "veganrätter" ], "created_time": "2023-08-16T05:11:52.007285Z", "last_modified_time": "2023-08-16T05:11:52.007302Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vegaaniset ruoat", "sv": "veganska rätter", "en": "vegan dishes" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39856/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39849", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:11:51.988222Z", "last_modified_time": "2023-08-16T05:11:51.988240Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vegaanit", "sv": "veganer", "en": "vegans" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39849/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p9028", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:18:29.587162Z", "last_modified_time": "2023-08-16T05:18:29.587187Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "veganismi", "sv": "veganism", "en": "veganism" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9028/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p9026", "has_user_editable_resources": false, "alt_labels": [ "kasvissyönti", "vegetarianism" ], "created_time": "2023-08-16T05:17:25.535635Z", "last_modified_time": "2023-08-16T05:17:25.535652Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vegetarismi", "sv": "vegetarism", "en": "vegetarianism" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9026/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p26596", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:47.632721Z", "last_modified_time": "2023-08-16T05:13:47.632747Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vehkakasvit", "sv": "kallaväxter", "en": "arum family" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26596/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p26595", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:15.033165Z", "last_modified_time": "2023-08-16T05:07:15.033185Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vehkat", "sv": "missnesläktet", "en": "Araceae" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26595/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p17893", "has_user_editable_resources": false, "alt_labels": [ "Vehmaa (kartanot)", "Vehmais", "Wehmaa", "Vehmais gård" ], "created_time": "2023-08-16T05:05:55.177530Z", "last_modified_time": "2023-08-16T05:05:55.177555Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Vehmaan kartano", "sv": "Wehmais gård", "en": "Vehmaa manor (Juva)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17893/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29377", "has_user_editable_resources": false, "alt_labels": [ "Pyhän Margareetan kirkko", "S:ta Margareta kyrka" ], "created_time": "2023-08-16T05:11:19.696890Z", "last_modified_time": "2023-08-16T05:11:19.696908Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Vehmaan Pyhän Margareetan kirkko", "sv": "Vemo kyrka", "en": "Vehmaa Church of Saint Margaret" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29377/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p13066", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:17:33.869655Z", "last_modified_time": "2023-08-16T05:17:33.869674Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vehnä", "sv": "vete", "en": "wheat" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13066/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p26939", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:18.202054Z", "last_modified_time": "2023-08-16T05:07:18.202074Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vehnäjauhot", "sv": "vetemjöl", "en": "wheat flour" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26939/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21175", "has_user_editable_resources": false, "alt_labels": [ "veteterrier", "wheaten terrier" ], "created_time": "2023-08-16T05:10:05.988054Z", "last_modified_time": "2023-11-10T04:40:33.161615Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vehnäterrieri", "sv": "irish softcoated wheaten terrier", "en": "soft-coated wheaten terrier" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21175/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16071", "has_user_editable_resources": false, "alt_labels": [ "pikareskiromaanit", "pikaresker", "skälmromaner" ], "created_time": "2023-08-16T05:05:38.559252Z", "last_modified_time": "2023-08-16T05:05:38.559317Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "veijariromaanit", "sv": "pikareskromaner", "en": "picaresque novels" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16071/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p27130", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:20.144365Z", "last_modified_time": "2023-08-16T05:07:20.144384Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Veikkausliiga", "sv": "Tipsligan", "en": "Veikkausliiga" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27130/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31685, "next": "