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=314&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=315&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=313&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p19119",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:47.862728Z",
            "last_modified_time": "2023-08-16T05:09:47.862747Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huumetestit",
                "sv": "narkotikatest",
                "en": "drug tests"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19119/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27971",
            "has_user_editable_resources": false,
            "alt_labels": [
                "vieroitushoito"
            ],
            "created_time": "2023-08-16T05:16:59.356939Z",
            "last_modified_time": "2023-08-16T05:16:59.356957Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huumevieroitus",
                "sv": "drogavvänjning",
                "en": "drug rehabilitation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27971/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9239",
            "has_user_editable_resources": false,
            "alt_labels": [
                "humor"
            ],
            "created_time": "2023-08-16T05:19:14.287382Z",
            "last_modified_time": "2023-08-16T05:19:14.287401Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huumori",
                "sv": "humor",
                "en": "humour"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9239/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25223",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:43.803005Z",
            "last_modified_time": "2023-08-16T05:10:43.803022Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huumorilehdet",
                "sv": "humortidningar",
                "en": "humor magazines‎"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25223/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12081",
            "has_user_editable_resources": false,
            "alt_labels": [
                "sense of humor"
            ],
            "created_time": "2023-08-16T05:08:52.025204Z",
            "last_modified_time": "2023-08-16T05:08:52.025228Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huumorintaju",
                "sv": "sinne för humor",
                "en": "sense of humour"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12081/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5380",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:00.470528Z",
            "last_modified_time": "2023-08-16T05:12:00.470545Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huurre",
                "sv": "dimfrost",
                "en": "hoar frost"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5380/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14254",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:07.508089Z",
            "last_modified_time": "2023-08-16T05:09:07.508107Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huutokauppa",
                "sv": "auktion",
                "en": "auction"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14254/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5626",
            "has_user_editable_resources": false,
            "alt_labels": [
                "inhyseshjon",
                "huutolaiset"
            ],
            "created_time": "2023-08-16T05:12:01.386427Z",
            "last_modified_time": "2026-06-12T04:40:28.605046Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huutolaiset",
                "sv": "sockenbarn",
                "en": "huutolainen"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5626/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23384",
            "has_user_editable_resources": false,
            "alt_labels": [
                "nöjescentrum",
                "entertainment centers"
            ],
            "created_time": "2023-08-16T05:06:45.949336Z",
            "last_modified_time": "2023-08-16T05:06:45.949355Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huvikeskukset",
                "sv": "nöjescentra",
                "en": "entertainment centres"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23384/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2077",
            "has_user_editable_resources": false,
            "alt_labels": [
                "villor",
                "villat (rakennukset)"
            ],
            "created_time": "2023-08-16T05:16:48.895247Z",
            "last_modified_time": "2023-08-16T05:16:48.895296Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huvilat",
                "sv": "sommarvillor",
                "en": "villas"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2077/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8337",
            "has_user_editable_resources": false,
            "alt_labels": [
                "pavilions (gazebos)",
                "paviljongit (huvimajat)",
                "puistomajat",
                "paviljonger"
            ],
            "created_time": "2023-08-16T05:14:47.090444Z",
            "last_modified_time": "2023-08-16T05:14:47.090462Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huvimajat",
                "sv": "lusthus",
                "en": "gazebos"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8337/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27341",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:57.796697Z",
            "last_modified_time": "2023-08-16T05:16:57.796719Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huvipuistolaitteet",
                "sv": "åkattraktioner",
                "en": "amusement rides"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27341/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5351",
            "has_user_editable_resources": false,
            "alt_labels": [
                "teemapuistot (huvipuistot)",
                "theme parks",
                "temaparker"
            ],
            "created_time": "2023-08-16T05:19:05.937711Z",
            "last_modified_time": "2023-08-16T05:19:05.937730Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huvipuistot",
                "sv": "nöjesparker",
                "en": "amusement parks"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5351/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19684",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:13.527591Z",
            "last_modified_time": "2023-08-16T05:13:13.527607Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huviretket",
                "sv": "utflykter",
                "en": "outings"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19684/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5611",
            "has_user_editable_resources": false,
            "alt_labels": [
                "huvitukset",
                "kansanhuvit",
                "folknöjen"
            ],
            "created_time": "2023-08-16T05:19:23.042114Z",
            "last_modified_time": "2023-08-16T05:19:23.042133Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huvit",
                "sv": "nöjen",
                "en": "amusements"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5611/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5612",
            "has_user_editable_resources": false,
            "alt_labels": [
                "nöjesevenemang"
            ],
            "created_time": "2023-08-16T05:19:26.027216Z",
            "last_modified_time": "2023-08-16T05:19:26.027235Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "huvitilaisuudet",
                "sv": "nöjestillställningar",
                "en": "entertainment events"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5612/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1859",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:02.170502Z",
            "last_modified_time": "2023-08-16T05:06:02.170520Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "HVACSIM+",
                "en": "HVACSIM+"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1859/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26231",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Villa Hvittorp",
                "Villa Hvittorp"
            ],
            "created_time": "2023-08-16T05:07:11.855551Z",
            "last_modified_time": "2023-08-16T05:07:11.855571Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Hvittorp",
                "en": "Hvittorp"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26231/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19500",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:12.035495Z",
            "last_modified_time": "2023-08-16T05:06:12.035514Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Hvitträsk",
                "en": "Hvitträsk"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19500/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24038",
            "has_user_editable_resources": false,
            "alt_labels": [
                "hyaluronic acid",
                "hyaluronihappo",
                "hyaluronsyra"
            ],
            "created_time": "2023-08-16T05:13:35.061863Z",
            "last_modified_time": "2023-08-16T05:13:35.061880Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hyaluronaani",
                "sv": "hyaluronan",
                "en": "hyaluronan"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24038/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}