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=149&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=150&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=148&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p6777",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:39.404609Z",
            "last_modified_time": "2023-08-16T05:14:39.404626Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "diplomi-insinöörit",
                "sv": "diplomingenjörer",
                "en": "Masters of Science (Technology)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6777/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27170",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:00.158011Z",
            "last_modified_time": "2023-08-16T05:11:00.158028Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "diplomityöt",
                "sv": "diplomarbeten",
                "en": "Master's theses (University of Technology)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27170/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15641",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Macromedia Director",
                "Macromedia Director"
            ],
            "created_time": "2023-08-16T05:05:34.702660Z",
            "last_modified_time": "2023-08-16T05:05:34.702681Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Director",
                "en": "Adobe Director"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15641/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3559",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:47.850321Z",
            "last_modified_time": "2023-08-16T05:07:47.850340Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "DirectX",
                "en": "DirectX"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3559/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39687",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:50.436638Z",
            "last_modified_time": "2023-08-16T05:11:50.436656Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "direktiivi (kielitiede)",
                "sv": "direktiv (språkvetenskap)",
                "en": "directive (linguistics)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39687/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24948",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:39.600407Z",
            "last_modified_time": "2023-08-16T05:15:39.600425Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "direktiivilajit",
                "sv": "direktivarter",
                "en": "directive species"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24948/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24522",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:37.552813Z",
            "last_modified_time": "2023-08-16T05:13:37.552831Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "disakkaridit",
                "sv": "disackarider",
                "en": "disaccharides"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24522/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29444",
            "has_user_editable_resources": false,
            "alt_labels": [
                "disinformation"
            ],
            "created_time": "2023-08-16T05:19:17.162078Z",
            "last_modified_time": "2023-08-16T05:19:17.162105Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "disinformaatio",
                "sv": "desinformation",
                "en": "disinformation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29444/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9079",
            "has_user_editable_resources": false,
            "alt_labels": [
                "levyluettelot",
                "äänilevyluettelot",
                "ääniteluettelot",
                "fonogramkataloger",
                "skivförteckningar",
                "skivkataloger"
            ],
            "created_time": "2023-08-16T05:17:25.730000Z",
            "last_modified_time": "2023-08-16T05:17:25.730019Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "diskografiat",
                "sv": "diskografier",
                "en": "discographies"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9079/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12374",
            "has_user_editable_resources": false,
            "alt_labels": [
                "disco (musik)",
                "discomusik"
            ],
            "created_time": "2023-08-16T05:18:49.444574Z",
            "last_modified_time": "2023-08-16T05:18:49.444592Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "diskomusiikki",
                "sv": "diskomusik",
                "en": "disco music"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12374/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19862",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:16.492814Z",
            "last_modified_time": "2023-08-16T05:06:16.492832Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "diskonttaus",
                "sv": "diskontering",
                "en": "discounting"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19862/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40705",
            "has_user_editable_resources": false,
            "alt_labels": [
                "diskordianism"
            ],
            "created_time": "2025-03-13T04:40:28.325129Z",
            "last_modified_time": "2025-03-28T04:40:06.154415Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "diskordianismi",
                "sv": "discordianism",
                "en": "discordianism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40705/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11756",
            "has_user_editable_resources": false,
            "alt_labels": [
                "discotheques",
                "diskoteekit",
                "diskotek"
            ],
            "created_time": "2023-08-16T05:15:01.573051Z",
            "last_modified_time": "2023-08-16T05:15:01.573070Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "diskot",
                "sv": "diskon",
                "en": "discos"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11756/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13872",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:20.919315Z",
            "last_modified_time": "2023-08-16T05:05:20.919336Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "diskotanssit",
                "sv": "diskodanser",
                "en": "disco dances"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13872/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27156",
            "has_user_editable_resources": false,
            "alt_labels": [
                "finit matematik"
            ],
            "created_time": "2023-08-16T05:07:20.283176Z",
            "last_modified_time": "2023-08-16T05:07:20.283194Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "diskreetti matematiikka",
                "sv": "diskret matematik",
                "en": "discrete mathematics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27156/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17817",
            "has_user_editable_resources": false,
            "alt_labels": [
                "discourses",
                "diskurssit",
                "diskurser"
            ],
            "created_time": "2023-08-16T05:13:05.116483Z",
            "last_modified_time": "2023-08-16T05:13:05.116508Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "diskurssi",
                "sv": "diskurs",
                "en": "discourse"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17817/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7829",
            "has_user_editable_resources": false,
            "alt_labels": [
                "keskusteluntutkimus"
            ],
            "created_time": "2023-08-16T05:18:02.159785Z",
            "last_modified_time": "2023-08-16T05:18:02.159803Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "diskurssianalyysi",
                "sv": "diskursanalys",
                "en": "discourse analysis"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7829/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21078",
            "has_user_editable_resources": false,
            "alt_labels": [
                "diskurssitutkimus"
            ],
            "created_time": "2023-08-16T05:16:49.564142Z",
            "last_modified_time": "2023-08-16T05:16:49.564159Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "diskurssintutkimus",
                "sv": "diskursforskning",
                "en": "discourse research"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21078/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26081",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:51.808462Z",
            "last_modified_time": "2023-08-16T05:10:51.808481Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "diskurssiteoriat",
                "sv": "diskursteorier",
                "en": "discourse theories"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26081/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8838",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:04.741513Z",
            "last_modified_time": "2023-08-16T05:18:04.741543Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "dispersiot (seokset)",
                "sv": "dispersioner (blandningar)",
                "en": "dispersions (mixtures)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8838/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}