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

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

{
    "meta": {
        "count": 31979,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=328&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=326&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p5974",
            "has_user_editable_resources": false,
            "alt_labels": [
                "avhysning"
            ],
            "created_time": "2023-08-16T05:14:35.438722Z",
            "last_modified_time": "2023-08-16T05:14:35.438738Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "häätö",
                "sv": "vräkning",
                "en": "eviction"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5974/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29930",
            "has_user_editable_resources": false,
            "alt_labels": [
                "bröllopsvalser"
            ],
            "created_time": "2023-08-16T05:11:24.343662Z",
            "last_modified_time": "2023-08-16T05:11:24.343680Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "häävalssit",
                "sv": "brudvalser",
                "en": "wedding waltzes"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29930/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24543",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:56.959959Z",
            "last_modified_time": "2023-08-16T05:06:56.959976Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Högsar",
                "sv": "Högsar gård",
                "en": "Högsar manor"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24543/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28545",
            "has_user_editable_resources": false,
            "alt_labels": [
                "bembölingssagor",
                "sagor om tokbyborna"
            ],
            "created_time": "2023-08-16T05:13:59.301166Z",
            "last_modified_time": "2023-08-16T05:13:59.301183Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hölmöläissadut",
                "sv": "bembölesagor",
                "en": "numskull tales"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28545/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16136",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Parus montanus"
            ],
            "created_time": "2023-08-16T05:05:39.059067Z",
            "last_modified_time": "2023-08-16T05:05:39.059086Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "hömötiainen",
                "sv": "talltita",
                "en": "willow tit"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16136/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25745",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:55.046363Z",
            "last_modified_time": "2023-08-16T05:16:55.046382Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "höyhenet",
                "sv": "fjädrar",
                "en": "feathers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25745/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4724",
            "has_user_editable_resources": false,
            "alt_labels": [
                "höyhenistö",
                "höyhenpeitteet (anatomia)",
                "höyhenpuku",
                "fjäderbeklädnad",
                "fjäderdräkter"
            ],
            "created_time": "2023-08-16T05:17:12.350060Z",
            "last_modified_time": "2023-08-16T05:17:12.350076Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "höyhenpeite",
                "sv": "fjäderdräkt",
                "en": "plumage"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4724/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p7608",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:10.630948Z",
            "last_modified_time": "2023-08-16T05:12:10.630966Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "höyläkoneet",
                "sv": "hyvelmaskiner",
                "en": "planing machines"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p7608/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3760",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:31.201989Z",
            "last_modified_time": "2023-08-16T05:11:31.202007Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "höylät",
                "sv": "hyvlar",
                "en": "planes (tools)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3760/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12626",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:55.916395Z",
            "last_modified_time": "2023-08-16T05:08:55.916419Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "höyläys",
                "sv": "hyvling",
                "en": "planing"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12626/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3654",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:10.766363Z",
            "last_modified_time": "2023-08-16T05:14:10.766381Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "höyry",
                "sv": "ånga",
                "en": "steam"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3654/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26998",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:58.661804Z",
            "last_modified_time": "2023-08-16T05:10:58.661823Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "höyryjyrät",
                "sv": "ångvältar",
                "en": "steamrollers (road rollers)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26998/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18841",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:15:24.250348Z",
            "last_modified_time": "2023-08-16T05:15:24.250367Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "höyrykattilat",
                "sv": "ångpannor",
                "en": "steam boilers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18841/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13343",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:17.213248Z",
            "last_modified_time": "2023-08-16T05:05:17.213300Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "höyrykoneet",
                "sv": "ångmaskiner",
                "en": "steam engines"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13343/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16317",
            "has_user_editable_resources": false,
            "alt_labels": [
                "steamships",
                "ångbåtar"
            ],
            "created_time": "2023-08-16T05:05:40.512674Z",
            "last_modified_time": "2026-04-25T04:39:49.662299Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "höyrylaivat",
                "sv": "ångfartyg",
                "en": "steamboats"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16317/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2914",
            "has_user_editable_resources": false,
            "alt_labels": [
                "haihtuminen",
                "vaporization"
            ],
            "created_time": "2023-08-16T05:14:02.429036Z",
            "last_modified_time": "2023-08-16T05:14:02.429060Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "höyrystyminen",
                "sv": "förångning",
                "en": "vaporisation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2914/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19241",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:49.076391Z",
            "last_modified_time": "2023-08-16T05:09:49.076410Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "höyryturbiinit",
                "sv": "ångturbiner",
                "en": "steam turbins"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19241/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24114",
            "has_user_editable_resources": false,
            "alt_labels": [
                "steam railway engines"
            ],
            "created_time": "2023-08-16T05:06:52.881798Z",
            "last_modified_time": "2023-08-16T05:06:52.881817Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "höyryveturit",
                "sv": "ånglok",
                "en": "steam locomotives"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24114/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18050",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:56.712611Z",
            "last_modified_time": "2023-08-16T05:05:56.712629Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "höyryvoima",
                "sv": "ångkraft",
                "en": "steam power"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18050/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1916",
            "has_user_editable_resources": false,
            "alt_labels": [
                "lauhdutusvoimalat",
                "vastapainevoimalat",
                "kondenskraftverk",
                "mottryckskraftverk"
            ],
            "created_time": "2023-08-16T05:13:11.025627Z",
            "last_modified_time": "2023-08-16T05:13:11.025644Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "höyryvoimalat",
                "sv": "ångkraftverk",
                "en": "steam power plants"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1916/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}