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=25&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=26&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=24&show_all_keywords=True" }, "data": [ { "id": "yso:p18109", "has_user_editable_resources": false, "alt_labels": [ "Fragaria vesca", "metsämansikka" ], "created_time": "2023-08-16T05:13:06.428688Z", "last_modified_time": "2023-08-16T05:13:06.428707Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ahomansikka", "sv": "smultron", "en": "wild strawberry" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18109/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p20018", "has_user_editable_resources": false, "alt_labels": [ "stuuvarit" ], "created_time": "2023-08-16T05:06:18.321301Z", "last_modified_time": "2023-08-16T05:06:18.321319Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ahtaajat", "sv": "stuvare", "en": "stevedores" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20018/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p27043", "has_user_editable_resources": false, "alt_labels": [ "ahtautumat", "stenoser", "strikturer", "åtsnörningar" ], "created_time": "2023-08-16T05:16:57.074808Z", "last_modified_time": "2023-08-16T05:16:57.074829Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ahtaumat", "sv": "förträngningar", "en": "stenoses" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27043/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38801", "has_user_editable_resources": false, "alt_labels": [ "confined space", "narrowness", "tilanahtaus", "trängsel" ], "created_time": "2023-08-16T05:07:59.767501Z", "last_modified_time": "2023-08-16T05:07:59.767523Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ahtaus (ominaisuudet)", "sv": "trånghet", "en": "cramped conditions" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38801/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2342", "has_user_editable_resources": false, "alt_labels": [ "ahtaus", "lastaus", "stuvande", "stuvning (transport)" ], "created_time": "2023-08-16T05:10:27.992631Z", "last_modified_time": "2023-08-16T05:10:27.992650Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ahtaustyö", "sv": "stuveriarbete", "en": "stevedoring" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2342/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p17176", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:48.023673Z", "last_modified_time": "2023-08-16T05:05:48.023701Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ahtojää", "sv": "packis", "en": "pack ice" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17176/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p20153", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:20.109697Z", "last_modified_time": "2023-08-16T05:06:20.109714Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ahven", "sv": "abborre", "en": "perch" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20153/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p3417", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:47.539413Z", "last_modified_time": "2023-08-16T05:07:47.539431Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ahvenanmaalaiset", "sv": "ålänningar", "en": "Ålandians" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3417/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22639", "has_user_editable_resources": false, "alt_labels": [ "itsehallintolaki", "självstyrelselagen (Åland)" ], "created_time": "2023-08-16T05:13:28.542444Z", "last_modified_time": "2023-08-16T05:13:28.542463Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Ahvenanmaan itsehallintolaki", "sv": "självstyrelselag för Åland", "en": "Act on the Autonomy of Åland" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22639/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12516", "has_user_editable_resources": false, "alt_labels": [ "åländska kongressen" ], "created_time": "2023-08-16T05:12:36.469749Z", "last_modified_time": "2023-08-16T05:12:36.469772Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Ahvenanmaan kongressi", "sv": "Ålandskongressen", "en": "Congress of Åland" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12516/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p13881", "has_user_editable_resources": false, "alt_labels": [ "Ahvenanmaankysymys" ], "created_time": "2023-08-16T05:09:04.626367Z", "last_modified_time": "2023-08-16T05:09:04.626384Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Ahvenanmaan kysymys", "sv": "Ålandsfrågan", "en": "Åland crisis" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13881/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38713", "has_user_editable_resources": false, "alt_labels": [ "saaristolammas" ], "created_time": "2023-08-16T05:11:40.489866Z", "last_modified_time": "2023-08-16T05:11:40.489884Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ahvenanmaanlammas", "sv": "Ålandsfår", "en": "Åland sheep" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38713/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29277", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:11:18.207350Z", "last_modified_time": "2023-08-16T05:11:18.207368Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Ahvenanmaan murteet", "sv": "åländska dialekter", "en": "Åland dialects" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29277/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p23422", "has_user_editable_resources": false, "alt_labels": [ "Forsius-Eriksson syndrome", "Forsius-Erikssonin tauti", "Forsius–Erikssons syndrom", "syndroma Forsius–Eriksson" ], "created_time": "2023-08-16T05:06:46.385476Z", "last_modified_time": "2023-08-16T05:06:46.385494Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Ahvenanmaan silmätauti", "sv": "åländska ögonsjukdomen", "en": "Åland Island eye disease" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23422/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21575", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:31.065483Z", "last_modified_time": "2023-08-16T05:06:31.065501Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Ahvenanmaa-pöytäkirja", "sv": "Ålandsprotokollet", "en": "Åland Protocol" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21575/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11642", "has_user_editable_resources": false, "alt_labels": [ "abborrfiskar" ], "created_time": "2023-08-16T05:17:31.958709Z", "last_modified_time": "2023-08-16T05:17:31.958726Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ahvenkalat", "sv": "abborrartade fiskar", "en": "Perciformes" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11642/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p4422", "has_user_editable_resources": false, "alt_labels": [ "stängsel" ], "created_time": "2023-08-16T05:16:09.564222Z", "last_modified_time": "2023-08-16T05:16:09.564242Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aidat", "sv": "staket", "en": "fences" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4422/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22623", "has_user_editable_resources": false, "alt_labels": [ "GPI", "Genuine Progress Indicator", "aidon kehityksen indikaattori", "GPI" ], "created_time": "2023-08-16T05:06:38.947506Z", "last_modified_time": "2023-08-16T05:06:38.947527Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aidon kehityksen mittari", "sv": "Genuine Progress Indicator", "en": "Genuine Progress Indicator" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22623/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12005", "has_user_editable_resources": false, "alt_labels": [ "acquired immunodeficiency syndrome", "immuunikato", "AIDS", "immunbrist" ], "created_time": "2023-08-16T05:12:34.045228Z", "last_modified_time": "2023-08-16T05:12:34.045247Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "AIDS", "sv": "aids", "en": "Aids" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12005/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p28978", "has_user_editable_resources": false, "alt_labels": [ "aikaisemmat elämät", "entiset elämät", "menneet elämät", "förra liv" ], "created_time": "2023-08-16T05:17:01.402565Z", "last_modified_time": "2023-08-16T05:17:01.402582Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "aiemmat elämät", "sv": "tidigare liv", "en": "past lives" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28978/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "