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

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

{
    "meta": {
        "count": 31946,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1311&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1309&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p1071",
            "has_user_editable_resources": false,
            "alt_labels": [
                "varv (verkstäder)"
            ],
            "created_time": "2023-08-16T05:12:26.960417Z",
            "last_modified_time": "2023-08-16T05:12:26.960435Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "telakat",
                "sv": "skeppsvarv",
                "en": "shipyards"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1071/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4616",
            "has_user_editable_resources": false,
            "alt_labels": [
                "laivanrakennusteollisuus",
                "skeppsbyggnadsindustri"
            ],
            "created_time": "2023-08-16T05:17:12.078177Z",
            "last_modified_time": "2023-08-16T05:17:12.078202Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "telakkateollisuus",
                "sv": "varvsindustri",
                "en": "shipbuilding industry"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4616/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p040856",
            "has_user_editable_resources": false,
            "alt_labels": [
                "telakat (telakointiasemat)"
            ],
            "created_time": "2025-07-01T04:39:48.564160Z",
            "last_modified_time": "2025-07-01T04:39:48.564178Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "telakointiasemat",
                "sv": "dockningsstationer",
                "en": "docking stations"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p040856/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17359",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:32.399307Z",
            "last_modified_time": "2025-08-08T04:40:02.347462Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "telakointi (vesikulkuneuvot)",
                "sv": "dockning (vattenfarkoster)",
                "en": "docking (watercrafts)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17359/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12250",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:35.360374Z",
            "last_modified_time": "2023-08-16T05:12:35.360392Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "telat",
                "sv": "valsar",
                "en": "rollers (technical objects)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12250/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10799",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:43.007307Z",
            "last_modified_time": "2023-08-16T05:08:43.007328Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "teleala",
                "sv": "telebranschen",
                "en": "telecommunications sector"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10799/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12201",
            "has_user_editable_resources": false,
            "alt_labels": [
                "faksi",
                "telefax",
                "fax (tjänster)",
                "telefaksimil",
                "telekopiering"
            ],
            "created_time": "2023-08-16T05:08:52.870873Z",
            "last_modified_time": "2023-08-16T05:08:52.870892Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "telekopiointi",
                "sv": "telefax",
                "en": "facsimile transmission"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12201/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9770",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kaukokirjoittimet",
                "telex",
                "fjärrskrivmaskiner"
            ],
            "created_time": "2023-08-16T05:17:28.162624Z",
            "last_modified_time": "2023-08-16T05:17:28.162644Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "teleksi",
                "sv": "telex",
                "en": "telex"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9770/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39248",
            "has_user_editable_resources": false,
            "alt_labels": [
                "interception of telecommunications",
                "telecommunications interception",
                "telemonitoring (interception)",
                "wire tapping",
                "wiretapping",
                "salakuuntelu (tekninen tarkkailu)",
                "telefonavlyssning"
            ],
            "created_time": "2023-08-16T05:16:05.434348Z",
            "last_modified_time": "2023-08-16T05:16:05.434367Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "telekuuntelu",
                "sv": "teleavlyssning",
                "en": "telephone tapping"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39248/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11828",
            "has_user_editable_resources": false,
            "alt_labels": [
                "puhelinlaitokset",
                "telefoninrättningar",
                "telefonverk"
            ],
            "created_time": "2023-08-16T05:12:33.149358Z",
            "last_modified_time": "2023-08-16T05:12:33.149381Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "telelaitokset",
                "sv": "televerk",
                "en": "telecommunications companies"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11828/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20333",
            "has_user_editable_resources": false,
            "alt_labels": [
                "etälääketiede"
            ],
            "created_time": "2023-08-16T05:09:59.251475Z",
            "last_modified_time": "2023-08-16T05:09:59.251494Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "telelääketiede",
                "sv": "telemedicin",
                "en": "telemedicine"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20333/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22900",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:30.079639Z",
            "last_modified_time": "2023-08-16T05:13:30.079659Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "telemark",
                "en": "telemark"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22900/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8356",
            "has_user_editable_resources": false,
            "alt_labels": [
                "telemarknad"
            ],
            "created_time": "2023-08-16T05:12:14.728610Z",
            "last_modified_time": "2023-08-16T05:12:14.728635Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "telemarkkinat",
                "sv": "telemarknaden",
                "en": "telemarket"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8356/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8943",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:04.874040Z",
            "last_modified_time": "2023-08-16T05:18:04.874059Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "telematiikka",
                "sv": "telematik",
                "en": "telematics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8943/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6128",
            "has_user_editable_resources": false,
            "alt_labels": [
                "audiokokoukset",
                "audiokonferenssit",
                "audioneuvottelut",
                "elektroniset kokoukset",
                "puhelinneuvottelut",
                "pääteneuvottelut",
                "telekokoukset",
                "telekonferenssit",
                "tietokonekokoukset",
                "verkkokokoukset",
                "verkkokonferenssit",
                "verkkoneuvottelut",
                "audiokonferenser",
                "datorkonferenser",
                "elektroniska konferenser",
                "telefonkonferenser",
                "telemöten"
            ],
            "created_time": "2023-08-16T05:16:15.898170Z",
            "last_modified_time": "2023-08-16T05:16:15.898189Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "teleneuvottelut",
                "sv": "telekonferenser",
                "en": "teleconferences"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6128/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19109",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:47.752335Z",
            "last_modified_time": "2023-08-16T05:09:47.752355Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "teleologia",
                "sv": "teleologi",
                "en": "teleology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19109/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11827",
            "has_user_editable_resources": false,
            "alt_labels": [
                "mobile phone operators",
                "phone operators",
                "matkapuhelinoperaattorit",
                "operaattorit (teleala)",
                "puhelinoperaattorit",
                "teleyritykset",
                "mobiloperatörer",
                "mobiltelefonoperatörer",
                "operatörer (telebranschen)",
                "telefonoperatörer",
                "teleföretag"
            ],
            "created_time": "2023-08-16T05:15:01.731321Z",
            "last_modified_time": "2023-08-16T05:15:01.731340Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "teleoperaattorit",
                "sv": "teleoperatörer",
                "en": "teleoperators"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11827/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6627",
            "has_user_editable_resources": false,
            "alt_labels": [
                "telemaattiset palvelut",
                "tietoliikennepalvelut",
                "telekommunikationstjänster"
            ],
            "created_time": "2023-08-16T05:19:19.244767Z",
            "last_modified_time": "2023-08-16T05:19:19.244785Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "telepalvelut",
                "sv": "teletjänster",
                "en": "telecommunications services"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6627/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14682",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ajatusten lukeminen",
                "tankeläsning"
            ],
            "created_time": "2023-08-16T05:09:10.972476Z",
            "last_modified_time": "2023-08-16T05:09:10.972494Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "telepatia",
                "sv": "telepati",
                "en": "telepathy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14682/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26071",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kaukosiirtäminen"
            ],
            "created_time": "2023-08-16T05:07:10.570233Z",
            "last_modified_time": "2023-08-16T05:07:10.570286Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "teleportaatio",
                "sv": "teleportering",
                "en": "teleportation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26071/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}