Keyword List List – Django REST framework

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=1219&show_all_keywords=True

HTTP 200 OK
Allow: GET, POST, HEAD, OPTIONS
Content-Type: application/json ;utf-8
Vary: Accept

{
    "meta": {
        "count": 32006,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1220&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1218&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p5075",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:16.775812Z",
            "last_modified_time": "2023-08-16T05:08:16.775838Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soveltavat tieteet",
                "sv": "tillämpade vetenskaper",
                "en": "applied sciences"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5075/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11249",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:46.268126Z",
            "last_modified_time": "2023-08-16T05:08:46.268143Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soveltava tutkimus",
                "sv": "tillämpad forskning",
                "en": "applied research"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11249/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9364",
            "has_user_editable_resources": false,
            "alt_labels": [
                "suitability",
                "tillämplighet"
            ],
            "created_time": "2023-08-16T05:16:27.956580Z",
            "last_modified_time": "2023-08-16T05:16:27.956598Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soveltuvuus",
                "sv": "lämplighet",
                "en": "applicability"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9364/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17313",
            "has_user_editable_resources": false,
            "alt_labels": [
                "aptitude tests",
                "soveltuvuuskokeet"
            ],
            "created_time": "2023-08-16T05:15:20.444485Z",
            "last_modified_time": "2023-08-16T05:15:20.444502Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soveltuvuustestit",
                "sv": "lämplighetstest",
                "en": "suitability tests"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17313/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39478",
            "has_user_editable_resources": false,
            "alt_labels": [
                "conflict resolution",
                "sovinnonteko",
                "sovinto (suhteet)"
            ],
            "created_time": "2023-08-16T05:16:06.389142Z",
            "last_modified_time": "2023-08-16T05:16:06.389161Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sovinto",
                "sv": "försoning (relationer)",
                "en": "reconciliation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39478/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3563",
            "has_user_editable_resources": false,
            "alt_labels": [
                "compromise (law)",
                "settlement (civil process)",
                "settlement out of court",
                "settlement procedure",
                "sovinto (siviiliprosessi)",
                "sovinto (sovintomenettely)",
                "sovintoratkaisu",
                "förlikning (civilprocess)",
                "förlikning (förlikningsförfarande)",
                "uppgörelse i godo"
            ],
            "created_time": "2023-08-16T05:15:58.329325Z",
            "last_modified_time": "2023-08-16T05:15:58.329360Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sovintomenettely",
                "sv": "förlikningsförfarande",
                "en": "settlement proceedings"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3563/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10783",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:27.347665Z",
            "last_modified_time": "2023-08-16T05:12:27.347682Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sovittajat",
                "sv": "arrangörer (musik)",
                "en": "arrangers (occupations)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10783/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12834",
            "has_user_editable_resources": false,
            "alt_labels": [
                "arrangering",
                "sovitus (musiikki)",
                "arrangemang (musik)",
                "musikarrangemang"
            ],
            "created_time": "2023-08-16T05:16:37.578936Z",
            "last_modified_time": "2023-08-16T05:16:37.578960Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sovittaminen (musiikki)",
                "sv": "arrangering (musik)",
                "en": "arrangement (music)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12834/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26429",
            "has_user_editable_resources": false,
            "alt_labels": [
                "förlikningsmän"
            ],
            "created_time": "2023-08-16T05:07:14.009810Z",
            "last_modified_time": "2023-08-16T05:07:14.009827Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sovittelijat",
                "sv": "medlare",
                "en": "mediators"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26429/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20085",
            "has_user_editable_resources": false,
            "alt_labels": [
                "conciliation",
                "mediation"
            ],
            "created_time": "2023-08-16T05:15:26.480433Z",
            "last_modified_time": "2023-08-16T05:15:26.480452Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sovittelu",
                "sv": "medling",
                "en": "arbitration"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20085/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25930",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Försoningens kyrka (Hollola)",
                "Försoningskyrkan (Hollola)",
                "Church of reconciliation (Hollola)"
            ],
            "created_time": "2023-08-16T05:10:50.291650Z",
            "last_modified_time": "2025-12-17T04:40:36.223506Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Sovituksenkirkko",
                "sv": "Sovituksenkirkko (Hollola)",
                "en": "Sovituksenkirkko (Hollola)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25930/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2760",
            "has_user_editable_resources": false,
            "alt_labels": [
                "arrangemang (musik)",
                "versiot",
                "versioner (bearbetningar)"
            ],
            "created_time": "2023-08-16T05:19:25.399776Z",
            "last_modified_time": "2023-08-16T05:19:25.399797Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sovitukset",
                "sv": "bearbetningar",
                "en": "arrangements (works)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2760/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p14835",
            "has_user_editable_resources": false,
            "alt_labels": [
                "fitting (clothes)",
                "provande"
            ],
            "created_time": "2023-08-16T05:16:41.725501Z",
            "last_modified_time": "2023-08-16T05:16:41.725520Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sovitus (koettaminen)",
                "sv": "provning",
                "en": "fitting"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p14835/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5254",
            "has_user_editable_resources": false,
            "alt_labels": [
                "substitutionary atonement",
                "sovitusuhri",
                "försoningsoffer"
            ],
            "created_time": "2023-08-16T05:18:43.288774Z",
            "last_modified_time": "2023-08-16T05:18:43.288791Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sovitus (uskonto)",
                "sv": "försoning (religion)",
                "en": "atonement (religion)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5254/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19513",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:12.261719Z",
            "last_modified_time": "2023-08-16T05:06:12.261738Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sovjetologia",
                "sv": "sovjetologi",
                "en": "Sovietology"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19513/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4196",
            "has_user_editable_resources": false,
            "alt_labels": [
                "spaghetti"
            ],
            "created_time": "2023-08-16T05:08:13.487569Z",
            "last_modified_time": "2023-08-16T05:08:13.487587Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spagetti",
                "en": "spaghetti"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4196/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23977",
            "has_user_editable_resources": false,
            "alt_labels": [
                "italowesternit",
                "italienska västernfilmer",
                "spagettivästerns",
                "spagettiwestern",
                "spagettiwesterns",
                "spaghettivästern"
            ],
            "created_time": "2023-08-16T05:06:51.584128Z",
            "last_modified_time": "2023-08-16T05:06:51.584148Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spagettiwesternit",
                "sv": "spagettivästern",
                "en": "Spaghetti Westerns"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23977/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28663",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:18.321413Z",
            "last_modified_time": "2023-08-16T05:18:18.321435Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spanielit",
                "sv": "spanielar",
                "en": "spaniels"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28663/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40573",
            "has_user_editable_resources": false,
            "alt_labels": [
                "spartakiaden"
            ],
            "created_time": "2025-01-22T04:41:33.833830Z",
            "last_modified_time": "2025-01-23T04:40:42.666283Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spartakiadit",
                "sv": "spartakiader",
                "en": "Spartakiads"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40573/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21609",
            "has_user_editable_resources": false,
            "alt_labels": [
                "jäykkähalvaus",
                "kouristuksellisuus",
                "spastisiteetti"
            ],
            "created_time": "2023-08-16T05:06:31.305715Z",
            "last_modified_time": "2023-08-16T05:06:31.305733Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spastisuus",
                "sv": "spasticitet",
                "en": "spasticity"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21609/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}