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

{
    "meta": {
        "count": 551,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=2",
        "previous": null
    },
    "data": [
        {
            "id": "yso:p916",
            "has_user_editable_resources": false,
            "alt_labels": [
                "motionering",
                "liikuntakäyttäytyminen",
                "liikkuminen (liikunta)",
                "motion (gymnastik)",
                "motion (idrott)"
            ],
            "created_time": "2023-08-16T05:19:42.381880Z",
            "last_modified_time": "2023-08-16T05:19:42.381897Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 23229,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "liikunta",
                "sv": "motion",
                "en": "physical training"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p916/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9270",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:05.397638Z",
            "last_modified_time": "2023-08-16T05:18:05.397655Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 18837,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "kurssit",
                "sv": "kurser",
                "en": "courses (societal objects)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9270/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2433",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ikä-ihmiset",
                "ikäihmiset",
                "gamlingar",
                "elderly",
                "old people",
                "older adults",
                "senior citizens",
                "iäkkäät",
                "seniorit",
                "vanhukset",
                "gamla",
                "seniorer",
                "äldre människor",
                "äldre personer",
                "åldringar"
            ],
            "created_time": "2023-08-16T05:17:43.642288Z",
            "last_modified_time": "2023-08-16T05:17:43.642316Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 14836,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ikääntyneet",
                "sv": "äldre",
                "en": "older people"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2433/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4354",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:19:41.188656Z",
            "last_modified_time": "2023-08-16T05:19:41.188674Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 9483,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "lapset (ikäryhmät)",
                "sv": "barn (åldersgrupper)",
                "en": "children (age groups)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4354/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16485",
            "has_user_editable_resources": false,
            "alt_labels": [
                "peruskoululaiset"
            ],
            "created_time": "2023-08-16T05:19:09.385735Z",
            "last_modified_time": "2023-08-16T05:19:09.385751Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 8523,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "koululaiset",
                "sv": "skolelever",
                "en": "pupils"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16485/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11617",
            "has_user_editable_resources": false,
            "alt_labels": [
                "nuoriso",
                "unga"
            ],
            "created_time": "2023-08-16T05:18:48.983343Z",
            "last_modified_time": "2023-08-16T05:18:48.983373Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 8114,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "nuoret",
                "sv": "ungdomar",
                "en": "young people"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11617/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26740",
            "has_user_editable_resources": false,
            "alt_labels": [
                "ryhmänohjaus",
                "gruppinstruktion",
                "gruppvägledning"
            ],
            "created_time": "2023-08-16T05:07:16.291663Z",
            "last_modified_time": "2023-08-16T05:07:16.291765Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 7312,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "ryhmäohjaus",
                "sv": "grupphandledning",
                "en": "group guidance"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26740/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6433",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:17.028459Z",
            "last_modified_time": "2023-08-16T05:16:17.028478Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 6618,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vesiliikunta",
                "sv": "vattenmotion",
                "en": "water exercise"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6433/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16233",
            "has_user_editable_resources": false,
            "alt_labels": [
                "painoharjoittelu"
            ],
            "created_time": "2023-08-16T05:12:56.468117Z",
            "last_modified_time": "2023-08-16T05:12:56.468134Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 6082,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimaharjoittelu",
                "sv": "styrketräning",
                "en": "strength training"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16233/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2787",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:19:44.135734Z",
            "last_modified_time": "2023-08-16T05:19:44.135775Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 5730,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "kirjastot",
                "sv": "bibliotek",
                "en": "libraries"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2787/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8504",
            "has_user_editable_resources": false,
            "alt_labels": [
                "gym",
                "konditionssalar"
            ],
            "created_time": "2023-08-16T05:08:30.454058Z",
            "last_modified_time": "2023-08-16T05:08:30.454085Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 4438,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "kuntosalit",
                "sv": "motionssalar",
                "en": "gyms"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8504/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7382",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:01.143923Z",
            "last_modified_time": "2023-08-16T05:18:01.143942Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 3766,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "lihaskunto",
                "sv": "muskelkondition",
                "en": "muscle fitness"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7382/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5590",
            "has_user_editable_resources": false,
            "alt_labels": [
                "fullvuxna"
            ],
            "created_time": "2023-08-16T05:17:14.834826Z",
            "last_modified_time": "2023-08-16T05:17:14.834850Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 3528,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "aikuiset",
                "sv": "vuxna",
                "en": "adults"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5590/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6062",
            "has_user_editable_resources": false,
            "alt_labels": [
                "spel (objekt)"
            ],
            "created_time": "2023-08-16T05:19:44.246340Z",
            "last_modified_time": "2023-08-16T05:19:44.246358Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 3255,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "pelit",
                "sv": "spel",
                "en": "games"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6062/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p360",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:19:44.191631Z",
            "last_modified_time": "2023-08-16T05:19:44.191650Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 3234,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "kulttuuritapahtumat",
                "sv": "kulturevenemang",
                "en": "cultural events"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p360/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13050",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:07.041577Z",
            "last_modified_time": "2023-08-16T05:15:07.041594Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 2890,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "lapsiperheet",
                "sv": "barnfamiljer",
                "en": "families with children"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13050/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p556",
            "has_user_editable_resources": false,
            "alt_labels": [
                "språk (språkvetenskap)",
                "kielet",
                "kieli (kielitiede)",
                "språk (typer)",
                "språket"
            ],
            "created_time": "2023-08-16T05:19:47.449652Z",
            "last_modified_time": "2023-08-16T05:19:47.449670Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 2838,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "kieli ja kielet",
                "sv": "språk",
                "en": "languages"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p556/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2149",
            "has_user_editable_resources": false,
            "alt_labels": [
                "opastaminen",
                "opastukset",
                "vägledning"
            ],
            "created_time": "2023-08-16T05:13:22.316826Z",
            "last_modified_time": "2023-08-16T05:13:22.316842Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 2813,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "opastus",
                "sv": "guidning",
                "en": "guidance"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2149/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16991",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:29.112652Z",
            "last_modified_time": "2023-08-16T05:09:29.112671Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 2763,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "naiset",
                "sv": "kvinnor",
                "en": "women"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16991/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17551",
            "has_user_editable_resources": false,
            "alt_labels": [
                "simkurser"
            ],
            "created_time": "2023-08-16T05:09:33.903388Z",
            "last_modified_time": "2023-08-16T05:09:33.903406Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": true,
            "n_events": 2623,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "uimakoulut",
                "sv": "simskolor",
                "en": "swimming classes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17551/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}