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=1267&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=1268&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1266&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p8698",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:24.642471Z",
            "last_modified_time": "2023-08-16T05:17:24.642494Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "säilytystilat",
                "sv": "förvaringsutrymmen",
                "en": "storage spaces"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8698/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p4661",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:16:10.460310Z",
            "last_modified_time": "2023-08-16T05:16:10.460329Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "säilyvyys",
                "sv": "hållbarhet (livsmedel)",
                "en": "preservability"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p4661/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19087",
            "has_user_editable_resources": false,
            "alt_labels": [
                "pitkäkestomuisti"
            ],
            "created_time": "2023-08-16T05:09:47.446927Z",
            "last_modified_time": "2023-08-16T05:09:47.446945Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "säilömuisti",
                "sv": "långtidsminne",
                "en": "long-term memory"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19087/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p5756",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kotisäilöntä",
                "säilöminen",
                "hemkonservering",
                "food preservation",
                "preservation (food)",
                "konservering (föda)"
            ],
            "created_time": "2023-08-16T05:19:18.853831Z",
            "last_modified_time": "2026-02-06T04:42:01.777353Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "säilöntä",
                "sv": "konservering (livsmedel)",
                "en": "preservation (foodstuffs)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p5756/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9573",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:17:27.399452Z",
            "last_modified_time": "2023-08-16T05:17:27.399471Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "säilöntäaineet",
                "sv": "konserveringsmedel",
                "en": "preservatives"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9573/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20293",
            "has_user_editable_resources": false,
            "alt_labels": [
                "AIV-rehu",
                "AIV-foder"
            ],
            "created_time": "2023-08-16T05:06:21.834856Z",
            "last_modified_time": "2023-08-16T05:06:21.834875Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "säilörehu",
                "sv": "ensilage",
                "en": "silage"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20293/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p10752",
            "has_user_editable_resources": false,
            "alt_labels": [
                "detention (asylum seekers)",
                "detention (intoxicated persons)",
                "förvarstagning",
                "tagande i förvar",
                "detention (non-criminal)",
                "noncriminal detention"
            ],
            "created_time": "2023-08-16T05:16:32.195521Z",
            "last_modified_time": "2024-01-27T04:41:55.821783Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "säilöönotto",
                "sv": "förvarstagande",
                "en": "non-criminal detention"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p10752/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1626",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:05:40.077687Z",
            "last_modified_time": "2023-08-16T05:05:40.077704Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "säkkipilli",
                "sv": "säckpipa",
                "en": "bagpipe"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1626/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p18036",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:37.977628Z",
            "last_modified_time": "2023-08-16T05:09:37.977649Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "säleiköt",
                "sv": "spjälverk",
                "en": "trellises"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p18036/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12282",
            "has_user_editable_resources": false,
            "alt_labels": [
                "jalusier",
                "spjälgardiner",
                "blinds (Venetian)",
                "kaihtimet (sälekaihtimet)"
            ],
            "created_time": "2023-08-16T05:08:53.269454Z",
            "last_modified_time": "2024-01-27T04:40:45.962137Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sälekaihtimet",
                "sv": "persienner",
                "en": "Venetian blinds"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12282/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p30101",
            "has_user_editable_resources": false,
            "alt_labels": [
                "samplerit"
            ],
            "created_time": "2023-08-16T05:14:07.483173Z",
            "last_modified_time": "2023-08-16T05:14:07.483190Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sämplerit",
                "sv": "sampler (musikteknologi)",
                "en": "samplers (music technology)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p30101/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29824",
            "has_user_editable_resources": false,
            "alt_labels": [
                "sampel",
                "samplet"
            ],
            "created_time": "2023-08-16T05:11:23.420936Z",
            "last_modified_time": "2023-08-16T05:11:23.420956Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sämplet",
                "sv": "sample (ljudinspelningar)",
                "en": "samples (sounds)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29824/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29805",
            "has_user_editable_resources": false,
            "alt_labels": [
                "sampling (music)",
                "samplaus",
                "sampling",
                "sampling (musik)"
            ],
            "created_time": "2023-08-16T05:17:03.073202Z",
            "last_modified_time": "2023-08-16T05:17:03.073220Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sämpläys",
                "sv": "sampling (ljud)",
                "en": "sampling (sound)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29805/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p27109",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kuvertbröd",
                "småfranska"
            ],
            "created_time": "2023-08-16T05:07:19.907686Z",
            "last_modified_time": "2023-08-16T05:07:19.907708Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sämpylät",
                "sv": "semlor",
                "en": "bread rolls"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p27109/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p20134",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:57.633422Z",
            "last_modified_time": "2023-08-16T05:09:57.633439Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sängyt",
                "sv": "sängar",
                "en": "beds"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p20134/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p8151",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:46.402827Z",
            "last_modified_time": "2023-08-16T05:14:46.402844Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Särestö",
                "en": "Särestö"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p8151/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p19854",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:16.451881Z",
            "last_modified_time": "2023-08-16T05:06:16.451899Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "särki",
                "sv": "mört",
                "en": "roach"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19854/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1198",
            "has_user_editable_resources": false,
            "alt_labels": [
                "mörtfiskar"
            ],
            "created_time": "2023-08-16T05:19:00.776967Z",
            "last_modified_time": "2023-08-16T05:19:00.776984Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "särkikalat",
                "sv": "karpfiskar",
                "en": "Cyprinidae"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1198/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p24467",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:37.349857Z",
            "last_modified_time": "2023-08-16T05:10:37.349876Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Särkkäniemen luonnonsuojelualue",
                "sv": "Ratauddens naturskyddsområde",
                "en": "Särkkäniemi Nature Reserve"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p24467/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p22410",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:06:37.103165Z",
            "last_modified_time": "2023-08-16T05:06:37.103185Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "Särkänniemi",
                "en": "Särkänniemi"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p22410/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}