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

{
    "meta": {
        "count": 31745,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1508&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1506&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p25323",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:44.513166Z",
            "last_modified_time": "2023-08-16T05:10:44.513184Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimantuotto (fysiologia)",
                "sv": "kraftproduktion (fysiologi)",
                "en": "force production (physiology)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25323/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18524",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:01.479177Z",
            "last_modified_time": "2023-08-16T05:06:01.479201Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimatalous",
                "sv": "elekonomi",
                "en": "power economy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18524/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22440",
            "has_user_editable_resources": false,
            "alt_labels": [
                "valtatasapaino"
            ],
            "created_time": "2023-08-16T05:16:51.844923Z",
            "last_modified_time": "2023-08-16T05:16:51.844940Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimatasapaino",
                "sv": "maktbalans",
                "en": "balance of power"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22440/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12681",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:12.784366Z",
            "last_modified_time": "2023-08-16T05:05:12.784387Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimistelijat",
                "sv": "gymnaster",
                "en": "gymnasts"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12681/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p963",
            "has_user_editable_resources": false,
            "alt_labels": [
                "taitovoimistelu",
                "tävlingsgymnastik"
            ],
            "created_time": "2023-08-16T05:19:32.805203Z",
            "last_modified_time": "2023-08-16T05:19:32.805221Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimistelu",
                "sv": "gymnastik",
                "en": "gymnastics"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p963/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1883",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:24.171377Z",
            "last_modified_time": "2023-08-16T05:15:24.171403Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voimistelumusiikki",
                "sv": "gymnastikmusik",
                "en": "gymnastics music"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1883/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27438",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Voiniemen hovi"
            ],
            "created_time": "2023-08-16T05:07:22.404899Z",
            "last_modified_time": "2023-08-16T05:07:22.404918Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Voiniemen hovi",
                "en": "Voiniemi manor"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27438/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19464",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Johannisberg (Valkeakoski)",
                "Voipaala herrgård",
                "Woipala gård"
            ],
            "created_time": "2023-08-16T05:06:11.643165Z",
            "last_modified_time": "2023-08-16T05:06:11.643182Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Voipaalan kartano",
                "sv": "Voipaala gård",
                "en": "Voipaala manor"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19464/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13044",
            "has_user_editable_resources": false,
            "alt_labels": [
                "salvor",
                "ointments"
            ],
            "created_time": "2023-08-16T05:17:33.791717Z",
            "last_modified_time": "2023-08-25T04:40:44.148153Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voiteet",
                "sv": "krämer",
                "en": "creams (ointments)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13044/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18662",
            "has_user_editable_resources": false,
            "alt_labels": [
                "voitelurasvat",
                "voiteluöljyt",
                "smörjfett",
                "smörjoljor"
            ],
            "created_time": "2023-08-16T05:15:23.765772Z",
            "last_modified_time": "2023-08-16T05:15:23.765789Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voiteluaineet",
                "sv": "smörjmedel",
                "en": "lubricants"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18662/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8262",
            "has_user_editable_resources": false,
            "alt_labels": [
                "smörjning (teknik)"
            ],
            "created_time": "2023-08-16T05:16:23.628443Z",
            "last_modified_time": "2023-08-16T05:16:23.628460Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voitelu (tekniikka)",
                "sv": "smörjning",
                "en": "lubrication"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8262/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7778",
            "has_user_editable_resources": false,
            "alt_labels": [
                "anointing",
                "unction",
                "smörjelse (religion)",
                "smörjning (händelse)"
            ],
            "created_time": "2023-08-16T05:14:44.661662Z",
            "last_modified_time": "2023-08-16T05:14:44.661681Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voitelu (uskonto)",
                "sv": "smörjelse",
                "en": "anointment (religion)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7778/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11369",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:00.165315Z",
            "last_modified_time": "2023-08-16T05:15:00.165333Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voitonjako",
                "sv": "vinstutdelning",
                "en": "distribution of profits"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11369/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5124",
            "has_user_editable_resources": false,
            "alt_labels": [
                "liikevoitto",
                "affärsvinster",
                "företagsvinster",
                "rörelsevinster"
            ],
            "created_time": "2023-08-16T05:18:43.084021Z",
            "last_modified_time": "2023-08-16T05:18:43.084043Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voitot (talous)",
                "sv": "vinster (ekonomi)",
                "en": "profits"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5124/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13500",
            "has_user_editable_resources": false,
            "alt_labels": [
                "segrare"
            ],
            "created_time": "2023-08-16T05:15:08.664596Z",
            "last_modified_time": "2023-08-16T05:15:08.664624Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voittajat",
                "sv": "vinnare",
                "en": "winners"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13500/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38090",
            "has_user_editable_resources": false,
            "alt_labels": [
                "vinst"
            ],
            "created_time": "2023-08-16T05:14:14.042656Z",
            "last_modified_time": "2023-08-16T05:14:14.042680Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "voittaminen",
                "sv": "vinnande",
                "en": "winning"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38090/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19051",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:47.020606Z",
            "last_modified_time": "2023-08-16T05:09:47.020624Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vokaalisointu",
                "sv": "vokalharmoni",
                "en": "vowel harmony"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19051/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6127",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:36.145778Z",
            "last_modified_time": "2023-08-16T05:14:36.145797Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vokaalit",
                "sv": "vokaler",
                "en": "vowels"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6127/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p30077",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:25.853499Z",
            "last_modified_time": "2023-08-16T05:11:25.853527Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vokaliisit (harjoitteet)",
                "sv": "vokaliser (övningsmaterial)",
                "en": "vocalises (exercises)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30077/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29884",
            "has_user_editable_resources": false,
            "alt_labels": [
                "vocalises (songs without words)",
                "sanattomat laulut"
            ],
            "created_time": "2023-08-16T05:07:42.768786Z",
            "last_modified_time": "2023-08-16T05:07:42.768803Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "vokaliisit (laulut)",
                "sv": "vokaliser (sånger)",
                "en": "vocalises (songs)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29884/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}