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=266&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=267&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=265&show_all_keywords=True" }, "data": [ { "id": "yso:p6659", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:08:22.813347Z", "last_modified_time": "2023-08-16T05:08:22.813367Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harkintaverotus", "sv": "beskattning enligt prövning", "en": "presumptive income taxation" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6659/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p20536", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:06:24.736019Z", "last_modified_time": "2023-08-16T05:06:24.736037Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harkot", "sv": "murblock", "en": "blocks (building supplies)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20536/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29987", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:43.738139Z", "last_modified_time": "2023-08-16T05:07:43.738158Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Harlem-jazz", "en": "Harlem jazz" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29987/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p25972", "has_user_editable_resources": false, "alt_labels": [ "grå" ], "created_time": "2023-08-16T05:10:50.714760Z", "last_modified_time": "2023-08-16T05:10:50.714779Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harmaa", "sv": "grått", "en": "grey" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25972/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p38962", "has_user_editable_resources": false, "alt_labels": [ "gray heron", "Ardea cinerea", "häger" ], "created_time": "2023-08-16T05:08:00.910857Z", "last_modified_time": "2023-08-16T05:08:00.910876Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harmaahaikara", "sv": "gråhäger", "en": "grey heron" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38962/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39055", "has_user_editable_resources": false, "alt_labels": [ "grey geese", "Anser", "grå gäss" ], "created_time": "2023-08-16T05:16:04.385231Z", "last_modified_time": "2023-08-16T05:16:04.385253Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harmaahanhet", "sv": "ansergäss", "en": "Anser" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39055/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p1547", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:33.271018Z", "last_modified_time": "2023-08-16T05:05:33.271038Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harmaa kirjallisuus", "sv": "grå litteratur", "en": "grey literature" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1547/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12839", "has_user_editable_resources": false, "alt_labels": [ "grey alder", "speckled alder", "Alnus incana", "leppä" ], "created_time": "2023-08-16T05:05:14.033477Z", "last_modified_time": "2023-08-16T05:05:14.033496Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harmaaleppä", "sv": "gråal", "en": "Alnus incana" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12839/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p13620", "has_user_editable_resources": false, "alt_labels": [ "herring gull" ], "created_time": "2023-08-16T05:05:19.301665Z", "last_modified_time": "2023-08-16T05:05:19.301683Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harmaalokki", "sv": "gråtrut", "en": "Larus argentatus" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13620/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p13543", "has_user_editable_resources": false, "alt_labels": [ "Salvelinus namaycush", "Salvelinus namaycush", "canadaröding" ], "created_time": "2023-08-16T05:05:18.611860Z", "last_modified_time": "2023-08-16T05:05:18.611877Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harmaanieriä", "sv": "kanadaröding", "en": "lake trout" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13543/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21970", "has_user_editable_resources": false, "alt_labels": [ "harmaanorjanhirvikoira", "gråhund" ], "created_time": "2023-08-16T05:10:13.508204Z", "last_modified_time": "2023-08-16T05:10:13.508223Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harmaa norjanhirvikoira", "sv": "norsk älghund, grå", "en": "Norwegian elkhound" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21970/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p19004", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:10.380214Z", "last_modified_time": "2023-08-16T05:13:10.380232Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harmaaorvakka", "sv": "pergamentsvamp", "en": "Phlebiopsis gigantea" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19004/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p21952", "has_user_editable_resources": false, "alt_labels": [ "harmaa vesi", "BDT-vatten" ], "created_time": "2023-08-16T05:13:24.977681Z", "last_modified_time": "2023-08-16T05:13:24.977701Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harmaavesi", "sv": "gråvatten", "en": "greywater" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21952/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16545", "has_user_editable_resources": false, "alt_labels": [ "reed organ", "polkuharmoni", "urkuharmoni", "harmonium", "kammarorgel", "tramporgel" ], "created_time": "2023-08-16T05:05:42.320615Z", "last_modified_time": "2023-08-16T05:05:42.320632Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harmoni", "sv": "orgelharmonium", "en": "harmonium" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16545/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p15612", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:12:53.023011Z", "last_modified_time": "2023-08-16T05:12:53.023041Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harmonia", "sv": "harmoni", "en": "harmony" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15612/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12940", "has_user_editable_resources": false, "alt_labels": [ "accordion players", "haitaristit", "hanurinsoittajat", "hanuristit", "harmonikkataiteilijat", "harmonikaspelare" ], "created_time": "2023-08-16T05:08:57.763486Z", "last_modified_time": "2023-08-16T05:08:57.763505Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harmonikansoittajat", "sv": "dragspelare", "en": "accordionists" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12940/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p11333", "has_user_editable_resources": false, "alt_labels": [ "haitari", "hanuri", "näppäinharmonikka", "pianohanuri", "pianoharmonikka", "dragharmonika", "handklaver", "knappdragspel", "pianodragspel" ], "created_time": "2023-08-16T05:15:00.004776Z", "last_modified_time": "2023-08-16T05:15:00.004800Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harmonikka", "sv": "dragspel", "en": "accordion" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11333/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p28124", "has_user_editable_resources": false, "alt_labels": [ "abstrakt harmonisk analys" ], "created_time": "2023-08-16T05:11:08.109539Z", "last_modified_time": "2023-08-16T05:11:08.109558Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harmoninen analyysi", "sv": "harmonisk analys", "en": "harmonic analysis (mathematics)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28124/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p39274", "has_user_editable_resources": false, "alt_labels": [ "compasses (mathematical instruments)", "pair of compasses", "cirkelpassare" ], "created_time": "2023-08-16T05:08:04.363109Z", "last_modified_time": "2023-08-16T05:08:04.363134Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harpit", "sv": "passare (verktyg)", "en": "compasses (drawing tools)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39274/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p16638", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:43.394770Z", "last_modified_time": "2023-08-16T05:05:43.394787Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "harppu", "sv": "harpa", "en": "harp" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16638/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31684, "next": "