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

{
    "meta": {
        "count": 31945,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1338&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1336&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p3461",
            "has_user_editable_resources": false,
            "alt_labels": [
                "abstraktijulkaisut",
                "referaattijulkaisut",
                "abstraktpublikationer"
            ],
            "created_time": "2023-08-16T05:15:58.018311Z",
            "last_modified_time": "2023-08-16T05:15:58.018329Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tiivistelmäjulkaisut",
                "sv": "referatpublikationer",
                "en": "abstract publications"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3461/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11163",
            "has_user_editable_resources": false,
            "alt_labels": [
                "abstraktit",
                "referaatit",
                "abstract",
                "abstrakt",
                "sammanfattningar"
            ],
            "created_time": "2023-08-16T05:08:45.377903Z",
            "last_modified_time": "2023-08-16T05:08:45.377923Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tiivistelmät",
                "sv": "sammandrag",
                "en": "abstracts"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11163/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38210",
            "has_user_editable_resources": false,
            "alt_labels": [
                "soil packing",
                "maan tiivistyminen",
                "maaperän tiivistyminen",
                "viljelysmaan tiivistyminen",
                "jordpackning (växtförhållanden)"
            ],
            "created_time": "2023-08-16T05:07:52.822251Z",
            "last_modified_time": "2023-08-16T05:07:52.822298Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tiivistyminen (kasvuolosuhteet)",
                "sv": "markpackning",
                "en": "soil compaction"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38210/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2915",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:02.466106Z",
            "last_modified_time": "2023-08-16T05:14:02.466123Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tiivistyminen (kondensaatio)",
                "sv": "kondensation",
                "en": "condensation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2915/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38436",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kompaktering (förstärkning)",
                "packning (förstärkning)"
            ],
            "created_time": "2023-08-16T05:07:55.099213Z",
            "last_modified_time": "2023-08-16T05:07:55.099233Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tiivistys (lujittaminen)",
                "sv": "komprimering (förstärkning)",
                "en": "compaction"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38436/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3643",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kompakthet"
            ],
            "created_time": "2023-08-16T05:15:58.519565Z",
            "last_modified_time": "2023-08-16T05:15:58.519583Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tiiviys",
                "sv": "täthet",
                "en": "tightness"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3643/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12907",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:57.466453Z",
            "last_modified_time": "2023-08-16T05:08:57.466470Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tikanheitto",
                "sv": "pilkastning",
                "en": "dart games"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12907/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16207",
            "has_user_editable_resources": false,
            "alt_labels": [
                "lady's-slipper orchid"
            ],
            "created_time": "2023-08-16T05:05:39.641010Z",
            "last_modified_time": "2023-08-16T05:05:39.641029Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tikankontti",
                "sv": "guckusko (art)",
                "en": "Cypripedium calceolus"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16207/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16208",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:23.107289Z",
            "last_modified_time": "2023-08-16T05:09:23.107310Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tikankonttikasvit",
                "sv": "guckuskor (släkte)",
                "en": "Cypripediaceae"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16208/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40220",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Therevidae",
                "Therevidae"
            ],
            "created_time": "2024-01-13T04:40:43.533890Z",
            "last_modified_time": "2024-03-21T04:40:11.118546Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tikarikärpäset",
                "sv": "stilettflugor",
                "en": "stiletto flies"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40220/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38097",
            "has_user_editable_resources": false,
            "alt_labels": [
                "stickertar"
            ],
            "created_time": "2023-08-16T05:07:51.636587Z",
            "last_modified_time": "2023-08-16T05:07:51.636615Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tikarit",
                "sv": "dolkar",
                "en": "daggers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38097/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9745",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Picidae"
            ],
            "created_time": "2023-08-16T05:18:06.302790Z",
            "last_modified_time": "2023-08-16T05:18:06.302808Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tikat",
                "sv": "hackspettar",
                "en": "woodpeckers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9745/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1460",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:47.609490Z",
            "last_modified_time": "2023-08-16T05:12:47.609508Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tikkaat",
                "sv": "stegar",
                "en": "ladders"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1460/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9746",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:22.224942Z",
            "last_modified_time": "2023-08-16T05:12:22.224959Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tikkalinnut",
                "sv": "hackspettartade fåglar",
                "en": "piciformes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9746/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p38864",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Douyin",
                "Douyin",
                "Douyin"
            ],
            "created_time": "2023-08-16T05:14:17.753059Z",
            "last_modified_time": "2023-08-16T05:14:17.753077Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "TikTok",
                "en": "TikTok"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38864/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25190",
            "has_user_editable_resources": false,
            "alt_labels": [
                "subscribers",
                "prenumeranter"
            ],
            "created_time": "2023-08-16T05:07:01.057924Z",
            "last_modified_time": "2023-08-16T05:07:01.057941Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tilaajat",
                "sv": "beställare",
                "en": "orderers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25190/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20172",
            "has_user_editable_resources": false,
            "alt_labels": [
                "tilaaja-tuottaja-mallit",
                "tilaaja-tuottajatoimintatapa",
                "beställare-utföraremodeller",
                "beställar- och utförarmodeller",
                "beställar-utförarmodeller",
                "beställar/utförar-modeller",
                "beställare-producent-modeller",
                "beställare–utförare-modeller",
                "beställar–utförarmodeller",
                "purchaser-provider models"
            ],
            "created_time": "2023-08-16T05:09:57.866373Z",
            "last_modified_time": "2026-01-09T04:40:21.031833Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tilaaja-tuottajamallit",
                "sv": "beställar–utförar-modeller",
                "en": "purchaser-producer models"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20172/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22859",
            "has_user_editable_resources": false,
            "alt_labels": [
                "volymkombin"
            ],
            "created_time": "2023-08-16T05:06:40.694283Z",
            "last_modified_time": "2023-08-16T05:06:40.694303Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tila-autot",
                "sv": "minivans",
                "en": "minivans"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22859/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7432",
            "has_user_editable_resources": false,
            "alt_labels": [
                "tila (tilallisuus)",
                "tilallisuus",
                "rum (spatialitet)",
                "rumslighet",
                "utrymme (fenomen)"
            ],
            "created_time": "2023-08-16T05:18:01.268899Z",
            "last_modified_time": "2025-08-22T04:41:43.772520Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tila (ilmiö)",
                "sv": "rum (fenomen)",
                "en": "space (phenomena)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7432/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18010",
            "has_user_editable_resources": false,
            "alt_labels": [
                "talokkaat",
                "talolliset",
                "besuttna",
                "gårdsägare"
            ],
            "created_time": "2023-08-16T05:15:22.526296Z",
            "last_modified_time": "2023-08-16T05:15:22.526322Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "tilalliset",
                "sv": "hemmansägare",
                "en": "farm owners"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18010/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}