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=36&show_all_keywords=True

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

{
    "meta": {
        "count": 31675,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=37&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=35&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p38533",
            "has_user_editable_resources": false,
            "alt_labels": [
                "hermosyyt",
                "viejähaarakkeet",
                "nervcellsutskott",
                "nervtrådar"
            ],
            "created_time": "2023-08-16T05:11:38.668115Z",
            "last_modified_time": "2023-08-16T05:11:38.668135Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aksonit",
                "sv": "axoner",
                "en": "axons"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38533/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38376",
            "has_user_editable_resources": false,
            "alt_labels": [
                "liikeaktiviteettirekisteröinti"
            ],
            "created_time": "2023-08-16T05:07:54.617164Z",
            "last_modified_time": "2023-08-16T05:07:54.617191Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aktigrafia",
                "sv": "aktigrafi",
                "en": "actigraphy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38376/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28426",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:58.562691Z",
            "last_modified_time": "2023-08-16T05:13:58.562710Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aktiinit",
                "sv": "aktiner",
                "en": "actins"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28426/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20212",
            "has_user_editable_resources": false,
            "alt_labels": [
                "aktivum"
            ],
            "created_time": "2023-08-16T05:06:20.948519Z",
            "last_modified_time": "2023-08-16T05:06:20.948538Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aktiivi",
                "sv": "aktiv",
                "en": "active voice"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20212/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25569",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:41.233119Z",
            "last_modified_time": "2023-08-16T05:15:41.233141Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aktiivihiili",
                "sv": "aktivt kol",
                "en": "activated carbon"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25569/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40577",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2025-01-22T04:41:18.873218Z",
            "last_modified_time": "2025-01-24T07:25:26.167283Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aktiivikerros (maaperä)",
                "sv": "aktivt lager (jordlager)",
                "en": "active layer (soil)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40577/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38812",
            "has_user_editable_resources": false,
            "alt_labels": [
                "aktiveringsmodellen"
            ],
            "created_time": "2023-08-16T05:14:17.358679Z",
            "last_modified_time": "2023-08-16T05:14:17.358697Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aktiivimalli",
                "sv": "aktiveringsmodell",
                "en": "activation model in employment policy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38812/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15704",
            "has_user_editable_resources": false,
            "alt_labels": [
                "aktivitet (egenskaper)"
            ],
            "created_time": "2023-08-16T05:18:50.427788Z",
            "last_modified_time": "2023-08-16T05:18:50.427806Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aktiivisuus",
                "sv": "aktivitet",
                "en": "activity (properties)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15704/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40301",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Actinobacteria",
                "aktinomykeetit",
                "aktinomyceter",
                "actinomycetes",
                "sädesienet"
            ],
            "created_time": "2024-03-21T04:40:24.485656Z",
            "last_modified_time": "2024-04-05T04:41:05.303396Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aktinobakteerit",
                "sv": "aktinobakterier",
                "en": "Actinobacteria"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40301/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4738",
            "has_user_editable_resources": false,
            "alt_labels": [
                "level of activation"
            ],
            "created_time": "2023-08-16T05:16:10.721484Z",
            "last_modified_time": "2023-08-16T05:16:10.721502Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aktivaatiotaso",
                "sv": "aktivationsnivå",
                "en": "activation level"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4738/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p040825",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2025-07-01T04:40:12.185878Z",
            "last_modified_time": "2025-07-01T04:40:12.185888Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aktiviinireseptorit",
                "sv": "aktivinreceptorer",
                "en": "activin receptors"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p040825/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39518",
            "has_user_editable_resources": false,
            "alt_labels": [
                "FSH-releasing proteins"
            ],
            "created_time": "2023-08-16T05:11:48.353581Z",
            "last_modified_time": "2023-08-16T05:11:48.353597Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aktiviinit",
                "sv": "aktiviner",
                "en": "activins"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39518/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21733",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kansalaisaktivismi",
                "kansalaisosallistuminen",
                "kansalaisten osallistuminen",
                "medborgaraktivism",
                "medborgardeltagande",
                "poliittinen aktivismi",
                "politisk aktivism",
                "civic activism",
                "political activism"
            ],
            "created_time": "2023-08-16T05:15:31.219334Z",
            "last_modified_time": "2023-08-16T05:15:31.219352Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aktivismi",
                "sv": "aktivism",
                "en": "activism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21733/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13939",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:34.356629Z",
            "last_modified_time": "2023-08-16T05:18:34.356647Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aktivistit",
                "sv": "aktivister",
                "en": "activists"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13939/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17894",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:36.842638Z",
            "last_modified_time": "2023-08-16T05:09:36.842655Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aktivointi",
                "sv": "aktivering",
                "en": "activation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17894/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38810",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:17.336333Z",
            "last_modified_time": "2023-08-16T05:14:17.336350Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aktomyosiini",
                "sv": "aktomyosin",
                "en": "actomyosin"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38810/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18948",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:06.498940Z",
            "last_modified_time": "2023-08-16T05:06:06.498959Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aktuaarit",
                "sv": "aktuarier",
                "en": "actuaries"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18948/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9501",
            "has_user_editable_resources": false,
            "alt_labels": [
                "akupainanta",
                "akupressur"
            ],
            "created_time": "2023-08-16T05:12:21.050493Z",
            "last_modified_time": "2023-08-16T05:12:21.050510Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akuhieronta",
                "sv": "akupunkturmassage",
                "en": "acupressure"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9501/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9502",
            "has_user_editable_resources": false,
            "alt_labels": [
                "akupunktuuri"
            ],
            "created_time": "2023-08-16T05:12:21.087860Z",
            "last_modified_time": "2023-08-16T05:12:21.087877Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akupunktio",
                "sv": "akupunktur",
                "en": "acupuncture"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9502/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2909",
            "has_user_editable_resources": false,
            "alt_labels": [
                "huoneakustiikka",
                "rakennusakustiikka",
                "äänioppi",
                "byggnadsakustik",
                "rumsakustik"
            ],
            "created_time": "2023-08-16T05:18:39.165427Z",
            "last_modified_time": "2023-08-16T05:18:39.165446Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "akustiikka",
                "sv": "akustik",
                "en": "acoustics (phonics)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2909/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}