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=131&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=132&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=130&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p25916",
            "has_user_editable_resources": false,
            "alt_labels": [
                "klavesinistit",
                "klavecinister"
            ],
            "created_time": "2023-08-16T05:10:50.147329Z",
            "last_modified_time": "2023-08-16T05:10:50.147346Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "cembalistit",
                "sv": "cembalister",
                "en": "harpsichordists"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25916/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8149",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:22.474419Z",
            "last_modified_time": "2023-08-16T05:17:22.474445Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "cembalo",
                "en": "harpsichord"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8149/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38833",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:41.993479Z",
            "last_modified_time": "2023-08-16T05:11:41.993496Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "cembalomusiikki",
                "sv": "cembalomusik",
                "en": "harpsichord music"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38833/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2727",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:46.087074Z",
            "last_modified_time": "2023-08-16T05:15:46.087091Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "CE-merkintä",
                "sv": "CE-märkning",
                "en": "CE marking"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2727/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16504",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:58.309390Z",
            "last_modified_time": "2023-08-16T05:12:58.309407Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "cesium",
                "en": "cesium"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16504/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5727",
            "has_user_editable_resources": false,
            "alt_labels": [
                "freonit",
                "freoner"
            ],
            "created_time": "2023-08-16T05:18:24.721987Z",
            "last_modified_time": "2023-08-16T05:18:24.722005Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "CFC-yhdisteet",
                "sv": "CFC-föreningar",
                "en": "CFC compounds"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5727/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20015",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Common Gateway Interface",
                "CGI (standardi)",
                "Common Gateway Interface",
                "CGI (standard)",
                "Common Gateway Interface"
            ],
            "created_time": "2023-08-16T05:06:18.250768Z",
            "last_modified_time": "2023-08-16T05:06:18.250791Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "CGI",
                "en": "CGI"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20015/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27017",
            "has_user_editable_resources": false,
            "alt_labels": [
                "chavacanon kieli",
                "chabacano"
            ],
            "created_time": "2023-08-16T05:07:18.872049Z",
            "last_modified_time": "2023-08-16T05:07:18.872073Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "chabacanon kieli",
                "sv": "chavacano",
                "en": "Chabacano language"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27017/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23935",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Chabad-Lubavitch",
                "Habad",
                "Chabad",
                "Chabad Lubavitch",
                "Chabad-Lubavitch-liike",
                "Habad",
                "Chabad",
                "Chabad Lubavitch",
                "Chabad-Lubavitch-rörelsen",
                "Habad"
            ],
            "created_time": "2023-08-16T05:10:32.478242Z",
            "last_modified_time": "2023-08-16T05:10:32.478299Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Chabad-Lubavitch",
                "en": "Chabad"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23935/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10523",
            "has_user_editable_resources": false,
            "alt_labels": [
                "cha-cha (tanssit)",
                "triplamambo",
                "cha-cha",
                "cha-cha-cha (latinamerikanska danser)"
            ],
            "created_time": "2023-08-16T05:12:25.932232Z",
            "last_modified_time": "2023-08-16T05:12:25.932251Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "cha-cha-cha (tanssit)",
                "sv": "cha-cha-cha (danser)",
                "en": "cha-cha (dances)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10523/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10514",
            "has_user_editable_resources": false,
            "alt_labels": [
                "cha-cha",
                "cha-cha (dance music)",
                "cha-cha-cha (tanssimusiikki)",
                "cha-cha-cha (dansmusik)"
            ],
            "created_time": "2023-08-16T05:14:57.354057Z",
            "last_modified_time": "2023-08-16T05:14:57.354074Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "cha-cha-chat (sävellykset)",
                "sv": "cha-cha-cha (kompositioner)",
                "en": "cha-cha (compositions)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10514/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29966",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:24.787484Z",
            "last_modified_time": "2023-08-16T05:11:24.787503Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "chaconnet",
                "sv": "chaconner",
                "en": "chaconnes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29966/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16551",
            "has_user_editable_resources": false,
            "alt_labels": [
                "chaga (etnisk grupp)",
                "chagga",
                "djagga",
                "dschagga",
                "wadjagga"
            ],
            "created_time": "2023-08-16T05:05:42.465436Z",
            "last_modified_time": "2023-08-16T05:05:42.465454Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "chaggat",
                "sv": "chaga (bantufolk)",
                "en": "Chaga people"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16551/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5232",
            "has_user_editable_resources": false,
            "alt_labels": [
                "tsakrat",
                "tšakrat",
                "chakror"
            ],
            "created_time": "2023-08-16T05:17:13.641702Z",
            "last_modified_time": "2023-08-16T05:17:13.641722Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "chakrat",
                "sv": "chakran",
                "en": "chakras"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5232/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16294",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:56.872153Z",
            "last_modified_time": "2023-08-16T05:12:56.872177Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "chansonit",
                "sv": "chansoner",
                "en": "chansons"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16294/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26607",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Charcot-jalka",
                "diabeetikon jalka",
                "Charcot-fot",
                "diabetesfot",
                "Charcot joint",
                "Charcots fot"
            ],
            "created_time": "2023-08-16T05:07:15.133432Z",
            "last_modified_time": "2024-09-22T04:40:15.747726Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Charcot'n jalka",
                "sv": "Charcotfot",
                "en": "neuropathic arthropathy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26607/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p30099",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:07:44.851201Z",
            "last_modified_time": "2023-08-16T05:07:44.851219Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "charleston (tanssit)",
                "sv": "charleston (danser)",
                "en": "charleston (dances)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30099/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21879",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:12.520919Z",
            "last_modified_time": "2023-08-16T05:10:12.520937Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "charolais",
                "en": "Charolais cattle"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21879/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39028",
            "has_user_editable_resources": false,
            "alt_labels": [
                "asiointibotit",
                "chatbotit",
                "palvelubotit",
                "chatbotar",
                "chatrobotar",
                "chattbottar",
                "dialogrobotar"
            ],
            "created_time": "2023-08-16T05:14:18.904928Z",
            "last_modified_time": "2023-08-16T05:14:18.904957Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "chattibotit",
                "sv": "chatbottar",
                "en": "chatbots"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39028/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39399",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Cheddar",
                "cheddar",
                "cheddar"
            ],
            "created_time": "2023-08-16T05:08:05.761576Z",
            "last_modified_time": "2023-08-16T05:08:05.761595Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "cheddarjuusto",
                "sv": "cheddarost",
                "en": "Cheddar cheese"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39399/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}