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=1516&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1517&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1515&show_all_keywords=True" }, "data": [ { "id": "yso:p5944", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:08:19.769669Z", "last_modified_time": "2023-08-16T05:08:19.769688Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "väriaineteollisuus", "sv": "färgämnesindustri", "en": "dyestuffs industry" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5944/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21392", "has_user_editable_resources": false, "alt_labels": [ "color analysis" ], "created_time": "2023-08-16T05:15:30.138177Z", "last_modified_time": "2023-08-16T05:15:30.138195Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "värianalyysi", "sv": "färganalys", "en": "colour analysis" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21392/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15604", "has_user_editable_resources": false, "alt_labels": [ "color films (photography)" ], "created_time": "2023-08-16T05:05:34.378437Z", "last_modified_time": "2023-08-16T05:05:34.378457Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "värifilmit", "sv": "färgfilmer", "en": "colour films (photography)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15604/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p23373", "has_user_editable_resources": false, "alt_labels": [ "paintball" ], "created_time": "2023-08-16T05:13:32.324937Z", "last_modified_time": "2023-08-16T05:13:32.324956Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "värikuulapeli", "sv": "paintball", "en": "paintball" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23373/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29379", "has_user_editable_resources": false, "alt_labels": [ "coloured pencils" ], "created_time": "2023-08-16T05:11:19.769119Z", "last_modified_time": "2023-08-16T05:11:19.769139Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "värikynät", "sv": "färgpennor", "en": "crayons" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29379/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21606", "has_user_editable_resources": false, "alt_labels": [ "avfärgning", "color removal" ], "created_time": "2023-08-16T05:10:10.136664Z", "last_modified_time": "2023-08-16T05:10:10.136701Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "värinpoisto", "sv": "färgborttagning", "en": "colour removal" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21606/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16823", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:09:27.819671Z", "last_modified_time": "2023-08-16T05:09:27.819690Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "värioppi", "sv": "färglära", "en": "chromatics" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16823/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2177", "has_user_editable_resources": false, "alt_labels": [ "color printing" ], "created_time": "2023-08-16T05:15:31.508662Z", "last_modified_time": "2023-08-16T05:15:31.508680Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "väripainatus", "sv": "färgtryck", "en": "colour printing" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2177/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p4645", "has_user_editable_resources": false, "alt_labels": [ "defekt färgseende", "color blindness" ], "created_time": "2023-08-16T05:11:57.032927Z", "last_modified_time": "2023-08-16T05:11:57.032945Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "värisokeus", "sv": "färgblindhet", "en": "colour blindness" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4645/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2284", "has_user_editable_resources": false, "alt_labels": [ "färg", "färger (material)", "färger (ämne)", "colors" ], "created_time": "2023-08-16T05:19:36.380387Z", "last_modified_time": "2023-08-16T05:19:36.380406Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "värit", "sv": "färger", "en": "colours" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2284/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19996", "has_user_editable_resources": false, "alt_labels": [ "color therapy" ], "created_time": "2023-08-16T05:06:18.056667Z", "last_modified_time": "2023-08-16T05:06:18.056685Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "väriterapia", "sv": "färgterapi", "en": "colour therapy" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19996/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22671", "has_user_editable_resources": false, "alt_labels": [ "väritys (värittäminen)", "kolorering" ], "created_time": "2023-08-16T05:15:33.860171Z", "last_modified_time": "2023-08-16T05:15:33.860188Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "värittäminen", "sv": "färgläggning", "en": "colouring" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22671/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16813", "has_user_editable_resources": false, "alt_labels": [ "färgläggningsböcker", "målböcker" ], "created_time": "2023-08-16T05:12:59.690494Z", "last_modified_time": "2023-08-16T05:12:59.690513Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "värityskirjat", "sv": "målarböcker", "en": "colouring books" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16813/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16007", "has_user_editable_resources": false, "alt_labels": [ "color photography" ], "created_time": "2023-08-16T05:09:21.379640Z", "last_modified_time": "2023-08-16T05:09:21.379657Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "värivalokuvaus", "sv": "färgfotografering", "en": "colour photography" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16007/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40290", "has_user_editable_resources": false, "alt_labels": [ "Dendrobates tinctorius", "Dendrobates tinctorius", "dyeing dart frog" ], "created_time": "2024-03-21T04:40:11.254116Z", "last_modified_time": "2024-03-24T04:40:27.092559Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "värjärinuolimyrkkysammakko", "sv": "färgaregroda", "en": "dyeing poison dart frog" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40290/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p970", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:19:26.824275Z", "last_modified_time": "2023-08-16T05:19:26.824294Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "värjäys", "sv": "färgning", "en": "dyeing" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p970/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p37886", "has_user_editable_resources": false, "alt_labels": [ "värjärimestarit", "värjärit" ], "created_time": "2023-08-16T05:11:32.418648Z", "last_modified_time": "2023-08-16T05:11:32.418665Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "värjääjät", "sv": "färgare", "en": "dyers" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p37886/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p37911", "has_user_editable_resources": false, "alt_labels": [ "Värriö naturreservat" ], "created_time": "2023-08-16T05:11:32.730734Z", "last_modified_time": "2023-08-16T05:11:32.730752Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Värriön luonnonpuisto", "sv": "Värriö naturpark", "en": "Värriö Strict Nature Reserve" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p37911/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11744", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:32.427962Z", "last_modified_time": "2023-08-16T05:12:32.427978Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "värssyt", "sv": "verser", "en": "verses (poems)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11744/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p24910", "has_user_editable_resources": false, "alt_labels": [ "strålbenet" ], "created_time": "2023-08-16T05:10:40.883563Z", "last_modified_time": "2023-08-16T05:10:40.883590Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "värttinäluu", "sv": "strålben", "en": "radius bone" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24910/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31684, "next": "