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

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

{
    "meta": {
        "count": 31725,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1403&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1401&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p9684",
            "has_user_editable_resources": false,
            "alt_labels": [
                "uniapnea",
                "uniapneasyndrooma",
                "sömnapné"
            ],
            "created_time": "2023-08-16T05:12:22.001849Z",
            "last_modified_time": "2023-08-16T05:12:22.001886Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "uniapnea-oireyhtymä",
                "sv": "sömnapnésyndrom",
                "en": "sleep apnea syndrome"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9684/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9562",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:35.476828Z",
            "last_modified_time": "2023-08-16T05:08:35.476857Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "UNICOS",
                "en": "UNICOS"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9562/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13589",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:18.981791Z",
            "last_modified_time": "2023-08-16T05:05:18.981810Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Uniedit",
                "en": "Uniedit"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13589/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12466",
            "has_user_editable_resources": false,
            "alt_labels": [
                "unientulkinta",
                "drömtolkning"
            ],
            "created_time": "2023-08-16T05:12:36.186233Z",
            "last_modified_time": "2023-08-16T05:12:36.186279Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "unien tulkinta",
                "sv": "drömtydning",
                "en": "dream interpretation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12466/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10945",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:02.359029Z",
            "last_modified_time": "2023-08-16T05:05:02.359050Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Unigraph",
                "en": "Unigraph"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10945/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38163",
            "has_user_editable_resources": false,
            "alt_labels": [
                "sömnförlamning"
            ],
            "created_time": "2023-08-16T05:07:52.256103Z",
            "last_modified_time": "2023-08-16T05:07:52.256132Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "unihalvaus",
                "sv": "sömnparalys",
                "en": "sleep paralysis"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38163/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4600",
            "has_user_editable_resources": false,
            "alt_labels": [
                "unenpuute",
                "univaikeudet",
                "sömnsvårigheter"
            ],
            "created_time": "2023-08-16T05:19:18.347677Z",
            "last_modified_time": "2023-08-16T05:19:18.347694Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "unihäiriöt",
                "sv": "sömnstörningar",
                "en": "sleep disorders"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4600/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12519",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:11.914794Z",
            "last_modified_time": "2023-08-16T05:05:11.914812Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "unikeonpäivä",
                "sv": "sjusovardagen",
                "en": "Seven Sleepers' Day"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12519/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29051",
            "has_user_editable_resources": false,
            "alt_labels": [
                "drömtolkningsböcker",
                "drömtydningsböcker"
            ],
            "created_time": "2023-08-16T05:15:52.378665Z",
            "last_modified_time": "2023-08-16T05:15:52.378686Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "unikirjat",
                "sv": "drömböcker",
                "en": "dream books"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29051/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29595",
            "has_user_editable_resources": false,
            "alt_labels": [
                "poppy family (plants)"
            ],
            "created_time": "2023-08-16T05:11:21.359761Z",
            "last_modified_time": "2023-08-16T05:11:21.359778Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "unikkokasvit",
                "sv": "vallmoväxter",
                "en": "Papaveraceae"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29595/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29605",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:40.859641Z",
            "last_modified_time": "2023-08-16T05:07:40.859659Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "unikot",
                "sv": "vallmor",
                "en": "poppies"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29605/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p040839",
            "has_user_editable_resources": false,
            "alt_labels": [
                "comfort items",
                "comfort objects",
                "mjukisar (sömnleksaker)",
                "snutteleksaker"
            ],
            "created_time": "2025-07-01T04:39:48.380701Z",
            "last_modified_time": "2025-07-01T04:39:48.380712Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "unilelut",
                "sv": "sömnleksaker",
                "en": "bedtime comfort objects"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p040839/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8299",
            "has_user_editable_resources": false,
            "alt_labels": [
                "nukkuminen",
                "sovande"
            ],
            "created_time": "2023-08-16T05:19:13.938239Z",
            "last_modified_time": "2023-08-16T05:19:13.938304Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "uni (lepotila)",
                "sv": "sömn",
                "en": "sleep"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8299/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40426",
            "has_user_editable_resources": false,
            "alt_labels": [
                "sömnmedicinsk specialitet"
            ],
            "created_time": "2024-06-14T04:40:18.725561Z",
            "last_modified_time": "2024-08-29T04:40:16.559240Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "unilääketiede",
                "sv": "sömnmedicin (kunskapsområden)",
                "en": "sleep medicine"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40426/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6736",
            "has_user_editable_resources": false,
            "alt_labels": [
                "nukahtamislääkkeet",
                "sömnläkemedel",
                "sömnmediciner",
                "sömnpiller",
                "sömntabletter"
            ],
            "created_time": "2023-08-16T05:08:23.072100Z",
            "last_modified_time": "2023-08-16T05:08:23.072117Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "unilääkkeet",
                "sv": "sömnmedel",
                "en": "sleep medication"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6736/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20760",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:26.547930Z",
            "last_modified_time": "2023-08-16T05:06:26.547949Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "unionismi",
                "sv": "unionism",
                "en": "unionism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20760/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18224",
            "has_user_editable_resources": false,
            "alt_labels": [
                "noctambulism",
                "somnambulism",
                "somnambulism"
            ],
            "created_time": "2023-08-16T05:05:58.537252Z",
            "last_modified_time": "2023-08-16T05:05:58.537299Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "unissakävely",
                "sv": "sömngång",
                "en": "sleepwalking"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18224/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17542",
            "has_user_editable_resources": false,
            "alt_labels": [
                "unitaariuniversalistit"
            ],
            "created_time": "2023-08-16T05:09:33.793921Z",
            "last_modified_time": "2023-08-16T05:09:33.793938Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "unitaarit",
                "sv": "unitarier",
                "en": "Unitarians"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17542/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21988",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:32.007018Z",
            "last_modified_time": "2023-08-16T05:15:32.007037Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "unitutkimus",
                "sv": "sömnforskning",
                "en": "sleep research"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21988/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4599",
            "has_user_editable_resources": false,
            "alt_labels": [
                "unenpuute",
                "univelka",
                "sömnunderskott"
            ],
            "created_time": "2023-08-16T05:18:23.230642Z",
            "last_modified_time": "2023-08-16T05:18:23.230660Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "univaje",
                "sv": "sömnbrist",
                "en": "sleep debt"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4599/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}