GET

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

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=1571&show_all_keywords=True
HTTP 200 OK
Allow: GET, POST, HEAD, OPTIONS
Content-Type: application/json ;utf-8
Vary: Accept

{
    "meta": {
        "count": 31979,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1572&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1570&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p25071",
            "has_user_editable_resources": false,
            "alt_labels": [
                "e-audiobooks",
                "e-äänikirjat",
                "kasettikirjat",
                "e-ljudböcker",
                "hörböcker",
                "kassettböcker"
            ],
            "created_time": "2023-08-16T05:18:37.855505Z",
            "last_modified_time": "2023-08-16T05:18:37.855523Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "äänikirjat",
                "sv": "ljudböcker",
                "en": "audiobooks"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25071/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5778",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:19.046285Z",
            "last_modified_time": "2023-08-16T05:08:19.046307Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "äänikortit",
                "sv": "ljudkort",
                "en": "sound cards"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5778/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38385",
            "has_user_editable_resources": false,
            "alt_labels": [
                "announcements (audio)",
                "kuulutukset (äänikuulutukset)",
                "högtalarutrop"
            ],
            "created_time": "2023-08-16T05:14:15.243461Z",
            "last_modified_time": "2023-08-16T05:14:15.243480Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "äänikuulutukset",
                "sv": "ljudutrop",
                "en": "audio announcements"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38385/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20661",
            "has_user_editable_resources": false,
            "alt_labels": [
                "rösttröskel",
                "spärr (val)",
                "valtröskel"
            ],
            "created_time": "2023-08-16T05:10:02.443624Z",
            "last_modified_time": "2023-08-16T05:10:02.443642Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "äänikynnys",
                "sv": "spärrgräns",
                "en": "election threshold"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20661/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15836",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kasettilehdet",
                "kassettidningar",
                "taltidskrifter"
            ],
            "created_time": "2023-08-16T05:05:36.688966Z",
            "last_modified_time": "2023-08-16T05:05:36.688998Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "äänilehdet",
                "sv": "taltidningar",
                "en": "audio magazines"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15836/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17544",
            "has_user_editable_resources": false,
            "alt_labels": [
                "gramophone records",
                "records (phonograph records)",
                "vinyl records",
                "LP-levyt",
                "LP-äänilevyt",
                "gramofonilevyt",
                "levyt (äänilevyt)",
                "savikiekot",
                "vinyylilevyt",
                "LP-skivor",
                "skivor (grammofonskivor)",
                "stenkakor",
                "vinylskivor"
            ],
            "created_time": "2023-08-16T05:09:33.826634Z",
            "last_modified_time": "2023-08-16T05:09:33.826652Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "äänilevyt",
                "sv": "grammofonskivor",
                "en": "phonograph records"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17544/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1715",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:45.359387Z",
            "last_modified_time": "2023-08-16T05:16:45.359405Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "äänimaisema",
                "sv": "ljudlandskap",
                "en": "soundscape"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1715/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39818",
            "has_user_editable_resources": false,
            "alt_labels": [
                "äänimaisemat (teokset)",
                "ljudlandskap (verk)",
                "soundscape",
                "soundscape-verk"
            ],
            "created_time": "2023-08-16T05:18:41.340799Z",
            "last_modified_time": "2023-08-16T05:18:41.340818Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "äänimaisemateokset",
                "sv": "soundscapeverk",
                "en": "soundscape works"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39818/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5705",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:34.054755Z",
            "last_modified_time": "2023-08-16T05:14:34.054788Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "äänimerkit",
                "sv": "ljudsignaler",
                "en": "sound signals"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5705/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9430",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:20.475892Z",
            "last_modified_time": "2023-08-16T05:12:20.475909Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ääninauhat",
                "sv": "ljudband",
                "en": "audio tapes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9430/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p95",
            "has_user_editable_resources": false,
            "alt_labels": [
                "magnetofonit",
                "magnetofoner",
                "nauhurit (ääninauhurit)",
                "tape decks",
                "tape recorders (audio)",
                "bandspelare (ljud)"
            ],
            "created_time": "2023-08-16T05:16:28.442771Z",
            "last_modified_time": "2026-04-10T04:40:47.690026Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ääninauhurit",
                "sv": "ljudbandspelare",
                "en": "audio tape recorders"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p95/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26635",
            "has_user_editable_resources": false,
            "alt_labels": [
                "dubbare"
            ],
            "created_time": "2023-08-16T05:07:15.456319Z",
            "last_modified_time": "2023-08-16T05:07:15.456339Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ääninäyttelijät",
                "sv": "röstskådespelare",
                "en": "voice actors"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26635/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9796",
            "has_user_editable_resources": false,
            "alt_labels": [
                "valrätt",
                "suffrage",
                "vaalioikeus"
            ],
            "created_time": "2023-08-16T05:16:29.384767Z",
            "last_modified_time": "2023-08-16T05:16:29.384786Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "äänioikeus",
                "sv": "rösträtt",
                "en": "right to vote"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9796/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27851",
            "has_user_editable_resources": false,
            "alt_labels": [
                "nålmikrofoner"
            ],
            "created_time": "2023-08-16T05:13:54.724367Z",
            "last_modified_time": "2023-08-16T05:13:54.724399Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "äänirasiat",
                "sv": "pickuper",
                "en": "magnetic cartridge"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27851/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29674",
            "has_user_editable_resources": false,
            "alt_labels": [
                "sound poems",
                "äänirunot",
                "ljuddikter"
            ],
            "created_time": "2023-08-16T05:11:22.151611Z",
            "last_modified_time": "2023-08-16T05:11:22.151629Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "äänirunous",
                "sv": "ljudpoesi",
                "en": "sound poetry"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29674/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10237",
            "has_user_editable_resources": false,
            "alt_labels": [
                "audio designers"
            ],
            "created_time": "2023-08-16T05:04:58.448733Z",
            "last_modified_time": "2023-08-16T05:04:58.448759Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "äänisuunnittelijat",
                "sv": "ljuddesigner",
                "en": "sound designers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10237/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13809",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:39.569592Z",
            "last_modified_time": "2023-08-16T05:16:39.569609Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "äänisuunnittelu",
                "sv": "ljudplanering",
                "en": "audio design"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13809/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15737",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ääni-installaatiot",
                "ääniveistokset",
                "ljudinstallationer",
                "ljudskulpturer"
            ],
            "created_time": "2023-08-16T05:16:42.990679Z",
            "last_modified_time": "2023-08-16T05:16:42.990696Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "äänitaide",
                "sv": "ljudkonst",
                "en": "sound art"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15737/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p040844",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2025-07-01T04:40:26.468847Z",
            "last_modified_time": "2025-07-01T04:40:26.468860Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "äänitaiteilijat",
                "sv": "ljudkonstnärer",
                "en": "sound artists"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p040844/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18457",
            "has_user_editable_resources": false,
            "alt_labels": [
                "tehosteäänet"
            ],
            "created_time": "2023-08-16T05:13:08.012705Z",
            "last_modified_time": "2023-08-16T05:13:08.012722Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "äänitehosteet",
                "sv": "ljudeffekter",
                "en": "sound effects"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18457/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}