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 /linkedevents/v1/keyword/?format=api
HTTP 200 OK
Allow: GET, POST, HEAD, OPTIONS
Content-Type: application/json ;utf-8
Vary: Accept

{
    "meta": {
        "count": 3389,
        "next": "https://api.hel.fi/linkedevents/v1/keyword/?format=api&page=2",
        "previous": null
    },
    "data": [
        {
            "id": "yso:p4354",
            "alt_labels": [
                "barn",
                "imeväisikäiset",
                "lapset",
                "spädbarn"
            ],
            "created_time": "2014-06-23T11:37:27.705000Z",
            "last_modified_time": "2017-09-06T05:20:47.061426Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 100932,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "lapset (ikäryhmät)",
                "sv": "barn (åldersgrupper)",
                "en": "children (age groups)"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p4354/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11617",
            "alt_labels": [
                "nuoriso",
                "unga"
            ],
            "created_time": "2014-06-23T11:37:27.563000Z",
            "last_modified_time": "2017-09-06T05:20:59.293091Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 75525,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "nuoret",
                "sv": "ungdomar",
                "en": "young people"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p11617/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16485",
            "alt_labels": [
                "peruskoululaiset"
            ],
            "created_time": "2014-06-23T11:37:26.180000Z",
            "last_modified_time": "2017-09-06T05:20:45.137409Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 57682,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "koululaiset",
                "sv": "skolelever",
                "en": "pupils"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p16485/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13050",
            "alt_labels": [],
            "created_time": "2014-06-23T11:37:23.969000Z",
            "last_modified_time": "2017-09-06T05:20:32.944169Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 53439,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "lapsiperheet",
                "sv": "barnfamiljer",
                "en": "families with children"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p13050/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2433",
            "alt_labels": [
                "ikä-ihmiset",
                "ikäihmiset",
                "gamlingar",
                "seniorer",
                "gamla",
                "äldre människor",
                "äldre personer",
                "vanhukset",
                "seniorit",
                "iäkkäät",
                "åldringar",
                "elderly",
                "older adults",
                "old people",
                "senior citizens"
            ],
            "created_time": "2014-06-23T11:37:26.251000Z",
            "last_modified_time": "2022-05-11T01:40:15.150990Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 49214,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ikääntyneet",
                "sv": "äldre",
                "en": "older people"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p2433/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p916",
            "alt_labels": [
                "motionering",
                "liikuntakäyttäytyminen",
                "motion (gymnastik)",
                "liikkuminen (liikunta)",
                "motion (idrott)"
            ],
            "created_time": "2014-06-23T11:37:27.126000Z",
            "last_modified_time": "2019-05-15T05:20:08.902393Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 44716,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "liikunta",
                "sv": "motion",
                "en": "physical training"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p916/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1808",
            "alt_labels": [
                "musiikki",
                "säveltaide",
                "musikkonst",
                "tonkonst"
            ],
            "created_time": "2014-06-23T11:37:28.044000Z",
            "last_modified_time": "2017-09-06T05:20:22.016421Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 41225,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "musiikki",
                "sv": "musik",
                "en": "music"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p1808/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9270",
            "alt_labels": [],
            "created_time": "2014-06-23T11:37:26.899000Z",
            "last_modified_time": "2017-09-06T05:19:59.267957Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 38983,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "kurssit",
                "sv": "kurser",
                "en": "courses (societal objects)"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p9270/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4363",
            "alt_labels": [
                "ydinperheet",
                "familj",
                "perhe",
                "familjer (grupper)",
                "kärnfamiljer"
            ],
            "created_time": "2014-06-23T11:37:28.246000Z",
            "last_modified_time": "2019-05-11T04:20:04.577893Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 32336,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "perheet",
                "sv": "familjer",
                "en": "families"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p4363/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p360",
            "alt_labels": [],
            "created_time": "2014-06-23T11:37:29.198000Z",
            "last_modified_time": "2017-09-06T05:20:25.832872Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 30634,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "kulttuuritapahtumat",
                "sv": "kulturevenemang",
                "en": "cultural events"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p360/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6165",
            "alt_labels": [
                "immigrantit",
                "immigranter"
            ],
            "created_time": "2014-06-23T11:37:28.630000Z",
            "last_modified_time": "2023-08-31T04:47:47.500809Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 28951,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "maahanmuuttajat",
                "sv": "invandrare",
                "en": "immigrants"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p6165/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2149",
            "alt_labels": [
                "opastukset",
                "opastaminen",
                "vägledning"
            ],
            "created_time": "2014-06-23T11:37:25.994000Z",
            "last_modified_time": "2017-09-06T05:21:07.924133Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 27372,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "opastus",
                "sv": "guidning",
                "en": "guidance"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p2149/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p316",
            "alt_labels": [
                "leken",
                "lek (barnlek)",
                "lek",
                "lek (mental aktivitet)",
                "barnlek",
                "leikki (leikkiminen)",
                "leikki"
            ],
            "created_time": "2014-06-23T11:37:26.834000Z",
            "last_modified_time": "2019-05-08T04:19:51.933927Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 25892,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "leikkiminen",
                "sv": "lek (aktivitet)",
                "en": "playing (children's games)"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p316/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2625",
            "alt_labels": [
                "teatteritaide",
                "teatteri",
                "näyttämötaide",
                "scenkonst",
                "teaterkonst",
                "teater",
                "dramatic art",
                "teatteri (taiteet)",
                "teater (konstarter)",
                "puheteatteri",
                "talteater",
                "theater"
            ],
            "created_time": "2014-06-23T11:37:27.748000Z",
            "last_modified_time": "2023-08-31T04:47:51.550713Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 24976,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "teatteritaide",
                "sv": "teaterkonst",
                "en": "theatre (art forms)"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p2625/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10727",
            "alt_labels": [
                "kansalaisosallistuminen",
                "kansalaisten osallistuminen",
                "kansalaisaktivismi",
                "medborgaraktivism",
                "medborgarinflytande",
                "medborgardeltagande",
                "engagemang"
            ],
            "created_time": "2014-06-23T11:37:28.213000Z",
            "last_modified_time": "2017-09-06T05:20:57.830630Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 22589,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "osallistuminen",
                "sv": "deltagande",
                "en": "participation"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p10727/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6062",
            "alt_labels": [
                "spel (objekt)"
            ],
            "created_time": "2014-06-23T11:37:24.440000Z",
            "last_modified_time": "2017-09-06T05:20:54.945885Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 21920,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "pelit",
                "sv": "spel",
                "en": "games"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p6062/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14004",
            "alt_labels": [
                "diskussion"
            ],
            "created_time": "2014-06-23T11:37:27.886000Z",
            "last_modified_time": "2017-09-06T05:20:58.680345Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 21031,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "keskustelu",
                "sv": "samtal",
                "en": "conversation"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p14004/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8105",
            "alt_labels": [
                "leikkikentät"
            ],
            "created_time": "2014-06-23T11:37:28.731000Z",
            "last_modified_time": "2017-09-06T05:21:10.313676Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 18303,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "leikkipuistot",
                "sv": "lekparker",
                "en": "playgrounds"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p8105/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1278",
            "alt_labels": [
                "tanssitaide",
                "tanssi",
                "danskonst",
                "tanssit",
                "danser"
            ],
            "created_time": "2014-06-23T11:37:28.946000Z",
            "last_modified_time": "2017-09-06T05:20:51.217975Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 18259,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tanssi",
                "sv": "dans",
                "en": "dance (performing arts)"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p1278/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1947",
            "alt_labels": [
                "hyvinvointi (taloudellinen)",
                "hyvinvointi (aineellinen)",
                "prosperity",
                "welfare (well-being)"
            ],
            "created_time": "2014-06-23T11:37:23.778000Z",
            "last_modified_time": "2019-05-16T05:20:11.428706Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 17469,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hyvinvointi",
                "sv": "välfärd",
                "en": "well-being"
            },
            "@id": "https://api.hel.fi/linkedevents/v1/keyword/yso:p1947/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}