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

{
    "meta": {
        "count": 31675,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=58&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=56&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p22080",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kylpyammeet",
                "kar"
            ],
            "created_time": "2023-08-16T05:13:25.376234Z",
            "last_modified_time": "2023-08-16T05:13:25.376251Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ammeet",
                "sv": "badkar",
                "en": "bathtubs"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22080/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1889",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:45.599507Z",
            "last_modified_time": "2023-08-16T05:09:45.599524Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ammoniakki",
                "sv": "ammoniak",
                "en": "ammonia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1889/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24405",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:55.543513Z",
            "last_modified_time": "2023-08-16T05:06:55.543530Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ammoniumnitraatti",
                "sv": "ammoniumnitrat",
                "en": "ammonium nitrate"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24405/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5857",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ammunition (projektiler)",
                "vapenprojektiler",
                "ammukset (laukaistavat)",
                "projektiilit"
            ],
            "created_time": "2023-08-16T05:17:57.700145Z",
            "last_modified_time": "2025-07-31T04:41:31.821445Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ammukset",
                "sv": "projektiler",
                "en": "projectiles (ammunition)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5857/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15302",
            "has_user_editable_resources": false,
            "alt_labels": [
                "shooting (sport)",
                "ampumaurheilu",
                "ampuminen",
                "skjutning",
                "sportskytte"
            ],
            "created_time": "2023-08-16T05:18:11.903103Z",
            "last_modified_time": "2023-08-16T05:18:11.903121Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ammunta",
                "sv": "skytte",
                "en": "shooting"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15302/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26433",
            "has_user_editable_resources": false,
            "alt_labels": [
                "räiskintäpelit"
            ],
            "created_time": "2023-08-16T05:15:43.411366Z",
            "last_modified_time": "2023-08-16T05:15:43.411384Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ammuntapelit",
                "sv": "skjutspel",
                "en": "shooting games"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26433/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15439",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:42.763987Z",
            "last_modified_time": "2023-08-16T05:16:42.764004Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "amorfiset aineet",
                "sv": "amorfa ämnen",
                "en": "amorphous substances"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15439/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39081",
            "has_user_editable_resources": false,
            "alt_labels": [
                "amurrulaiset",
                "amoreer",
                "amoréer"
            ],
            "created_time": "2023-08-16T05:11:44.268760Z",
            "last_modified_time": "2023-08-16T05:11:44.268777Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "amorilaiset",
                "sv": "amoriter",
                "en": "Amorites"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39081/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23984",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:34.860026Z",
            "last_modified_time": "2023-08-16T05:13:34.860051Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Amorph!",
                "en": "Amorph! Festival"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23984/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16683",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:59.027618Z",
            "last_modified_time": "2023-08-16T05:12:59.027638Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ampiaiset",
                "sv": "getingar",
                "en": "Vespidae"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16683/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28724",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Falco columbarius"
            ],
            "created_time": "2023-08-16T05:07:32.555998Z",
            "last_modified_time": "2023-08-16T05:07:32.556014Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ampuhaukka",
                "sv": "stenfalk",
                "en": "merlin (Falconidae)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28724/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23616",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:49.030023Z",
            "last_modified_time": "2023-08-16T05:06:49.030042Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ampuma-alueet",
                "sv": "skjutområden",
                "en": "shooting zones"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23616/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11352",
            "has_user_editable_resources": false,
            "alt_labels": [
                "guns (firearms)",
                "pyssyt",
                "tuliaseet",
                "bössor",
                "eldvapen"
            ],
            "created_time": "2023-08-16T05:18:08.529960Z",
            "last_modified_time": "2023-08-16T05:18:08.529978Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ampuma-aseet",
                "sv": "skjutvapen",
                "en": "firearms"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11352/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23438",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:28.224869Z",
            "last_modified_time": "2023-08-16T05:10:28.224887Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ampuma-aselaki",
                "sv": "skjutvapenlag",
                "en": "Firearms Act"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23438/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11800",
            "has_user_editable_resources": false,
            "alt_labels": [
                "biathlon",
                "biatlon"
            ],
            "created_time": "2023-08-16T05:08:49.727520Z",
            "last_modified_time": "2023-08-16T05:08:49.727548Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ampumahiihto",
                "sv": "skidskytte",
                "en": "biathlon"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11800/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24958",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:59.264485Z",
            "last_modified_time": "2023-08-16T05:06:59.264503Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ampumahiihtäjät",
                "sv": "skidskyttar",
                "en": "biathlonists"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24958/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40596",
            "has_user_editable_resources": false,
            "alt_labels": [
                "skytteutbildning (militär utbildning)",
                "firearms training (military education)"
            ],
            "created_time": "2025-01-21T04:40:53.817795Z",
            "last_modified_time": "2025-01-24T07:25:01.683789Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ampumakoulutus (sotilaskoulutus)",
                "sv": "skjututbildning (militär utbildning)",
                "en": "markmanship training"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40596/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5533",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:01.086297Z",
            "last_modified_time": "2023-08-16T05:12:01.086317Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ampumaradat",
                "sv": "skjutbanor",
                "en": "shooting ranges"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5533/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13635",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ammukset (ampumatarvikkeet)",
                "skjuttillbehör"
            ],
            "created_time": "2023-08-16T05:12:42.481900Z",
            "last_modified_time": "2023-08-16T05:12:42.481918Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ampumatarvikkeet",
                "sv": "ammunition",
                "en": "ammunition"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13635/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10264",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ampujat",
                "skyttar (idrott)"
            ],
            "created_time": "2023-08-16T05:04:58.705795Z",
            "last_modified_time": "2023-08-16T05:04:58.705822Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ampumaurheilijat",
                "sv": "sportskyttar",
                "en": "shooters (athletes)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10264/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}