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=185&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=186&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=184&show_all_keywords=True" }, "data": [ { "id": "yso:p5993", "has_user_editable_resources": false, "alt_labels": [ "power resources", "energitillgångar" ], "created_time": "2023-08-16T05:17:16.128647Z", "last_modified_time": "2023-08-16T05:17:16.128665Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "energiavarat", "sv": "energiresurser", "en": "energy resources" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5993/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p14965", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:09:12.935448Z", "last_modified_time": "2023-08-16T05:09:12.935467Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "energiavero", "sv": "energiskatt", "en": "energy tax" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14965/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10685", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:16:31.961062Z", "last_modified_time": "2023-08-16T05:16:31.961080Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "energiayhtiöt", "sv": "energibolag", "en": "energy companies" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10685/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p27701", "has_user_editable_resources": false, "alt_labels": [ "jeniseinsamojedi", "jenisejsamojediska" ], "created_time": "2023-08-16T05:07:24.530643Z", "last_modified_time": "2023-08-16T05:07:24.530662Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "enetsin kieli", "sv": "entsiska", "en": "Enets language" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27701/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p27679", "has_user_editable_resources": false, "alt_labels": [ "chantajsamojeder", "ener", "enetser", "jenisejsamojeder", "karasinsamojeder" ], "created_time": "2023-08-16T05:07:24.199319Z", "last_modified_time": "2023-08-16T05:07:24.199354Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "enetsit", "sv": "entser", "en": "Enets people" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27679/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15672", "has_user_editable_resources": false, "alt_labels": [ "English bulldog" ], "created_time": "2023-08-16T05:09:18.871555Z", "last_modified_time": "2023-08-16T05:09:18.871572Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "englanninbulldoggi", "sv": "engelsk bulldogg", "en": "bulldog" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15672/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2573", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:18:52.762207Z", "last_modified_time": "2023-08-16T05:18:52.762225Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "englannin kieli", "sv": "engelska", "en": "English language" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2573/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11223", "has_user_editable_resources": false, "alt_labels": [ "engelsk litteratur", "engelskspråkig litteratur" ], "created_time": "2023-08-16T05:08:46.014608Z", "last_modified_time": "2023-08-16T05:08:46.014627Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "englanninkielinen kirjallisuus", "sv": "litteratur på engelska", "en": "English language literature" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11223/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p18940", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:09:45.947854Z", "last_modified_time": "2023-08-16T05:09:45.947872Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "englanninkieliset", "sv": "engelskspråkiga", "en": "English speakers" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18940/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15397", "has_user_editable_resources": false, "alt_labels": [ "English meadow grass" ], "created_time": "2023-08-16T05:05:32.685662Z", "last_modified_time": "2023-08-16T05:05:32.685680Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "englanninraiheinä", "sv": "engelskt rajgräs", "en": "Lolium perenne" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15397/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p31252", "has_user_editable_resources": false, "alt_labels": [ "English Restoration", "restauraatio (Englanti)", "restauraation aika (Englanti)", "restaurationen" ], "created_time": "2023-08-16T05:07:46.464307Z", "last_modified_time": "2023-08-16T05:07:46.464327Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Englannin restauraatio", "sv": "engelska restaurationen", "en": "Restoration (England)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p31252/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p23630", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:30.038893Z", "last_modified_time": "2023-08-16T05:10:30.038913Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "englanninsetteri", "sv": "engelsk setter", "en": "English setter" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23630/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39636", "has_user_editable_resources": false, "alt_labels": [ "engelska inbördeskriget 1642-1649", "inbördeskriget i England (1642-1649)" ], "created_time": "2023-08-16T05:11:49.808999Z", "last_modified_time": "2023-08-16T05:11:49.809018Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Englannin sisällissota (1642–1651)", "sv": "engelska inbördeskriget (1642-1649)", "en": "English Civil War (1642–1651)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39636/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21633", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:23.078892Z", "last_modified_time": "2023-08-16T05:13:23.078910Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "englanninspringerspanieli", "sv": "engelsk springer spaniel", "en": "English springer spaniel" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21633/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p18722", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:09:43.983174Z", "last_modified_time": "2023-08-16T05:09:43.983202Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "englannintorvi", "sv": "engelskt horn", "en": "English horn" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18722/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22990", "has_user_editable_resources": false, "alt_labels": [ "greyhound", "engelsk vinthund" ], "created_time": "2023-08-16T05:10:23.774032Z", "last_modified_time": "2023-08-16T05:10:23.774055Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "englanninvinttikoira", "sv": "greyhound", "en": "greyhound" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22990/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11532", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:08:47.797937Z", "last_modified_time": "2023-08-16T05:08:47.797958Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "englantilaiset", "sv": "engelsmän", "en": "English people" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11532/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p4411", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:18:22.860736Z", "last_modified_time": "2023-08-16T05:18:22.860756Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "englantilaisuus", "sv": "engelskhet", "en": "English identity" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4411/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11975", "has_user_editable_resources": false, "alt_labels": [ "maksimiarvot", "maximumvärden" ], "created_time": "2023-08-16T05:12:33.776865Z", "last_modified_time": "2023-08-16T05:12:33.776882Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "enimmäispitoisuudet", "sv": "högsta tillåtna värden", "en": "maximum concentrations" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11975/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p18664", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:03.142165Z", "last_modified_time": "2023-08-16T05:06:03.142183Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "enkelit", "sv": "änglar", "en": "angels" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18664/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31673, "next": "