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=52&show_all_keywords=True
https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=53&show_all_keywords=True", "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=51&show_all_keywords=True" }, "data": [ { "id": "yso:p29590", "has_user_editable_resources": false, "alt_labels": [ "Castor canadensis", "kanadanmajava", "amerikansk bäver", "kanadabäver", "kanadensisk bäver" ], "created_time": "2023-08-16T05:07:40.654996Z", "last_modified_time": "2023-08-16T05:07:40.655013Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amerikanmajava", "sv": "nordamerikansk bäver", "en": "American beaver" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29590/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p40446", "has_user_editable_resources": false, "alt_labels": [ "pitbull", "pitbullterrieri", "pitbull", "pitbullterrier", "pit bull", "pitbull" ], "created_time": "2024-10-19T04:40:51.694154Z", "last_modified_time": "2024-11-13T04:40:51.370472Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amerikanpitbullterrieri", "sv": "amerikansk pitbullterrier", "en": "American pit bull terrier" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40446/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10929", "has_user_editable_resources": false, "alt_labels": [ "Swedish Americans", "svenskamerikanare", "svenskamerikaner" ], "created_time": "2023-08-16T05:12:27.962628Z", "last_modified_time": "2023-08-16T05:12:27.962645Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amerikanruotsalaiset", "sv": "amerikasvenskar", "en": "American Swedes" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10929/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p22411", "has_user_editable_resources": false, "alt_labels": [ "amstaff" ], "created_time": "2023-08-16T05:10:17.850590Z", "last_modified_time": "2023-08-16T05:10:17.850609Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amerikanstaffordshirenterrieri", "sv": "amerikansk staffordshire terrier", "en": "American Staffordshire terrier" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22411/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5280", "has_user_editable_resources": false, "alt_labels": [ "finländare i Amerika" ], "created_time": "2023-08-16T05:11:59.898128Z", "last_modified_time": "2023-08-16T05:11:59.898151Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amerikansuomalaiset", "sv": "amerikafinländare", "en": "Finnish Americans" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5280/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p12917", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:05:14.713964Z", "last_modified_time": "2023-08-16T05:05:14.713984Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amerikansuomi", "sv": "amerikafinska", "en": "Finnish spoken in America" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12917/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p18153", "has_user_editable_resources": false, "alt_labels": [ "Voice of America", "Amerikas röst" ], "created_time": "2023-08-16T05:05:57.783168Z", "last_modified_time": "2023-08-16T05:05:57.783186Z", "aggregate": false, "deprecated": false, "has_upcoming_events": true, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Amerikan ääni", "sv": "Voice of America", "en": "Voice of America (radio stations)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18153/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p18923", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:10.042456Z", "last_modified_time": "2023-08-16T05:13:10.042473Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amerikkalainen jalkapallo", "sv": "amerikansk fotboll", "en": "American football" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18923/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p2716", "has_user_editable_resources": false, "alt_labels": [ "transcendental philosophy (American philosophy)", "transsendentalismi (Uusi-Englanti)", "amerikansk transcendentalism" ], "created_time": "2023-08-16T05:07:20.337901Z", "last_modified_time": "2023-08-16T05:07:20.337920Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amerikkalainen transsendentalismi", "sv": "transcendentalism (amerikansk)", "en": "transcendentalism (American philosophy)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2716/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29408", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:39.070201Z", "last_modified_time": "2023-08-16T05:07:39.070224Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amerikkalainen viittomakieli", "sv": "amerikanskt teckenspråk", "en": "American Sign Language" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29408/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5189", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:18:56.474640Z", "last_modified_time": "2023-08-16T05:18:56.474657Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amerikkalaiset", "sv": "amerikaner", "en": "Americans" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5189/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p10617", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:16:31.714164Z", "last_modified_time": "2023-08-16T05:16:31.714183Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amerikkalaisuus", "sv": "amerikanskhet", "en": "American identity" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10617/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p25721", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:13:43.325638Z", "last_modified_time": "2023-08-16T05:13:43.325655Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "ametisti", "sv": "ametist", "en": "amethyst" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25721/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p5463", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:14:32.679548Z", "last_modified_time": "2023-08-16T05:14:32.679567Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amfetamiini", "sv": "amfetamin", "en": "amphetamine" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5463/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p9379", "has_user_editable_resources": false, "alt_labels": [ "amphitheaters" ], "created_time": "2023-08-16T05:14:52.267157Z", "last_modified_time": "2023-08-16T05:14:52.267174Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amfiteatterit", "sv": "amfiteatrar", "en": "amphitheatres" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9379/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p28761", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:07:33.021518Z", "last_modified_time": "2023-08-16T05:07:33.021536Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amharan kieli", "sv": "amhariska", "en": "Amharic language" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28761/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p29183", "has_user_editable_resources": false, "alt_labels": [ "amhariskspråkig litteratur" ], "created_time": "2023-08-16T05:11:16.716507Z", "last_modified_time": "2023-08-16T05:11:16.716531Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amharankielinen kirjallisuus", "sv": "litteratur på amhariska", "en": "Amharic language literature" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29183/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p20965", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:04.533300Z", "last_modified_time": "2023-08-16T05:10:04.533323Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amidit", "sv": "amider", "en": "amides" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20965/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p37880", "has_user_editable_resources": false, "alt_labels": [ "Commodore Amiga", "Amiga-tietokoneet", "Commodore Amiga", "Amiga-datorer", "Commodore Amiga" ], "created_time": "2023-08-16T05:07:50.039209Z", "last_modified_time": "2023-08-16T05:07:50.039227Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "Amiga", "en": "Amiga (computers)" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p37880/?format=api", "@context": "http://schema.org", "@type": "Keyword" }, { "id": "yso:p24352", "has_user_editable_resources": false, "alt_labels": [], "created_time": "2023-08-16T05:10:36.222531Z", "last_modified_time": "2023-08-16T05:10:36.222548Z", "aggregate": false, "deprecated": false, "has_upcoming_events": false, "n_events": 0, "image": null, "data_source": "yso", "publisher": "hy:kansalliskirjasto", "replaced_by": null, "name": { "fi": "amigurumit", "sv": "amigurumier", "en": "amigurumi" }, "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24352/?format=api", "@context": "http://schema.org", "@type": "Keyword" } ] }{ "meta": { "count": 31675, "next": "