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=1195&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=1196&show_all_keywords=True",
        "previous": "https://linkedevents.api.test.hel.ninja/v1/keyword/?format=api&page=1194&show_all_keywords=True"
    },
    "data": [
        {
            "id": "yso:p19209",
            "has_user_editable_resources": false,
            "alt_labels": [
                "couches"
            ],
            "created_time": "2023-08-16T05:09:48.781164Z",
            "last_modified_time": "2023-08-16T05:09:48.781181Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sohvat",
                "sv": "soffor",
                "en": "sofas"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p19209/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3364",
            "has_user_editable_resources": false,
            "alt_labels": [
                "skydd av våtmarker"
            ],
            "created_time": "2023-08-16T05:07:47.298398Z",
            "last_modified_time": "2023-08-16T05:07:47.298417Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soidensuojelu",
                "sv": "myrskydd",
                "en": "mire conservation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3364/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p15300",
            "has_user_editable_resources": false,
            "alt_labels": [
                "lek (birds)",
                "lekking (birds)",
                "spel (fortplantningsbeteende)",
                "trandans",
                "lek behavior (birds)",
                "spel (fåglar)"
            ],
            "created_time": "2023-08-16T05:05:31.840623Z",
            "last_modified_time": "2025-12-17T04:39:52.501110Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soidin (linnut)",
                "sv": "parningsspel (fåglar)",
                "en": "lek behaviour (birds)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p15300/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26055",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:10:51.495969Z",
            "last_modified_time": "2023-08-16T05:10:51.495986Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soihdut",
                "sv": "facklor",
                "en": "torches"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26055/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17845",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:09:36.402858Z",
            "last_modified_time": "2023-08-16T05:09:36.402960Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soijakastike",
                "sv": "sojasås",
                "en": "soy sauce"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17845/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p37813",
            "has_user_editable_resources": false,
            "alt_labels": [
                "Glycine max",
                "Glycine max",
                "peltosoijapapu",
                "sojaböna (art)"
            ],
            "created_time": "2023-08-16T05:14:11.681191Z",
            "last_modified_time": "2023-09-15T04:40:39.892158Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soijapapu",
                "sv": "sojaböna",
                "en": "soybean"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p37813/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p25839",
            "has_user_editable_resources": false,
            "alt_labels": [
                "soijajalosteet",
                "soijavalmisteet"
            ],
            "created_time": "2023-08-16T05:13:44.147877Z",
            "last_modified_time": "2023-08-16T05:13:44.147899Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soijatuotteet",
                "sv": "sojaprodukter",
                "en": "soy products"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p25839/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p21924",
            "has_user_editable_resources": false,
            "alt_labels": [
                "kornettblomssläktet"
            ],
            "created_time": "2023-08-16T05:15:31.868986Z",
            "last_modified_time": "2026-04-18T04:41:28.882842Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soilikit",
                "sv": "kornettblommor",
                "en": "Streptocarpus"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p21924/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12020",
            "has_user_editable_resources": false,
            "alt_labels": [
                "harmonia (musiikki)",
                "harmonia (soinnutus)",
                "harmoni (musik)",
                "harmonisering",
                "harmonization (music)"
            ],
            "created_time": "2023-08-16T05:16:35.564837Z",
            "last_modified_time": "2023-08-16T05:16:35.564856Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soinnutus",
                "sv": "harmonisering (musik)",
                "en": "harmonisation (music)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12020/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p26459",
            "has_user_editable_resources": false,
            "alt_labels": [
                "timbre",
                "sointi",
                "timbre",
                "äänensävy (musiikki)",
                "äänenväri (musiikki)",
                "timbre"
            ],
            "created_time": "2023-08-16T05:07:14.270530Z",
            "last_modified_time": "2023-08-16T05:07:14.270548Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sointiväri",
                "sv": "klangfärg",
                "en": "tone color"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p26459/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29176",
            "has_user_editable_resources": false,
            "alt_labels": [
                "funktioanalyysi (sointuanalyysi)"
            ],
            "created_time": "2023-08-16T05:11:16.564294Z",
            "last_modified_time": "2023-08-16T05:11:16.564315Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sointuanalyysi",
                "sv": "harmonianalys",
                "en": "harmonic analysis (music)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29176/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p29845",
            "has_user_editable_resources": false,
            "alt_labels": [
                "chord finders",
                "chord tables",
                "sointuotteet",
                "ackordguider"
            ],
            "created_time": "2023-08-16T05:11:23.725324Z",
            "last_modified_time": "2023-08-16T05:11:23.725343Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sointuoppaat",
                "sv": "ackordtabeller",
                "en": "chord diagrams"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p29845/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12021",
            "has_user_editable_resources": false,
            "alt_labels": [
                "satslära",
                "harmoniaoppi",
                "satslära (musik)"
            ],
            "created_time": "2023-08-16T05:16:35.604122Z",
            "last_modified_time": "2023-08-16T05:16:35.604143Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "sointuoppi",
                "sv": "harmonilära",
                "en": "harmony (music theory)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12021/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p16246",
            "has_user_editable_resources": false,
            "alt_labels": [
                "paludification"
            ],
            "created_time": "2023-08-16T05:12:56.504550Z",
            "last_modified_time": "2023-08-16T05:12:56.504594Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soistuminen",
                "sv": "försumpning",
                "en": "bog formation"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p16246/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p9271",
            "has_user_editable_resources": false,
            "alt_labels": [],
            "created_time": "2023-08-16T05:14:51.574881Z",
            "last_modified_time": "2023-08-16T05:14:51.574900Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soitinluokitukset",
                "sv": "musikinstrumentsystematik",
                "en": "musical instrument classifications"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p9271/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p1514",
            "has_user_editable_resources": false,
            "alt_labels": [
                "instrumentaalimusiikki"
            ],
            "created_time": "2023-08-16T05:19:46.907421Z",
            "last_modified_time": "2023-08-16T05:19:46.907438Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soitinmusiikki",
                "sv": "instrumentalmusik",
                "en": "instrumental music"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p1514/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p12833",
            "has_user_editable_resources": false,
            "alt_labels": [
                "instrumentaatio",
                "orkesterointi",
                "orkestraatio",
                "orkestrointi",
                "orkestrering"
            ],
            "created_time": "2023-08-16T05:15:06.290956Z",
            "last_modified_time": "2023-08-16T05:15:06.290975Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soitinnus",
                "sv": "instrumentation",
                "en": "instrumentation (music)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p12833/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p17513",
            "has_user_editable_resources": false,
            "alt_labels": [
                "soitinvalmistus",
                "soittimenrakennus",
                "soittimien rakennus",
                "instrumentbyggnad",
                "instrumenttillverkning"
            ],
            "created_time": "2023-08-16T05:13:03.367146Z",
            "last_modified_time": "2023-08-16T05:13:03.367164Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soitinrakennus",
                "sv": "instrumentbyggeri",
                "en": "making of musical instruments"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p17513/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p3695",
            "has_user_editable_resources": false,
            "alt_labels": [
                "luthiers",
                "soittimentekijät",
                "soittimien rakentajat"
            ],
            "created_time": "2023-08-16T05:14:10.936279Z",
            "last_modified_time": "2023-08-16T05:14:10.936297Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soitinrakentajat",
                "sv": "instrumentbyggare",
                "en": "makers of musical instruments"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p3695/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        },
        {
            "id": "yso:p35531",
            "has_user_editable_resources": false,
            "alt_labels": [
                "organologia (soitintutkimus)",
                "musikinstrumentforskning",
                "organologi (musik)"
            ],
            "created_time": "2023-08-16T05:17:05.438379Z",
            "last_modified_time": "2023-08-16T05:17:05.438398Z",
            "aggregate": false,
            "deprecated": false,
            "has_upcoming_events": false,
            "n_events": 0,
            "image": null,
            "data_source": "yso",
            "publisher": "hy:kansalliskirjasto",
            "replaced_by": null,
            "name": {
                "fi": "soitintutkimus",
                "sv": "instrumentforskning",
                "en": "organology (music)"
            },
            "@id": "https://linkedevents.api.test.hel.ninja/v1/keyword/yso:p35531/?format=api",
            "@context": "http://schema.org",
            "@type": "Keyword"
        }
    ]
}