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

{
    "meta": {
        "count": 31805,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=276&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=274&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p17186",
            "has_user_editable_resources": false,
            "alt_labels": [
                "spin casting (fishing)",
                "uistelu",
                "virvelöinti",
                "kastfiske"
            ],
            "created_time": "2023-08-16T05:09:31.028465Z",
            "last_modified_time": "2023-08-16T05:09:31.028483Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "heittokalastus",
                "sv": "spinnfiske",
                "en": "spin fishing"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17186/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p892",
            "has_user_editable_resources": false,
            "alt_labels": [
                "throwing events",
                "kast (friidrott)"
            ],
            "created_time": "2023-08-16T05:18:29.461347Z",
            "last_modified_time": "2023-08-16T05:18:29.461365Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "heittolajit",
                "sv": "kastgrenar",
                "en": "throwing sports"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p892/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29520",
            "has_user_editable_resources": false,
            "alt_labels": [
                "throw",
                "heitto",
                "kastande",
                "kastning"
            ],
            "created_time": "2023-08-16T05:11:20.784334Z",
            "last_modified_time": "2023-08-16T05:11:20.784359Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "heittäminen",
                "sv": "kast",
                "en": "throwing"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29520/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29696",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:41.440776Z",
            "last_modified_time": "2023-08-16T05:07:41.440793Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "heksametri",
                "sv": "hexameter",
                "en": "hexameter"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29696/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10104",
            "has_user_editable_resources": false,
            "alt_labels": [
                "beslag (byggvaror)"
            ],
            "created_time": "2023-08-16T05:04:57.607482Z",
            "last_modified_time": "2023-08-16T05:04:57.607502Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "helat",
                "sv": "beslag (teknik)",
                "en": "mountings"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10104/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17952",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Helgetorsdag",
                "Kristi himmelsfärd",
                "Kristi himmelsfärds dag"
            ],
            "created_time": "2023-08-16T05:13:05.738912Z",
            "last_modified_time": "2023-08-16T05:13:05.738929Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "helatorstai",
                "sv": "Kristi himmelsfärdsdag",
                "en": "Ascension Day"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17952/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26606",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:15.113706Z",
            "last_modified_time": "2023-08-16T05:07:15.113724Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "helavyöt",
                "sv": "söljebälten",
                "en": "helavyöt"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26606/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14888",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Helicobacter"
            ],
            "created_time": "2023-08-16T05:09:12.488445Z",
            "last_modified_time": "2023-08-16T05:09:12.488462Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "helikobakteerit",
                "sv": "helikobakterier",
                "en": "Helicobacteria"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14888/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13740",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:09.429934Z",
            "last_modified_time": "2023-08-16T05:15:09.429952Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "helikopterit",
                "sv": "helikoptrar",
                "en": "helicopters"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13740/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21725",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:23.524509Z",
            "last_modified_time": "2023-08-16T05:13:23.524525Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "heliosfääri",
                "sv": "heliosfären",
                "en": "heliosphere"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21725/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14499",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:25.800050Z",
            "last_modified_time": "2023-08-16T05:05:25.800082Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "helium",
                "en": "helium"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14499/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1079",
            "has_user_editable_resources": false,
            "alt_labels": [
                "helkajuhla",
                "pingstfest"
            ],
            "created_time": "2023-08-16T05:08:42.897344Z",
            "last_modified_time": "2023-08-16T05:08:42.897403Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "helkajuhla",
                "sv": "helkafest",
                "en": "Whitsuntide festival"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1079/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28729",
            "has_user_editable_resources": false,
            "alt_labels": [
                "helkadikter"
            ],
            "created_time": "2023-08-16T05:11:12.798541Z",
            "last_modified_time": "2023-08-16T05:11:12.798561Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "helkavirret",
                "sv": "helkasånger",
                "en": "Whitsuntide poetry"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28729/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40600",
            "has_user_editable_resources": false,
            "alt_labels": [
                "hellejaksot",
                "hellekaudet",
                "lämpöaallot",
                "värmeperioder",
                "heatwaves"
            ],
            "created_time": "2025-01-22T04:40:56.617231Z",
            "last_modified_time": "2025-01-29T04:41:01.061817Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "helleaallot",
                "sv": "värmeböljor",
                "en": "heat waves"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40600/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16956",
            "has_user_editable_resources": false,
            "alt_labels": [
                "hellenism"
            ],
            "created_time": "2023-08-16T05:13:00.461593Z",
            "last_modified_time": "2023-08-16T05:13:00.461611Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hellenismi",
                "sv": "hellenismen",
                "en": "Hellenism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16956/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2570",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:48.196563Z",
            "last_modified_time": "2023-08-16T05:10:48.196592Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "helluntai",
                "sv": "pingst",
                "en": "Pentecost"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2570/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8396",
            "has_user_editable_resources": false,
            "alt_labels": [
                "helluntaiherätys",
                "helluntailaisuus",
                "pentekostalism",
                "pingstväckelsen"
            ],
            "created_time": "2023-08-16T05:08:29.995131Z",
            "last_modified_time": "2023-08-16T05:08:29.995152Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "helluntailiike",
                "sv": "pingströrelsen",
                "en": "Pentecostal movement"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8396/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26201",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ömhetsbevis"
            ],
            "created_time": "2023-08-16T05:16:55.745543Z",
            "last_modified_time": "2023-08-16T05:16:55.745563Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hellyydenosoitukset",
                "sv": "ömhetsbetygelser",
                "en": "shows of affection"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26201/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17124",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:30.482949Z",
            "last_modified_time": "2023-08-16T05:09:30.482967Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hellyys",
                "sv": "ömhet",
                "en": "affection (tenderness)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17124/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16558",
            "has_user_editable_resources": false,
            "alt_labels": [
                "helmenkalastus"
            ],
            "created_time": "2023-08-16T05:05:42.540415Z",
            "last_modified_time": "2023-08-16T05:05:42.540435Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "helmenpyynti",
                "sv": "pärlfiske",
                "en": "pearlfishing"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16558/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}