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=1228&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=1229&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1227&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p39618",
            "has_user_editable_resources": false,
            "alt_labels": [
                "sublimaatio (painomenetelmät)",
                "sublimaatiopainatus",
                "sublimation (utskrift)"
            ],
            "created_time": "2023-08-16T05:08:07.670244Z",
            "last_modified_time": "2023-08-16T05:08:07.670291Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sublimaatiotulostus",
                "sv": "sublimering (utskrift)",
                "en": "dye-sublimation printing"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39618/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39804",
            "has_user_editable_resources": false,
            "alt_labels": [
                "sublimaatio (fysiikka)",
                "sublimation (fasomvandling)"
            ],
            "created_time": "2023-08-16T05:08:09.964945Z",
            "last_modified_time": "2023-08-16T05:08:09.964963Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sublimoituminen (fysiikka)",
                "sv": "sublimering (fasomvandling)",
                "en": "sublimation (phase transition)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39804/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18138",
            "has_user_editable_resources": false,
            "alt_labels": [
                "läheisyysperiaate",
                "subsidiariteettiperiaate",
                "toissijaisuusperiaate",
                "närhetsprincipen",
                "subsidiaritetsprincipen"
            ],
            "created_time": "2023-08-16T05:13:06.581887Z",
            "last_modified_time": "2023-08-16T05:13:06.581907Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "subsidiariteetti",
                "sv": "subsidiaritet",
                "en": "subsidiarity"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18138/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1058",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:57.638916Z",
            "last_modified_time": "2023-08-16T05:14:57.638932Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "substanssi (filosofia)",
                "sv": "substans (filosofi)",
                "en": "substance (philosophy)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1058/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p41284",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2026-06-25T04:41:04.375116Z",
            "last_modified_time": "2026-06-25T04:41:04.375135Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "substantiivilausekkeet",
                "sv": "substantivfraser",
                "en": "noun phrases"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p41284/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1906",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:07.629248Z",
            "last_modified_time": "2023-08-16T05:06:07.629292Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "substantiivit",
                "sv": "substantiv",
                "en": "nouns"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1906/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29521",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:04.219286Z",
            "last_modified_time": "2023-08-16T05:14:04.219314Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "substraatit (kemia)",
                "sv": "substrat (kemi)",
                "en": "substrates (chemistry)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29521/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29726",
            "has_user_editable_resources": false,
            "alt_labels": [
                "universal substrate"
            ],
            "created_time": "2023-08-16T05:15:54.660637Z",
            "last_modified_time": "2023-08-16T05:15:54.660654Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "substraatti (filosofia)",
                "sv": "substrat (filosofi)",
                "en": "substrate (philosophy)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29726/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22968",
            "has_user_editable_resources": false,
            "alt_labels": [
                "substratum (linguistics)"
            ],
            "created_time": "2023-08-16T05:15:34.704734Z",
            "last_modified_time": "2023-08-16T05:15:34.704756Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "substraatti (kielitiede)",
                "sv": "substrat (språkvetenskap)",
                "en": "substrate (linguistics)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22968/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p34753",
            "has_user_editable_resources": false,
            "alt_labels": [
                "alateksti",
                "piiloteksti",
                "pohjateksti",
                "subtext (litteratur)"
            ],
            "created_time": "2023-08-16T05:11:29.517993Z",
            "last_modified_time": "2023-08-16T05:11:29.518012Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "subteksti",
                "sv": "undertext (litteratur)",
                "en": "subtext"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p34753/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18669",
            "has_user_editable_resources": false,
            "alt_labels": [
                "subtropiska zonen"
            ],
            "created_time": "2023-08-16T05:15:23.801320Z",
            "last_modified_time": "2023-08-16T05:15:23.801510Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "subtrooppinen vyöhyke",
                "sv": "subtropisk zon",
                "en": "subtropics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18669/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27815",
            "has_user_editable_resources": false,
            "alt_labels": [
                "subwoofers"
            ],
            "created_time": "2023-08-16T05:07:25.191797Z",
            "last_modified_time": "2023-08-16T05:07:25.191817Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "subwooferit",
                "sv": "subwoofrar",
                "en": "subwoofers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27815/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17444",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Sudanis",
                "Sudanese people"
            ],
            "created_time": "2023-08-16T05:05:50.854249Z",
            "last_modified_time": "2023-08-16T05:05:50.854284Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sudanilaiset",
                "sv": "sudaneser",
                "en": "Sudaneses"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17444/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5055",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Odonata"
            ],
            "created_time": "2023-08-16T05:14:30.919297Z",
            "last_modified_time": "2023-08-16T05:14:30.919325Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sudenkorennot",
                "sv": "trollsländor",
                "en": "Odonata"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5055/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23545",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:47.924600Z",
            "last_modified_time": "2023-08-16T05:06:47.924621Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sudokut",
                "sv": "sudoku",
                "en": "sudoku"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23545/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11420",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:04.673959Z",
            "last_modified_time": "2023-08-16T05:05:04.673986Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Suezin kriisi",
                "sv": "Suezkrisen",
                "en": "Suez Crisis"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11420/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4274",
            "has_user_editable_resources": false,
            "alt_labels": [
                "jälkiliitteet",
                "loppuliitteet"
            ],
            "created_time": "2023-08-16T05:14:27.059713Z",
            "last_modified_time": "2023-08-16T05:14:27.059758Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suffiksit",
                "sv": "suffix",
                "en": "suffixes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4274/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p41015",
            "has_user_editable_resources": false,
            "alt_labels": [
                "suffragists"
            ],
            "created_time": "2025-11-13T04:40:34.954165Z",
            "last_modified_time": "2025-11-13T04:40:34.954178Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suffragetit",
                "sv": "suffragetter",
                "en": "suffragettes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p41015/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9772",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:54.380217Z",
            "last_modified_time": "2023-08-16T05:14:54.380241Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suggestio",
                "sv": "suggestion",
                "en": "suggestion"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9772/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15395",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:32.626204Z",
            "last_modified_time": "2023-08-16T05:05:32.626224Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suggestopedia",
                "sv": "suggestopedi",
                "en": "suggestopedia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15395/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}