Keyword List List – Django REST framework

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

See the result

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

See the result

Keyword source

Will restrict keywords to a specific data source.

Example:

keyword/?data_source=yso

See the result

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

See the result

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

See the result

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

See the result

Ordering

Default ordering is decreasing order by the number of events found. You may also order results by name.

For example:

keyword/?sort=name

See the result

GET /v1/keyword/?format=api&page=1187&show_all_keywords=True

HTTP 200 OK
Allow: GET, POST, HEAD, OPTIONS
Content-Type: application/json ;utf-8
Vary: Accept

{
    "meta": {
        "count": 32006,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1188&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1186&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p16735",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:44.032060Z",
            "last_modified_time": "2023-08-16T05:05:44.032077Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sitkeys",
                "sv": "seghet",
                "en": "toughness (physical properties)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16735/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17127",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kirjansitomot"
            ],
            "created_time": "2023-08-16T05:09:30.505315Z",
            "last_modified_time": "2023-08-16T05:09:30.505335Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sitomot",
                "sv": "bokbinderier",
                "en": "binderies"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17127/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13382",
            "has_user_editable_resources": false,
            "alt_labels": [
                "utfästelser",
                "åtaganden"
            ],
            "created_time": "2023-08-16T05:15:08.233180Z",
            "last_modified_time": "2023-08-16T05:15:08.233197Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sitoumukset",
                "sv": "förbindelser (åtaganden)",
                "en": "engagements (societal objects)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13382/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19420",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:25.596253Z",
            "last_modified_time": "2023-08-16T05:15:25.596305Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sitouttaminen",
                "sv": "lojalitetsskapande",
                "en": "committing someone"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19420/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10202",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:04:58.180180Z",
            "last_modified_time": "2023-08-16T05:04:58.180201Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sitoutumattomat lehdet",
                "sv": "obundna tidningar",
                "en": "independent newspapers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10202/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15627",
            "has_user_editable_resources": false,
            "alt_labels": [
                "non-alignment"
            ],
            "created_time": "2023-08-16T05:17:37.308890Z",
            "last_modified_time": "2023-08-16T05:17:37.308909Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sitoutumattomuus",
                "sv": "obundenhet",
                "en": "nonalignment"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15627/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39500",
            "has_user_editable_resources": false,
            "alt_labels": [
                "binding (biochemistry)",
                "sitoutuminen (biokemia)",
                "sitoutuminen (lääkkeet)",
                "bindning (biokemi)",
                "bindning (läkemedel)"
            ],
            "created_time": "2023-08-16T05:14:21.897947Z",
            "last_modified_time": "2023-08-16T05:14:21.897965Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sitoutuminen (kemia)",
                "sv": "bindning (kemi)",
                "en": "binding (chemistry)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39500/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13419",
            "has_user_editable_resources": false,
            "alt_labels": [
                "binda sig",
                "förbindande",
                "förpliktelse",
                "becoming committed",
                "bindning (social)",
                "förbindelse"
            ],
            "created_time": "2023-08-16T05:18:49.769751Z",
            "last_modified_time": "2023-08-16T05:18:49.769776Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sitoutuminen (toiminta)",
                "sv": "förbinda sig",
                "en": "committing oneself"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13419/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9332",
            "has_user_editable_resources": false,
            "alt_labels": [
                "alppisitra",
                "alpcittra",
                "sitra"
            ],
            "created_time": "2023-08-16T05:08:34.193498Z",
            "last_modified_time": "2023-08-16T05:08:34.193520Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sitra",
                "sv": "cittra",
                "en": "zither"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9332/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5856",
            "has_user_editable_resources": false,
            "alt_labels": [
                "cittror"
            ],
            "created_time": "2023-08-16T05:16:14.790658Z",
            "last_modified_time": "2023-08-16T05:16:14.790675Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sitrasoittimet",
                "sv": "cittrainstrument",
                "en": "zither instruments"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5856/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26138",
            "has_user_editable_resources": false,
            "alt_labels": [
                "guldtopas",
                "kultatopaasi"
            ],
            "created_time": "2023-08-16T05:10:51.966464Z",
            "last_modified_time": "2023-08-16T05:10:51.966483Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sitriini",
                "sv": "citrin",
                "en": "citrine"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26138/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6542",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:59.236222Z",
            "last_modified_time": "2023-08-16T05:17:59.236249Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sitrushedelmät",
                "sv": "citrusfrukter",
                "en": "citrus fruits"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6542/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17913",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:36.979996Z",
            "last_modified_time": "2023-08-16T05:09:36.980014Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sitruuna",
                "sv": "citron",
                "en": "lemon"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17913/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20705",
            "has_user_editable_resources": false,
            "alt_labels": [
                "benediction",
                "siunaus",
                "välsignelse (verksamhet)"
            ],
            "created_time": "2023-08-16T05:10:02.750165Z",
            "last_modified_time": "2023-08-16T05:10:02.750183Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "siunaaminen",
                "sv": "välsignande",
                "en": "blessing (activity)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20705/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8407",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:15.044528Z",
            "last_modified_time": "2023-08-16T05:12:15.044549Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "siunaukset",
                "sv": "välsignelser",
                "en": "blessings (religious accomplishments)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8407/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24869",
            "has_user_editable_resources": false,
            "alt_labels": [
                "siveys",
                "anständighet"
            ],
            "created_time": "2023-08-16T05:10:40.402092Z",
            "last_modified_time": "2023-08-16T05:10:40.402110Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "siveellisyys",
                "sv": "sedlighet",
                "en": "chastity"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24869/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12473",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Viverridae"
            ],
            "created_time": "2023-08-16T05:15:04.673917Z",
            "last_modified_time": "2023-08-16T05:15:04.673970Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sivettieläimet",
                "sv": "sibetdjur",
                "en": "civets"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12473/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16878",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:28.325664Z",
            "last_modified_time": "2023-08-16T05:09:28.325682Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sivettikissat",
                "sv": "sibetkatter",
                "en": "Viverrinae"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16878/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6110",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:03.870207Z",
            "last_modified_time": "2023-08-16T05:12:03.870228Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "siviilikriisinhallinta",
                "sv": "civilkrishantering",
                "en": "civilian crisis management"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6110/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p463",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:54.986532Z",
            "last_modified_time": "2023-08-16T05:17:54.986550Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "siviilioikeus",
                "sv": "civilrätt",
                "en": "civil law"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p463/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}