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

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

{
    "meta": {
        "count": 32005,
        "next": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1246&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1244&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p38330",
            "has_user_editable_resources": false,
            "alt_labels": [
                "condolence cards",
                "adressit (surunvalittelut)",
                "adresser",
                "sorgeadresser"
            ],
            "created_time": "2023-08-16T05:07:54.154541Z",
            "last_modified_time": "2023-08-16T05:07:54.154559Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suruadressit",
                "sv": "kondoleansadresser",
                "en": "cards of condolence"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p38330/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16785",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:27.600474Z",
            "last_modified_time": "2023-08-16T05:09:27.600490Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "surumarssit",
                "sv": "sorgmarscher",
                "en": "dead marches"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16785/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16784",
            "has_user_editable_resources": false,
            "alt_labels": [
                "hautajaismusiikki",
                "begravningsmusik",
                "sorgmusik"
            ],
            "created_time": "2023-08-16T05:15:18.982968Z",
            "last_modified_time": "2023-08-16T05:15:18.982985Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "surumusiikki",
                "sv": "sorgemusik",
                "en": "funeral music"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16784/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8286",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:12:14.264876Z",
            "last_modified_time": "2023-08-16T05:12:14.264893Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "surutyö",
                "sv": "sorgearbete",
                "en": "grief work"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8286/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13949",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Nymphalis antiopa"
            ],
            "created_time": "2023-08-16T05:05:21.389251Z",
            "last_modified_time": "2023-08-16T05:05:21.389298Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suruvaippa",
                "sv": "sorgmantel",
                "en": "mourning cloak butterfly"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13949/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2622",
            "has_user_editable_resources": false,
            "alt_labels": [
                "lomaketutkimus",
                "surveyforskning"
            ],
            "created_time": "2023-08-16T05:13:45.932656Z",
            "last_modified_time": "2023-08-16T05:13:45.932675Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "survey-tutkimus",
                "sv": "surveyundersökning",
                "en": "survey research"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2622/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p6959",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:23.845396Z",
            "last_modified_time": "2023-08-16T05:08:23.845414Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "surviaissääsket",
                "sv": "fjädermyggor",
                "en": "Chironomidae"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p6959/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p39878",
            "has_user_editable_resources": false,
            "alt_labels": [
                "prepping"
            ],
            "created_time": "2023-08-16T05:11:52.255638Z",
            "last_modified_time": "2023-08-16T05:11:52.255657Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "survivalismi",
                "sv": "survivalism",
                "en": "survivalism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p39878/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9465",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:08:34.780102Z",
            "last_modified_time": "2023-08-16T05:08:34.780121Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "SURVO",
                "en": "SURVO"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9465/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28477",
            "has_user_editable_resources": false,
            "alt_labels": [
                "suržyk",
                "suržyk"
            ],
            "created_time": "2023-08-16T05:13:58.831665Z",
            "last_modified_time": "2023-08-16T05:13:58.831681Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suržik",
                "sv": "surzjyk",
                "en": "Surzhyk"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28477/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15414",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:16.651843Z",
            "last_modified_time": "2023-08-16T05:09:16.651862Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sushi",
                "en": "sushi"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15414/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16400",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Canis lupus",
                "gray wolf",
                "wolves",
                "sudet",
                "vargar"
            ],
            "created_time": "2023-08-16T05:12:57.781333Z",
            "last_modified_time": "2023-08-16T05:12:57.781353Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "susi",
                "sv": "varg",
                "en": "wolf"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16400/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27807",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:11:05.451705Z",
            "last_modified_time": "2023-08-16T05:11:05.451723Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suspensiot",
                "sv": "suspensioner (kemi)",
                "en": "suspensions (chemistry)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27807/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p28400",
            "has_user_editable_resources": false,
            "alt_labels": [
                "sutkautukset",
                "lustigheter"
            ],
            "created_time": "2023-08-16T05:15:49.971839Z",
            "last_modified_time": "2023-08-16T05:15:49.971857Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sutkaukset",
                "sv": "kvickheter",
                "en": "witty remarks"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p28400/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27140",
            "has_user_editable_resources": false,
            "alt_labels": [
                "suutrat"
            ],
            "created_time": "2023-08-16T05:17:45.309531Z",
            "last_modified_time": "2023-08-16T05:17:45.309549Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sutrat",
                "sv": "sutror",
                "en": "sutras"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27140/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5223",
            "has_user_editable_resources": false,
            "alt_labels": [
                "munnen"
            ],
            "created_time": "2023-08-16T05:11:59.567046Z",
            "last_modified_time": "2023-08-16T05:11:59.567062Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suu",
                "sv": "mun",
                "en": "mouth"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5223/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10291",
            "has_user_editable_resources": false,
            "alt_labels": [
                "sufismi",
                "sufilaisuus"
            ],
            "created_time": "2023-08-16T05:12:24.742229Z",
            "last_modified_time": "2025-03-11T04:41:27.021322Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suufilaisuus",
                "sv": "sufism",
                "en": "Sufism"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10291/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p13001",
            "has_user_editable_resources": false,
            "alt_labels": [
                "suun hygienia"
            ],
            "created_time": "2023-08-16T05:17:33.676553Z",
            "last_modified_time": "2023-08-16T05:17:33.676575Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suuhygienia",
                "sv": "munhygien",
                "en": "oral hygiene"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p13001/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p2364",
            "has_user_editable_resources": false,
            "alt_labels": [
                "hammashuoltajat",
                "tandhygienister"
            ],
            "created_time": "2023-08-16T05:13:33.219305Z",
            "last_modified_time": "2023-08-16T05:13:33.219324Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suuhygienistit",
                "sv": "munhygienister",
                "en": "dental hygienists"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p2364/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20537",
            "has_user_editable_resources": false,
            "alt_labels": [
                "hoof-and-mouth disease"
            ],
            "created_time": "2023-08-16T05:13:16.634441Z",
            "last_modified_time": "2023-08-16T05:13:16.634467Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "suu- ja sorkkatauti",
                "sv": "mul- och klövsjuka",
                "en": "foot-and-mouth disease"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20537/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}