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=1416&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1417&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1415&show_all_keywords=True" }, "data": [ { "id": "yso:p16664", "has_user_editable_resources": false, "alt_labels": [ "uudet uskonnolliset liikkeet", "uushengellisyys", "uususkonnot", "nya religiösa rörelser", "nyandliga rörelser", "nyandlighet", "nyreligiösa rörelser", "uushenkisyys" ], "created_time": "2023-08-16T05:17:38.301777Z", "last_modified_time": "2023-08-16T05:17:38.301800Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "uususkonnollisuus", "sv": "nyreligiositet", "en": "new religious movements" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16664/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3640", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:11:30.396048Z", "last_modified_time": "2023-08-16T05:11:30.396125Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "uusvasemmisto", "sv": "nyvänster", "en": "New Left" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3640/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p666", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:05.901120Z", "last_modified_time": "2023-08-16T05:12:05.901143Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "uusyläsaksa", "sv": "nyhögtyska", "en": "New High German language" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p666/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p13915", "has_user_editable_resources": false, "alt_labels": [ "uutiskatsaukset", "uutistapahtumat", "nyhetshändelser", "nyhetsöversikter" ], "created_time": "2023-08-16T05:15:10.149192Z", "last_modified_time": "2023-08-16T05:15:10.149210Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "uutiset", "sv": "nyheter (meddelanden)", "en": "news" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13915/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p26937", "has_user_editable_resources": false, "alt_labels": [ "news photos", "press photographs", "press photos", "uutisvalokuvat", "nyhetsfotografier" ], "created_time": "2023-08-16T05:13:49.619625Z", "last_modified_time": "2023-08-16T05:13:49.619641Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "uutiskuvat", "sv": "nyhetsbilder", "en": "news photographs" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26937/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21431", "has_user_editable_resources": false, "alt_labels": [ "news coverage" ], "created_time": "2023-08-16T05:13:21.899286Z", "last_modified_time": "2023-08-16T05:13:21.899304Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "uutisointi", "sv": "nyhetsrapportering", "en": "news reportage" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21431/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2505", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:42.215481Z", "last_modified_time": "2023-08-16T05:10:42.215499Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "uutispäälliköt", "sv": "nyhetschefer", "en": "news editors" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2505/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p1469", "has_user_editable_resources": false, "alt_labels": [ "tietotoimistot" ], "created_time": "2023-08-16T05:05:26.930658Z", "last_modified_time": "2023-08-16T05:05:26.930675Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "uutistoimistot", "sv": "nyhetsbyråer", "en": "news agencies" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1469/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p13914", "has_user_editable_resources": false, "alt_labels": [ "uutisten välitys" ], "created_time": "2023-08-16T05:15:10.114148Z", "last_modified_time": "2023-08-16T05:15:10.114165Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "uutisvälitys", "sv": "nyhetsförmedling", "en": "news transmission" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13914/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p1403", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:44.784161Z", "last_modified_time": "2023-08-16T05:12:44.784178Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "uutteet", "sv": "extrakt", "en": "extracts" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1403/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p1415", "has_user_editable_resources": false, "alt_labels": [ "extrahering", "uuttaminen" ], "created_time": "2023-08-16T05:17:35.162223Z", "last_modified_time": "2023-08-16T05:17:35.162243Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "uutto", "sv": "extraktion", "en": "extraction (chemistry)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1415/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p6432", "has_user_editable_resources": false, "alt_labels": [ "uudet tuotteet", "uutuustuotteet", "nya produkter" ], "created_time": "2023-08-16T05:14:37.675699Z", "last_modified_time": "2023-08-16T05:14:37.675723Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "uutuudet", "sv": "nyheter (produkter)", "en": "new products" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6432/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p14195", "has_user_editable_resources": false, "alt_labels": [ "uutuustiedotteet", "nyförvärvslistor (bibliotek)", "nyhetsförteckningar (bibliotek)", "nyhetslistor (bibliotek)", "nyhetsmeddelanden" ], "created_time": "2023-08-16T05:12:45.555663Z", "last_modified_time": "2024-05-03T04:40:55.164201Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "uutuusluettelot (kirjastot)", "sv": "nyhetskataloger (bibliotek)", "en": "accession lists (libraries)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14195/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38508", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:56.198858Z", "last_modified_time": "2023-08-16T05:07:56.198885Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "uzbekin kieli", "sv": "uzbekiska", "en": "Uzbek language" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38508/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p28917", "has_user_editable_resources": false, "alt_labels": [ "özbeker" ], "created_time": "2023-08-16T05:07:34.597073Z", "last_modified_time": "2023-08-16T05:07:34.597092Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "uzbekit", "sv": "uzbeker", "en": "Uzbeks" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28917/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10583", "has_user_editable_resources": false, "alt_labels": [ "punnituslaitteet", "vägningsinstrument" ], "created_time": "2023-08-16T05:12:26.240206Z", "last_modified_time": "2023-08-16T05:12:26.240226Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vaa'at", "sv": "vågar", "en": "scales (measuring instruments)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10583/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10298", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:08:39.709807Z", "last_modified_time": "2023-08-16T05:08:39.709833Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vaahdot", "sv": "skum", "en": "foams" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10298/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p9737", "has_user_editable_resources": false, "alt_labels": [ "froth flotation" ], "created_time": "2023-08-16T05:14:54.100200Z", "last_modified_time": "2023-08-16T05:14:54.100227Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vaahdotus", "sv": "flotation", "en": "flotation" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9737/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p14391", "has_user_editable_resources": false, "alt_labels": [ "Waahersalon kartano", "Waahersalo gård" ], "created_time": "2023-08-16T05:05:25.109171Z", "last_modified_time": "2023-08-16T05:05:25.109190Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Vaahersalon kartano", "sv": "Vaahersalo gård", "en": "Vaahersalo manor" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14391/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3423", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:11:29.322924Z", "last_modified_time": "2023-08-16T05:11:29.322952Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "vaahtera", "sv": "lönn", "en": "maple" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3423/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31685, "next": "