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=1220&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=1221&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1219&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p12585",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:55.581631Z",
            "last_modified_time": "2023-08-16T05:08:55.581650Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spatiaalinen havaitseminen",
                "sv": "spatial perception",
                "en": "spatial perception"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12585/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29914",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:03.262606Z",
            "last_modified_time": "2023-08-16T05:17:03.262625Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "speed metal",
                "en": "speed metal"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29914/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26664",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:55.923986Z",
            "last_modified_time": "2023-08-16T05:10:55.924007Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "speedminton",
                "en": "speedminton"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26664/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18953",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:46.065131Z",
            "last_modified_time": "2023-08-16T05:09:46.065149Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "speedway",
                "en": "speedway"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18953/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25427",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:41.953831Z",
            "last_modified_time": "2023-08-16T05:13:41.953850Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "speksit",
                "sv": "spex",
                "en": "spex"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25427/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21591",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:31.215577Z",
            "last_modified_time": "2023-08-16T05:06:31.215600Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spektaakkelit",
                "sv": "spektakel",
                "en": "spectacles"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21591/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p23978",
            "has_user_editable_resources": false,
            "alt_labels": [
                "spektraalianalyysi"
            ],
            "created_time": "2023-08-16T05:15:37.146648Z",
            "last_modified_time": "2023-08-16T05:15:37.146670Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spektrianalyysi",
                "sv": "spektralanalys",
                "en": "spectrum analysis"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p23978/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26364",
            "has_user_editable_resources": false,
            "alt_labels": [
                "spektrikuvantaminen"
            ],
            "created_time": "2023-08-16T05:10:54.066469Z",
            "last_modified_time": "2023-08-16T05:10:54.066499Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spektrikuvaus",
                "sv": "spektral avbildning",
                "en": "spectral imaging"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26364/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p30082",
            "has_user_editable_resources": false,
            "alt_labels": [
                "spektraalimusiikki"
            ],
            "created_time": "2023-08-16T05:07:44.685397Z",
            "last_modified_time": "2023-08-16T05:07:44.685418Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spektrimusiikki",
                "sv": "spektralmusik",
                "en": "spectral music"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30082/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6086",
            "has_user_editable_resources": false,
            "alt_labels": [
                "spektrer"
            ],
            "created_time": "2023-08-16T05:18:44.487048Z",
            "last_modified_time": "2023-08-16T05:18:44.487066Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spektrit",
                "sv": "spektra",
                "en": "spectra"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6086/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6083",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:16.300587Z",
            "last_modified_time": "2023-08-16T05:17:16.300606Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spektrografia",
                "sv": "spektrografi",
                "en": "spectrography"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6083/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26430",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:47.019253Z",
            "last_modified_time": "2023-08-16T05:13:47.019286Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spektrografit",
                "sv": "spektrografer",
                "en": "spectrographs"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26430/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p11151",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:45.304111Z",
            "last_modified_time": "2023-08-16T05:08:45.304130Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spektroliitti",
                "sv": "spektrolit",
                "en": "spectrolite"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p11151/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10177",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:06.915793Z",
            "last_modified_time": "2023-08-16T05:18:06.915812Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spektrometria",
                "sv": "spektrometri",
                "en": "spectrometry"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10177/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26502",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:13:47.494578Z",
            "last_modified_time": "2023-08-16T05:13:47.494607Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spektrometrit",
                "sv": "spektrometrar",
                "en": "spectrometers"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26502/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10176",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:18:31.448466Z",
            "last_modified_time": "2023-08-16T05:18:31.448486Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spektroskopia",
                "sv": "spektroskopi",
                "en": "spectroscopy"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10176/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39229",
            "has_user_editable_resources": false,
            "alt_labels": [
                "spekulointi (filosofia)",
                "spekulering (filosofi)"
            ],
            "created_time": "2023-08-16T05:14:19.913359Z",
            "last_modified_time": "2023-08-16T05:14:19.913391Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spekulaatio (filosofia)",
                "sv": "spekulation (filosofi)",
                "en": "speculation (philosophy)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39229/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27925",
            "has_user_editable_resources": false,
            "alt_labels": [
                "fantastik"
            ],
            "created_time": "2023-08-16T05:18:17.695784Z",
            "last_modified_time": "2023-08-16T05:18:17.695804Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spekulatiivinen fiktio",
                "sv": "spekulativ fiktion",
                "en": "speculative fiction"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27925/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p40425",
            "has_user_editable_resources": false,
            "alt_labels": [
                "spelmansstämmat"
            ],
            "created_time": "2024-06-14T04:40:34.048961Z",
            "last_modified_time": "2024-09-07T04:40:20.611544Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spelmansstämma-tapahtumat",
                "sv": "spelmansstämmor",
                "en": "spelmansstämmor"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p40425/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13065",
            "has_user_editable_resources": false,
            "alt_labels": [
                "spelt",
                "speltti",
                "dinkel",
                "gammelvete",
                "speltvete"
            ],
            "created_time": "2023-08-16T05:08:58.897659Z",
            "last_modified_time": "2023-08-16T05:08:58.897677Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "spelttivehnä",
                "sv": "spelt",
                "en": "spelt"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13065/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}