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=1551&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=1552&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1550&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p19144",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:08.434312Z",
            "last_modified_time": "2023-08-16T05:06:08.434332Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "yösuunnistus",
                "sv": "nattorientering",
                "en": "night orienteering"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19144/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9735",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:22.170591Z",
            "last_modified_time": "2023-08-16T05:12:22.170609Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "yötyö",
                "sv": "nattarbete",
                "en": "night work"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9735/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23541",
            "has_user_editable_resources": false,
            "alt_labels": [
                "nycturia",
                "nokturia",
                "nykturia",
                "yövirtsaisuus",
                "nattkissande",
                "nattkissning",
                "nykturi"
            ],
            "created_time": "2023-08-16T05:06:47.888734Z",
            "last_modified_time": "2023-08-16T05:06:47.888753Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "yövirtsaaminen",
                "sv": "nokturi",
                "en": "nocturia"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23541/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29286",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Z39.50 (standardi)",
                "Z39.50 (standard)"
            ],
            "created_time": "2023-08-16T05:11:18.323196Z",
            "last_modified_time": "2023-08-16T05:11:18.323214Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Z39.50",
                "en": "Z39.50"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29286/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40640",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2025-03-27T04:40:25.541303Z",
            "last_modified_time": "2025-03-27T04:40:25.541318Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "zamucolaiset kielet",
                "sv": "zamuco (språkfamiljer)",
                "en": "Zamucoan languages"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40640/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22812",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Zapadniks"
            ],
            "created_time": "2023-08-16T05:10:21.965345Z",
            "last_modified_time": "2023-08-16T05:10:21.965363Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "zapadnikit",
                "sv": "zapadniker",
                "en": "Westernisers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22812/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5774",
            "has_user_editable_resources": false,
            "alt_labels": [
                "zapatistat"
            ],
            "created_time": "2023-08-16T05:08:18.967056Z",
            "last_modified_time": "2023-08-16T05:08:18.967075Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "zapatistit",
                "sv": "zapatister",
                "en": "Zapatistas"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5774/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15570",
            "has_user_editable_resources": false,
            "alt_labels": [
                "parsilaisuus",
                "parsism"
            ],
            "created_time": "2023-08-16T05:05:34.103991Z",
            "last_modified_time": "2023-08-16T05:05:34.104022Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "zarathustralaisuus",
                "sv": "zoroastrism",
                "en": "Zoroastrianism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15570/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29802",
            "has_user_editable_resources": false,
            "alt_labels": [
                "zarzuela"
            ],
            "created_time": "2023-08-16T05:14:05.796300Z",
            "last_modified_time": "2023-08-16T05:14:05.796320Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "zarzuelat",
                "sv": "zarzuelor",
                "en": "zarzuelas"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29802/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39128",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Zavidovoläckan"
            ],
            "created_time": "2023-08-16T05:11:44.882371Z",
            "last_modified_time": "2023-08-16T05:11:44.882391Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Zavidovo-vuoto",
                "sv": "Zavidovoaffären",
                "en": "Zavidovo leak"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39128/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26050",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:51.476400Z",
            "last_modified_time": "2023-08-16T05:10:51.476421Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Zeitgeist-liike",
                "sv": "Zeitgeiströrelsen",
                "en": "Zeitgeist movement"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26050/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13972",
            "has_user_editable_resources": false,
            "alt_labels": [
                "zen",
                "zeniläisyys",
                "zen"
            ],
            "created_time": "2023-08-16T05:09:05.288137Z",
            "last_modified_time": "2023-08-16T05:09:05.288155Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "zenbuddhalaisuus",
                "sv": "zenbuddhism",
                "en": "Zen Buddhism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13972/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38035",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:00.429327Z",
            "last_modified_time": "2023-08-16T05:16:00.429347Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "zeoliitit",
                "sv": "zeoliter",
                "en": "zeolites"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38035/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38473",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:15.645661Z",
            "last_modified_time": "2023-08-16T05:14:15.645678Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "zikavirus",
                "en": "Zika virus"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38473/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38474",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Zika fever",
                "zikakuume",
                "zikafeber"
            ],
            "created_time": "2023-08-16T05:11:38.007002Z",
            "last_modified_time": "2023-08-16T05:11:38.007021Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "zikavirusinfektio",
                "sv": "zikavirusinfektion",
                "en": "Zika virus infection"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38474/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26858",
            "has_user_editable_resources": false,
            "alt_labels": [
                "zigguratit",
                "zikkurratit",
                "trappstegspyramider",
                "ziggurat",
                "zikkurat",
                "ziqqurrat"
            ],
            "created_time": "2023-08-16T05:13:49.037332Z",
            "last_modified_time": "2023-08-16T05:13:49.037357Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "zikkuratit",
                "sv": "ziqqurat",
                "en": "ziggurats"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26858/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39705",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:08.656447Z",
            "last_modified_time": "2023-08-16T05:08:08.656466Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "zimbabwelaiset",
                "sv": "zimbabwier",
                "en": "Zimbabweans"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39705/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19336",
            "has_user_editable_resources": false,
            "alt_labels": [
                "sirkoni"
            ],
            "created_time": "2023-08-16T05:09:50.107742Z",
            "last_modified_time": "2023-08-16T05:09:50.107760Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "zirkoni",
                "sv": "zirkon",
                "en": "zircon"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19336/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13893",
            "has_user_editable_resources": false,
            "alt_labels": [
                "sirkonium"
            ],
            "created_time": "2023-08-16T05:09:04.724423Z",
            "last_modified_time": "2023-08-16T05:09:04.724453Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "zirkonium",
                "en": "zirconium"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13893/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39440",
            "has_user_editable_resources": false,
            "alt_labels": [
                "zirconium hydrogen phosphate",
                "zirconium orthophosphate",
                "sirkoniumfosfaatti"
            ],
            "created_time": "2023-08-16T05:08:06.259207Z",
            "last_modified_time": "2023-08-16T05:08:06.259225Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "zirkoniumfosfaatti",
                "sv": "zirkoniumfosfat",
                "en": "zirconium phosphate"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39440/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}